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

# Build your first AI agent

Create, train, and deploy your first Weav AI Agent in minutes. Follow this step-by-step guide to get your intelligent assistant ready to help your customers. In just a few steps, you'll have a fully functional AI Agent capable of instantly answering customer questions, resolving routine issues, and seamlessly handing off complex problems to your human team. Let's get started! Overview Here is what we'll accomplish in this guide:

<Steps>
  <Step title="Create & Customize Your Agent">
    Set up a new AI Agent, define its role, and customize its tone of voice.
  </Step>

  <Step title="Train with Your Data">
    Upload your existing knowledge base—like FAQs, website links, or PDFs—so your Agent knows your business inside and out.
  </Step>

  <Step title="Test in the Playground">
    Use the Agent Playground to test responses and refine your Agent's behavior before going live.
  </Step>

  <Step title="Deploy to Your Channels">
    Activate your Agent on your website widget or email channels.
  </Step>
</Steps>

### Step 1: Create & Customize Your Agent

Your Agent is the frontline of your customer support. Let's give it an identity.

Navigate to the Agents Dashboard

After signing into your Weav workspace, navigate to Agents in the main sidebar. Click the "Create Agent" button.

**Configure Basic Settings**

Give your Agent a personality that matches your brand:

* Name: Give your Agent a friendly name (e.g., "Support Assistant").
* Role & Instructions: Provide clear, high-level instructions on how the Agent should behave. (e.g., "You are a helpful and polite support assistant for ACME Corp. Keep your answers concise and always offer to connect the user with a human if they are frustrated.")
* Tone: Decide if you want the Agent to sound professional, casual, enthusiastic, or empathetic.
* Quick Prompts: Set up 2-3 common questions that users can click immediately when they open the chat widget (e.g., "What are your shipping times?" or "How do I reset my password?").

### Step 2: Train with Your Data

Your AI Agent needs high-quality information to provide accurate answers. Weav allows you to train your Agent using multiple Knowledge Sources.

Navigate to your Agent's Knowledge or Training tab to start adding sources.

<Tabs>
  <Tab title="Website Links">
    **Crawl your website or help center**

    Simply paste the URL of your website, blog, or public Help Center. Weav will automatically scrape the content and convert it into training data.

    Best for: General company information, existing documentation sites, and blog posts.
  </Tab>

  <Tab title="Files & Documents">
    **Upload your internal PDFs and manuals**

    Upload files directly from your computer. Weav supports PDFs, text files, and more.

    Best for: Detailed product manuals, internal policy documents, or offline training guides.
  </Tab>

  <Tab title="Text Snippets">
    **Direct text input**

    Have a quick rule or a temporary promotion? Paste text directly into a snippet.

    Best for: Rapidly changing information, temporary sales, or specific rules that aren't documented elsewhere.
  </Tab>

  <Tab title="FAQs">
    **Add direct Question & Answer pairs**

    If there are specific questions your customers ask constantly, define the exact Answer you want the AI to give.

    Best for: Ensuring 100% accuracy on high-volume, critical questions like refund policies.
  </Tab>
</Tabs>

<Check>
  Training happens automatically! Once you add a source, Weav processes it in the background. You can continue setting up your Agent while it learns.
</Check>

### Step 3: Test in the Playground

Before letting your Agent talk to real customers, you should verify its knowledge. Navigate to the Playground tab within your Agent's settings.

**Evaluate Response Quality**

The Playground is a safe, internal testing environment. Try asking your Agent a few questions based on the data you just uploaded. As you test, look for:

* Accuracy: Are the facts correct based on your training data?
* Tone: Does it sound like your brand?
* Formatting: Is the response easy to read?

If the Agent gives an incorrect answer or says "I don't know," you likely need to add more training data to cover that specific topic, or tweak your Agent's base instructions to be more explicit. Step

### 4: Deploy to Your Channels

Once you are satisfied with your Agent's performance in the Playground, it's time to put it to work! Unlike standalone chatbots, Weav Agents live directly inside your Unified Inbox and can respond across different channels.

<Steps>
  <Step title="Enable the Agent">
    Go to your Agent's Settings and ensure its status is set to Active.
  </Step>

  <Step title="Assign to Channels">
    Decide where this Agent should operate.

    * Chatbot: The Agent will instantly reply to customers chatting on your website.
    * Email: The Agent can draft auto-replies for inbound support emails.
  </Step>

  <Step title="Configure Handoff Rules">
    Weav's superpower is the seamless transition to a human. Set your escalation rules. For example, instruct the Agent to assign the conversation to your Support Team inbox if the user explicitly asks for a "human" or if the AI cannot resolve the issue after a few attempts.
  </Step>
</Steps>

🎉 Congratulations! You've successfully created, trained, and deployed your first Weav AI Agent! Your customers will now enjoy instant, accurate answers 24/7, and your human team can focus on the complex, high-value conversations that matter most. What's Next?

<CardGroup cols={2} />