Criar agente
Cria um agente de texto ou de voz. Um chamador que alcança mais de um cliente informa tenant_id; um de um cliente pode omitir. Cliente inexistente ou fora do alcance responde 404 TENANT_NOT_FOUND. tarefa só vale para type=text. O nome de um agente de voz é único no cliente (sem distinguir caixa nem espaços): repetido responde 409 com details.field = "name". Aceita Idempotency-Key (opcional).
Autorização
bearer agents:writeCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: agents:write
Parâmetros de cabeçalho
Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.
Corpo da requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
Criação de um agente.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/agents" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "type": "text" }'{ "active_template_name": "string", "agent_mode": "string", "blocked_by": null, "created_at": "2019-08-24T14:15:22Z", "current_version_id": "158beffb-f9de-457f-bbee-873740e72504", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "is_active": true, "lifecycle_state": null, "name": "string", "production_ended_at": "2019-08-24T14:15:22Z", "production_started_at": "2019-08-24T14:15:22Z", "purpose": "string", "telephony_provider": "string", "tenant_id": 0, "type": "string", "updated_at": "2019-08-24T14:15:22Z", "voice_mode": "string"}