Criar um rascunho de prompt
Executa o wizard de um template para um agente (texto ou voz), gerando um rascunho de prompt. Gasta tokens e chama o worker, então a Idempotency-Key é obrigatória. O tipo e o cliente saem do agente.
Com stream: false (o padrão) responde 201 com o rascunho pronto. Com stream: true responde 200 text/event-stream: zero ou mais quadros event: token com os pedaços do texto e um terminal — event: result com o rascunho gravado, ou event: error com o envelope de erro. Nada vem depois do terminal, e um comentário : ping a cada 15 s mantém a conexão de pé.
Repetir a mesma Idempotency-Key devolve o rascunho daquela chamada em JSON, sem gerar de novo, inclusive quando a primeira resposta foi em streaming.
O cliente bloqueado (§14) não gera rascunho: 402 TENANT_BLOCKED, sem rascunho gravado.
Autorização
bearer templates:executeCredencial 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: templates:execute
Parâmetros de cabeçalho
Chave de 1 a 255 caracteres ASCII visíveis, estável por intenção do usuário: a mesma chave numa retentativa devolve a primeira resposta em vez de repetir o efeito.
Corpo da requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
O corpo de POST /prompt-drafts.
Corpo da resposta
text/event-stream
application/json
application/json
curl -X POST "https://example.com/prompt-drafts" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978", "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc" }'{ "data": { "text": "string" }, "event": "token"}