Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blackbox.dasha.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

ComponentRequiredWhat it does
System promptYesDefines personality, role, rules, knowledge
LLM configYesWhich AI model powers the brain (OpenAI, Groq, etc.)
Voice configYesWhich voice speaks the responses (ElevenLabs, Cartesia, etc.)
ToolsNoExternal actions the agent can take mid-conversation
ScheduleNoBusiness hours — when the agent accepts calls
WebhooksNoURLs 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. 
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 })
});
Changes to enabled agents apply immediately. If you’re making significant changes, disable the agent first, make changes, test, then re-enable.

​
What’s next

Conversations

Learn about conversation types and states

Tools

Let your agent take actions

Create your first agent

Step-by-step guide

LLM Configuration

Model selection and parameters