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

# Agent Studio

> Create, manage, test, and deploy all your AI agents from a single unified hub.

Agent Studio is the unified command center for building and managing every AI agent in the HoopAI platform. Whether you are setting up a Conversation AI chatbot, a Voice AI phone agent, or a Content AI assistant, Agent Studio gives you one place to create, configure, test, and deploy them all.

<Note>
  Agent Studio consolidates agent management into a single workspace. You no longer need to jump between separate sections for each agent type.
</Note>

## Access Agent Studio

Navigate to **AI Agents > Agent Studio** in the left sidebar. The Agent Studio dashboard displays all existing agents with their status, type, and performance summary.

## Agent types

Agent Studio supports three core agent types:

<CardGroup cols={3}>
  <Card title="Conversation AI" icon="robot">
    Text-based agents for SMS, live chat, Facebook Messenger, and Instagram DM. Handle FAQs, book appointments, and qualify leads automatically.
  </Card>

  <Card title="Voice AI" icon="phone-volume">
    Phone-based agents that answer inbound calls and make outbound calls using natural speech. Ideal for appointment confirmations, lead follow-up, and after-hours support.
  </Card>

  <Card title="Content AI" icon="wand-magic-sparkles">
    Content generation agents that produce on-brand marketing copy, social posts, email drafts, and blog outlines using your business context.
  </Card>
</CardGroup>

## Create a new agent

<Steps>
  <Step title="Open Agent Studio">
    Go to **AI Agents > Agent Studio** and click the **Create Agent** button in the top-right corner.
  </Step>

  <Step title="Choose an agent type">
    Select the type of agent you want to build: Conversation AI, Voice AI, or Content AI. Each type opens a purpose-built configuration wizard.
  </Step>

  <Step title="Name and describe your agent">
    Give the agent a clear name (e.g., "Sales Chat Bot" or "After-Hours Voice Agent") and add an internal description so your team understands its purpose.
  </Step>

  <Step title="Configure behavior">
    Set the agent's personality, tone of voice, and operating rules. For Conversation AI, choose between Suggestive and Auto-Pilot mode. For Voice AI, select the voice profile and call handling rules.
  </Step>

  <Step title="Assign a knowledge base">
    Link one or more knowledge bases so the agent draws on accurate, up-to-date information. Go to **AI Agents > Knowledge Base** to create or manage knowledge sources.
  </Step>

  <Step title="Set channel assignments">
    Choose which channels the agent operates on. Conversation AI agents can be assigned to SMS, live chat, Facebook, or Instagram. Voice AI agents are assigned to specific phone numbers.
  </Step>

  <Step title="Save and publish">
    Click **Save** to store the agent as a draft, or click **Publish** to make it live immediately.
  </Step>
</Steps>

## Agent templates marketplace

Agent Studio includes a template marketplace with pre-built agent configurations for common use cases:

* **Lead qualifier** — asks discovery questions and scores leads before routing to sales
* **Appointment scheduler** — checks calendar availability and books meetings
* **FAQ responder** — answers common questions using your knowledge base
* **After-hours agent** — handles inquiries outside business hours and logs callbacks
* **Review responder** — drafts replies to Google Business Profile reviews

<Tip>
  Templates are starting points, not final products. Always customize the tone, knowledge base, and actions to match your brand and workflow.
</Tip>

## Managing multiple agents

The Agent Studio dashboard provides a centralized view of all agents:

| Column            | Description                                |
| ----------------- | ------------------------------------------ |
| **Name**          | Agent name and internal description        |
| **Type**          | Conversation AI, Voice AI, or Content AI   |
| **Status**        | Draft, Active, or Paused                   |
| **Channels**      | Assigned channels or phone numbers         |
| **Conversations** | Total conversations handled (last 30 days) |
| **Last edited**   | Timestamp and editor name                  |

Use the **filter** and **search** bar to find agents quickly. Click any agent row to open its configuration.

## Testing and debugging

<Steps>
  <Step title="Open the test console">
    Click the **Test** button on any agent card to open the built-in test console. This simulates a real conversation without affecting live contacts.
  </Step>

  <Step title="Run test conversations">
    Type messages as if you were a customer. The agent responds using its current configuration and knowledge base. Review the response quality, accuracy, and tone.
  </Step>

  <Step title="Review conversation logs">
    Open the **Logs** tab to inspect past conversations. Each log entry shows the contact message, the agent's response, the knowledge source used, and any actions triggered.
  </Step>

  <Step title="Iterate and retrain">
    If you spot incorrect or off-brand responses, update the knowledge base or adjust the agent's instructions, then re-test until the output meets your standards.
  </Step>
</Steps>

<Warning>
  Always test agents in the test console before publishing them to live channels. Untested agents may give inaccurate responses to real customers.
</Warning>

## Best practices

<AccordionGroup>
  <Accordion title="Start with Suggestive mode">
    When launching a new Conversation AI agent, use Suggestive mode first. This lets your team review every response before it reaches the customer. Switch to Auto-Pilot once you are confident in the agent's accuracy.
  </Accordion>

  <Accordion title="Keep knowledge bases focused">
    Create separate knowledge bases for different topics (e.g., pricing, product features, support). Assign only the relevant knowledge base to each agent to reduce confusion and improve response accuracy.
  </Accordion>

  <Accordion title="Use descriptive agent names">
    Name agents by their function and channel, such as "Website Chat — Lead Qualifier" or "Phone — After Hours Support." This makes the Agent Studio dashboard easy to scan when managing multiple agents.
  </Accordion>

  <Accordion title="Monitor and retrain regularly">
    Review the Conversation AI dashboard weekly. Look for conversations where the agent handed off to a human or gave low-confidence answers. Use these as training opportunities to improve the knowledge base.
  </Accordion>

  <Accordion title="Set clear escalation paths">
    Every agent should have a defined handoff action. Configure a Stop Bot action so contacts can reach a human when the agent cannot resolve their question.
  </Accordion>
</AccordionGroup>