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

# Quickstart

> Deploy your first AI voice agent in minutes

# Quickstart Guide

Get your first AI voice agent up and running in under 10 minutes with this step-by-step guide.

## Prerequisites

Before you begin, make sure you have:

* A SquawkVoice account ([app.squawkvoice.ai](https://app.squawkvoice.ai))
* Basic knowledge of your business processes and customer interactions
* Documents or FAQs you want your agent to reference (optional)

<Info>
  Currently, SquawkVoice accounts are provisioned internally by our team. Please contact [support@squawkvoice.ai](mailto:support@squawkvoice.ai) to get started.
</Info>

## Step 1: Access the Studio

1. Log in to your SquawkVoice account at [app.squawkvoice.ai](https://app.squawkvoice.ai)
2. Navigate to the **Build** section in the left sidebar
3. Click on **AI Agents** to access the agent creation interface

## Step 2: Create Your First Agent

1. Click the **Create new** button in the top right corner.
2. Follow the **Streamlined Onboarding Wizard** to define your agent's core identity. Give your agent a name that represents its role (e.g., "Customer Support Bot").

The new onboarding experience guides you through each configuration step, making it easier than ever to set up your first and subsequent AI agents.

<Card title="Agent Configuration Tips" icon="lightbulb">
  * Use clear, descriptive names for easy identification
</Card>

## Step 3: Configure Agent Behavior in Guidelines

1. In the **Guidelines** section, use the **modular block-based editor** to define your agent's role and behavior.
2. Example prompt for a customer support agent:

```markdown theme={null}
You are a helpful customer support agent for [Your Company]. Your role is to:
- Answer customer questions about products and services
- Help with order status and returns
- Provide technical support for common issues
- Escalate complex issues to human agents when necessary

Always be polite, professional, and helpful. If you don't know something, say so and offer to connect the customer with a human agent.
```

### Configure Voice Settings

1. Select a voice that matches your brand personality
2. Adjust speech rate and tone as needed

## Step 4: Link Knowledge Base (Optional)

Enhance your agent's capabilities by adding company-specific information:

1. Navigate to **Knowledge Base** in the Build section
2. Click **Create new**
3. Enter name and description
4. Create Knowledge Group.
5. Once the **Knowledge Group** is created, add web scrapes, documents and FAQs as needed.
6. Navigate back to the AI Agent -> Knowledge Base tab and click `+ Link Knowledge Base` button to link the newly created Knowledge Group.

<Warning>
  Supported file formats: PDF, DOCX, TXT, CSV. Maximum file size: 512MB per file or 5,000,000 tokens.
</Warning>

<Warning>
  An AI Agent can only be linked to at most two Knowledge Groups
</Warning>

## Step 5: Test Your Agent

1. Use the **Test Your Agent** feature in the agent builder
2. Try various scenarios your customers might encounter
3. Refine the agent's responses and instructions as needed
4. Test with different voice settings to ensure natural flow

## Step 6: Monitor and Optimize

1. Navigate to the **Analyze** section to view performance metrics
2. Review call analytics and history
3. Identify areas for improvement
4. Update your agent's knowledge base and instructions based on real usage

## Next Steps

Now that you have your first agent deployed, explore these advanced features:

<Columns cols={2}>
  <Card title="Advanced Agent Design" icon="robot" href="/build/ai-agents">
    Learn about conversation flows, function calling, and advanced agent behaviors
  </Card>

  <Card title="Knowledge Management" icon="database" href="/build/knowledge-base">
    Expand your agent's knowledge with comprehensive document management
  </Card>
</Columns>

## Common Issues and Solutions

<AccordionGroup>
  <Accordion title="Agent not responding correctly">
    Review and refine your agent's instructions. Make sure the prompt clearly defines the agent's role and expected behavior. Test with various scenarios to identify gaps.
  </Accordion>

  <Accordion title="Voice sounds unnatural">
    Adjust the voice settings in the Voice & Guidelines section. Try different voices and speech rates to find the best match for your brand.
  </Accordion>

  <Accordion title="Knowledge base not being used">
    Ensure your documents are properly uploaded and processed. Check that the content is relevant and well-structured. You may need to rephrase questions or add more specific information to your knowledge base.
  </Accordion>

  <Accordion title="Integration issues">
    Verify your integration settings and credentials. Check the API documentation for proper authentication and endpoint configuration. Contact support if you need assistance with specific integrations.
  </Accordion>
</AccordionGroup>

## Need Help?

* **Documentation**: Explore our comprehensive guides in the navigation
* **Support**: Email us at [support@squawkvoice.ai](mailto:support@squawkvoice.ai)
* **Community**: Join our Discord community for tips and best practices
* **Training**: Schedule a personalized onboarding session with our team

<Button href="/build/ai-agents" size="lg">
  Build Your First Agent
</Button>