create-agent
Installation
SKILL.md
Create Bolna Agent
Use the current API
- Endpoint:
POST https://api.bolna.ai/v2/agent - Auth:
Authorization: Bearer $BOLNA_API_KEY - Body root:
agent_configandagent_prompts - Response:
agent_idandstatus: created - Do not use deprecated
/agentv1 endpoints for new agents.
Minimum creation flow
- Confirm the user has
BOLNA_API_KEYset. - Gather: agent name, use case, language, welcome message, system prompt, LLM provider/model, voice/TTS provider, transcriber/STT provider, telephony provider, webhook URL if needed.
- Build one
conversationtask unless the user explicitly asks for extraction, summarization, or advanced flows. - Put dynamic variables in prompts with braces, for example
{customer_name}. - Add matching values later through
user_datawhen making calls. - Include conservative call controls: silence hangup, interruption words, max duration, voicemail behavior, inbound limits.
- POST the payload, then save the returned
agent_id.