Voice Agents

Generate Agent Config

Generate Agent Config

Requires the OWNER or ADMIN role. Runs the prompt-to-config pipeline against an existing agent: extracts a config from prompt via the LLM, and either persists it onto the agent (response has an agent key), or, when the prompt is too thin to act on and manualInstructions was not sent, returns a follow-up question instead (response has needsFollowUp: true) so you can call this again with more detail.

post/voice/agents/{agentId}/generation/generate

Request

  • Base URL: https://api.speakai.co/v1
  • URL: https://api.speakai.co/v1/voice/agents/{agentId}/generation/generate
  • Auth: API key in header x-speakai-key and API key in header x-access-token

Path parameters

agentIdstring required

Request body

promptstring required

Required. Describe the agent you want in a sentence or two.

namestring
manualInstructionsstring

Skips the thin-prompt follow-up question and generates immediately, folding this in as additional context.

Response

OK

status'success'

Changes

No recorded changes to this operation across all 2 revisions of this API.