Agentes
Substituir as ferramentas de um agente
Define a política de ferramentas MCP e as nativas (só texto). É o único ponto que grava essas listas. Gera uma versão do agente. Com base_version_id, se a versão atual do agente for outra, responde 409 details.reason = "stale_version" e nada é gravado. Devolve as ferramentas resultantes.
Autorização
bearer tools:writeAutorizaçãoBearer <token>
Credencial 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: tools:write
Parâmetros de caminho
agent_id*string
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}/tools.
Corpo da resposta
application/json
application/json
curl -X PUT "https://example.com/agents/string/tools" \ -H "Content-Type: application/json" \ -d '{ "mcp_tools": { "mode": "all" } }'{ "available": [ { "description": "string", "input_schema": null, "name": "string", "namespace": "string" } ], "mcp_tools": { "mode": "all", "names": [ "string" ] }, "native_tools": [ "string" ]}