architect-generate-agent

# Generate a new agent (there is no one-shot generate endpoint) The web Architect has a `generate_agent` action. Over the ConvAI REST API there is NO one-shot generate endpoint. Do not pretend there is. Instead, gather requirements, create a starter agent with `POST /v1/convai/agents/create`, then refine it with `PATCH` (host `https://api.elevenlabs.io`, header `xi-api-key: $API_KEY`). ## Step 1: pause and ask clarifying questions Before creating anything, understand what the user actually needs. Ask targeted questions to gather: - Use case and context: what specific problem does this agent solve? Who are the end users? - Scope and capabilities: what should the agent do, and what should it NOT do? - Tone and personality: how should it sound (formal, friendly, technical)? - Integration needs: does it need to call external APIs, access a knowledge base, or trigger workflows? - Success criteria: how will the user know it is working well? - Constraints: any compliance, language, or channel requirements? ## Step 2: synthesize and confirm Summarize your understanding back to the user in 2-3 sentences and ask "Is this what you're looking for?" This prevents building the wrong agent. ## Step 3: create the agent Once aligned, create the agent with `POST /v1/convai/agents/create`. Set the name and an initial `conversation_config` built from the synthesized requirements: a system prompt capturing the use case, scope, tone, and constraints, a suitable first message, and an LLM chosen for the task (see the `architect-llm-selection` skill for region/compliance/latency tradeoffs). The response returns the new `agent_id`. ## Step 4: refine Iterate with `PATCH /v1/convai/agents/{agent_id}?branch_id={b}` partial-merge bodies to tighten the prompt, add tools, or adjust config. For step-by-step behavior, add procedures (see the `architect-manage-procedures` skill). For knowledge, attach knowledge base documents via `POST /v1/convai/knowledge-base/text` or `.../url`. For post-call extraction and grading, see the `architect-post-call-data` skill. ## Step 5: review and next steps Tell the user the agent is created and offer next steps: review the system prompt, set up procedures, test with a simulation, secure it for production, or customize the workflow.