Publicar um template no agente
Publica no agente um template do catálogo (source: template) ou um rascunho já gerado para ele (source: prompt_draft), e grava uma versão no histórico. É o único escritor de "template publicada": a config do template é mesclada na do agente, os hooks do template não viajam e as conexões (mcp_servers) do agente não são tocadas.
Rascunho de outro agente responde 422; rascunho ainda não concluído, 409.
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 caminho
Id do agente
Corpo da requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
O corpo de PUT /agents/{agent_id}/active-template.
A origem é uma união discriminada por source, e não dois campos
opcionais: publicar tem exatamente duas origens, e um corpo com os dois ids
preenchidos — ou nenhum — não é um pedido que alguém queira fazer. O
discriminador transforma isso num erro de forma, antes de qualquer regra.
Publicar um template do catálogo como está.
Corpo da resposta
application/json
application/json
curl -X PUT "https://example.com/agents/string/active-template" \ -H "Content-Type: application/json" \ -d '{ "source": "template", "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc" }'{ "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978", "agent_kind": "string", "applied_at": "2019-08-24T14:15:22Z", "prompt_draft_id": "f3f22dd6-3be3-4786-830b-9f8ca2a28768", "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc", "template_version": 0, "version_id": "9e94c502-ca41-4342-a7f7-af96b444512c"}