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

# Configure Your Voice Agent

> Learn how to configure AI voice agents in Dasha BlackBox — system prompts, LLM configuration, voice settings, and agent states.

Each agent combines four components: a system prompt that defines behavior, an LLM for reasoning, a voice for speech, and optional tools for actions. Here's how they fit together.

***

## Agent components

| Component     | Required | What it does                                                  |
| ------------- | -------- | ------------------------------------------------------------- |
| System prompt | Yes      | Defines personality, role, rules, knowledge                   |
| LLM config    | Yes      | Which AI model powers the brain (OpenAI, Groq, etc.)          |
| Voice config  | Yes      | Which voice speaks the responses (ElevenLabs, Cartesia, etc.) |
| Tools         | No       | External actions the agent can take mid-conversation          |
| Schedule      | No       | Business hours — when the agent accepts calls                 |
| Webhooks      | No       | URLs to notify when things happen                             |

***

## Agent states

An agent is either **enabled** or **disabled**.

**Enabled** — Active and handling conversations. This is the default. Configuration changes apply immediately, even to active calls.

**Disabled** — Paused. Won't accept new conversations. Existing calls complete normally. Configuration is preserved. No charges while disabled.

<Accordion title="API example: Disable an agent">
  ```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  await fetch(`https://blackbox.dasha.ai/api/v1/agents/${agentId}`, {
    method: 'PUT',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
    body: JSON.stringify({ isEnabled: false })
  });
  ```
</Accordion>

<Warning>
  Changes to enabled agents apply immediately. If you're making significant changes, disable the agent first, make changes, test, then re-enable.
</Warning>

***

## What's next

<CardGroup cols={2}>
  <Card title="Conversations" icon="phone" href="/docs/introduction/conversations">
    Learn about conversation types and states
  </Card>

  <Card title="Tools" icon="wrench" href="/docs/introduction/tools">
    Let your agent take actions
  </Card>

  <Card title="Create your first agent" icon="robot" href="/docs/create/creating-your-first-agent">
    Step-by-step guide
  </Card>

  <Card title="LLM Configuration" icon="brain" href="/docs/create/llm-configuration">
    Model selection and parameters
  </Card>
</CardGroup>