Saltar para o conteúdo principal
PATCH
Atualizar Agente

Atualizar Agente

PATCH /v1/agents/{agentID} Atualiza campos mutáveis em uma identidade de agente de máquina existente. Apenas os campos fornecidos no corpo da solicitação são modificados; todos os outros campos permanecem inalterados. Pelo menos um campo deve ser fornecido.
Para alterar os escopos de um agente, use o sistema de delegação ou registre novamente o agente. Os escopos não podem ser modificados diretamente através deste endpoint para preservar o rastro de auditoria das mudanças de escopo.

Autenticação

Requer cabeçalho X-API-Key ou token JWT de portador. O espaço de trabalho é derivado da credencial autenticada; não envie X-Tenant-ID.

Corpo da Requisição

Todos os campos são opcionais, mas pelo menos um deve ser fornecido.

Resposta

Retorna o objeto de identidade do agente atualizado completo.
string
Chave primária UUID interna.
string
Identificador de agente compatível com MAIP.
string
O nome de exibição atualizado.
string
A descrição atualizada.
object
O objeto de metadados atualizado.
string
Status atual do ciclo de vida após a atualização.
string
Carimbo de data/hora ISO 8601 refletindo a atualização.

Exemplo

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Parâmetros de caminho

agentId
string<uuid>
obrigatório

Identificador do agente

Corpo

application/json
description
string | null
display_name
string | null
Maximum string length: 256
metadata
any
status
string | null

Resposta

Agente atualizado

id
string<uuid>
agent_type
enum<string>
Opções disponíveis:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
display_name
string
Maximum string length: 256
description
string
status
enum<string>
Opções disponíveis:
active,
suspended,
revoked
scopes
string[]
metadata
object
trust_score
number<float>
Intervalo necessário: 0 <= x <= 1
public_key
string

Chave pública codificada em Base64

session_count
integer
keys
object[]
created_at
string<date-time>
updated_at
string<date-time>