> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blueberry.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Base

> Give Blueberry your brand knowledge and guidelines

## Overview

The Knowledge Base allows you to provide Blueberry with your brand information, product details, and communication guidelines. This ensures AI-generated responses stay accurate, on-brand, and aligned with your business.

<Info>
  Think of the Knowledge Base as Blueberry's reference library. The more you add, the smarter and
  more helpful responses become.
</Info>

### Ways to Add Knowledge

<CardGroup cols={2}>
  <Card title="Custom Text" icon="text">
    Write custom instructions, rules, and guidelines directly in Blueberry for
    quick setup.
  </Card>

  <Card title="Website URL" icon="globe">
    Import content from your website, blog, or help center by providing the URL.
  </Card>

  <Card title="PDF Upload" icon="file-pdf">
    Upload product catalogs, policies, brand guidelines, and other documents.
  </Card>
</CardGroup>

## Adding Knowledge

<Tabs>
  <Tab title="Quick Start">
    <Steps>
      <Step title="Navigate to Knowledge Base">
        Go to **Brand** in the sidebar and select **Knowledge Base**.
      </Step>

      <Step title="Click Upload Knowledge">
        Click the **Upload Knowledge** button to open the upload dialog.
      </Step>

      <Step title="Choose Your Format">
        Select the type of knowledge you want to add:

        * **Custom Text** - Enter instructions or guidelines directly
        * **Website URL** - Paste a link to import web content
        * **PDF Upload** - Select a file from your computer
      </Step>

      <Step title="Save and Enable">
        After uploading, your knowledge item is automatically enabled and ready to use.

        <Check>
          Blueberry immediately starts using new knowledge items to improve response suggestions.
        </Check>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Custom Text">
    ### Writing Custom Instructions

    Custom text is perfect for:

    <CardGroup cols={2}>
      <Card title="Brand Voice" icon="microphone">
        Define your communication tone, style, and personality.
      </Card>

      <Card title="Response Rules" icon="list-check">
        Create specific rules for handling common scenarios.
      </Card>

      <Card title="Quick Facts" icon="lightbulb">
        Add frequently referenced information like hours, locations, or policies.
      </Card>

      <Card title="Special Instructions" icon="wand-sparkles">
        Set up custom responses for specific keywords or situations.
      </Card>
    </CardGroup>

    **Example Brand Voice Guidelines:**

    ```
    When responding to customers:
    - Always be warm and friendly
    - Use emojis sparingly (1-2 per message)
    - Sign off with "- The [Brand Name] Team"
    - Address customers by first name when possible
    - Keep responses concise and helpful
    ```

    **Example Response Rules:**

    ```
    If someone asks about shipping: Mention our free shipping on orders over $50
    If someone asks about returns: We offer 30-day hassle-free returns
    If someone asks about gift wrapping: Yes, we offer gift wrapping for $5
    ```

    <Tip>
      Be specific and clear in your instructions. The AI follows your guidelines closely.
    </Tip>
  </Tab>

  <Tab title="Website URLs">
    ### Importing Web Content

    Add your website URL and Blueberry will automatically pull the most up-to-date information from your site.

    **How it works:**

    Simply enter your website's main address (domain) and Blueberry will learn about your brand, products, and services directly from your live site.

    **Examples:**

    * `https://blueberry.ai`
    * `https://www.yourstore.com`
    * `https://yourbrand.co`

    <Info>
      Blueberry continuously pulls the latest information from your website, so your knowledge base stays current automatically as you update your site.
    </Info>
  </Tab>

  <Tab title="PDF Files">
    ### Uploading Documents

    Upload PDF files containing your brand information:

    **What Works Well:**

    <CardGroup cols={2}>
      <Card title="Brand Guidelines" icon="palette">
        Voice, tone, messaging, and style guides
      </Card>

      <Card title="Product Catalogs" icon="book-open">
        Full product listings with descriptions and details
      </Card>

      <Card title="Training Materials" icon="graduation-cap">
        Sales scripts, response templates, and best practices
      </Card>

      <Card title="Policy Documents" icon="scale-balanced">
        Company policies, procedures, and guidelines
      </Card>
    </CardGroup>

    **File Requirements:**

    * **Format:** PDF only
    * **Size:** Maximum 10 MB per file
    * **Content:** Text-based PDFs work best (scanned images may have limited accuracy)

    <Tip>
      Break large documents into smaller, focused PDFs for better AI comprehension.
    </Tip>
  </Tab>
</Tabs>

## Managing Your Knowledge Base

<AccordionGroup>
  <Accordion title="Enable/Disable Knowledge Items" icon="toggle-on">
    <Steps titleSize="h3">
      <Step title="Find the Item">
        Locate the knowledge item in your Knowledge Base list.
      </Step>

      <Step title="Toggle Status">
        Click the toggle switch to enable or disable the item.

        * **Enabled** (green) - AI uses this knowledge in responses
        * **Disabled** (gray) - AI ignores this knowledge
      </Step>

      <Step title="Verify Change">
        Status updates immediately. No need to refresh or save.
      </Step>
    </Steps>

    **When to Disable:**

    * Seasonal content that's out of date
    * Temporary promotions that have ended
    * Testing different instructions or guidelines
    * Content that needs updating before re-enabling

    <Tip>
      Disable instead of delete to preserve content you might need again later.
    </Tip>
  </Accordion>

  <Accordion title="Delete Knowledge Items" icon="trash">
    To permanently delete a knowledge item:

    **(1)** Click the **menu icon** (three dots) on the knowledge item

    **(2)** Select **Delete** from the dropdown

    **(3)** Confirm the deletion in the dialog

    <Warning>
      Deletion is permanent and cannot be undone. Consider disabling instead if you might need the content later.
    </Warning>
  </Accordion>
</AccordionGroup>

## How Blueberry Uses Your Knowledge

<Steps titleSize="h2">
  <Step title="User Comments or DMs">
    When someone comments on your post or sends a DM, Blueberry captures the
    message content and context.
  </Step>

  <Step title="Knowledge Base Search">
    Blueberry searches your knowledge base for relevant information related to the user's question or
    comment.
  </Step>

  <Step title="Response Generation">
    Using your brand guidelines and relevant knowledge, Blueberry generates an on-brand response that:

    * Answers the user's question accurately
    * Matches your communication style
    * Includes relevant product or policy information
    * Follows any custom rules you've set
  </Step>

  <Step title="Continuous Improvement">
    As you approve, edit, or reject suggestions, Blueberry learns:

    * Which responses work best for your brand
    * How to better interpret your knowledge base
    * Your preferred phrasing and tone
    * Patterns in how you handle different situations

    <Check>Every interaction helps Blueberry provide better suggestions over time.</Check>
  </Step>
</Steps>

## Best Practices

<AccordionGroup>
  <Accordion title="Be Specific" icon="bullseye">
    **Provide clear, detailed information:**

    ❌ **Too Vague:** "Be friendly"

    ✅ **Specific:** "Address customers by first name, use warm greetings like 'Hey there!' or 'Thanks for reaching out!', and always end with a question to continue the conversation"

    The more specific your guidelines, the more consistent your AI responses.
  </Accordion>

  <Accordion title="Test and Iterate" icon="rotate">
    Continue to update or add knowledge base content for any scenarios where you want Blueberry to improve handling.

    <Note>
      Your knowledge base evolves with your business - keep refining it based on real interactions.
    </Note>
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Link Social Accounts" icon="link" href="/brand/setup">
    Connect your social media accounts to start using your knowledge base with AI responses.
  </Card>

  <Card title="Set Up Rules Engine" icon="wand-magic-sparkles" href="/comments/rules-engine">
    Combine knowledge base with automation rules for even more efficient comment management.
  </Card>

  <Card title="Comments Inbox" icon="comments" href="/inbox/comments">
    See how AI uses your knowledge base to suggest responses in the comments inbox.
  </Card>

  <Card title="DM Campaigns" icon="paper-plane" href="/dms/campaigns/triggers">
    Use your knowledge base to personalize automated DM campaign messages.
  </Card>
</CardGroup>
