Substituir a configuração de um agente
Substitui a configuração de um agente. Substitui as chaves que a v3 conhece e preserva as demais. Mudar os campos de governança exige também agent-lifecycle:write. Se base_version_id não for a versão atual, responde 409 (edição concorrente) e nada é gravado. Devolve a configuração e a versão gerada.
Autorização
bearer agent-config: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: agent-config:write
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/{id}/config.
Corpo da resposta
application/json
application/json
curl -X PUT "https://example.com/agents/string/config" \ -H "Content-Type: application/json" \ -d '{ "config": { "type": "text" } }'{ "cache_ttl_seconds": 0, "hooks": null, "max_tokens": 0, "model": "string", "status_taxonomy": null, "system_prompt": "string", "temperature": 0, "top_p": 0, "agent_instructions": "string", "governance": null, "history": null, "output_schema": null, "verbosity": "string", "type": "text", "version_id": "9e94c502-ca41-4342-a7f7-af96b444512c"}