Sign in
Agents

Create agent with AI brief

Create a new single-prompt agent from a natural-language brief or structured question/answer pairs. Atoms generates the system prompt for you.

Provide either description (free-form brief) or a non-empty questions array, but not both. The emotiveToggle, voiceId, and voiceModel fields must be supplied as a 3-tuple or omitted entirely.

post/agent/with-ai

Request body

namestring

Agent name (trimmed). Auto-generated when omitted.

descriptionstring

Free-form natural-language description of what the agent should do. Atoms turns this into the system prompt. Use this OR questions, not both.

type'single_prompt'

Currently the only supported agent type.

emotiveToggleboolean

Enable emotive synthesis. Must be paired with voiceId + voiceModel.

voiceIdstring

Voice ID for synthesis. Must be paired with emotiveToggle + voiceModel.

voiceModel'waves' | 'waves_lightning_large' | 'waves_lightning_large_voice_clone' | 'waves_lightning_v2' | 'waves_lightning_v3' | 'waves_lightning_v3_1' | 'gpt-realtime' | 'gpt-realtime-mini' | 'other'

Synthesizer to use. Must be paired with emotiveToggle + voiceId.

knowledgeBaseIdstring

Optional knowledge-base ID to attach to the new agent.

Response

Agent created. data is the new agent's _id (string).

statusboolean
datastring

Newly created agent ID.

Example response

{
  "status": true,
  "data": "60d0fe4f5311236168a109ca"
}

Changes