Saltar para o conteúdo principal
GET
Obter Agente

Obter Agente

GET /v1/agents/{agentID} Retorna o registro completo de identidade do agente para o agente especificado, incluindo informações da chave criptográfica, pontuação de confiança atual, escopos atribuídos, profundidade de delegação e todos os metadados. O agente deve pertencer ao locatário autenticado.

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.

Resposta

string
Chave primária UUID interna.
string
Identificador de agente compatível com MAIP.
string
UUID do locatário proprietário.
string
Classificação do tipo de agente.
string
Nome do agente legível por humanos.
string
Descrição do agente.
string
Nível da hierarquia de confiança. Um de: "platform_root", "verified_org", "verified_individual", "authenticated", "self_asserted", "anonymous".
number
Pontuação de confiança numérica entre 0,0 e 1,0. Ajustada ao longo do tempo com base no agente comportamento, detecção de anomalias e histórico de atestações.
string
Status atual do ciclo de vida: "active", "suspended", ou "revoked".
string
Chave pública Ed25519 codificada em Base64url para este agente.
string
Identificador de chave único para verificação de assinatura de recibo e atestação.
string[]
Escopos de permissão atribuídos no formato resource:action.
object
Metadados arbitrários anexados ao agente.
string
Se este agente foi criado via delegação, o MAIP ID do agente pai.
number
Posição na cadeia de delegação (0 = raiz, máx. 8).
string
UUID do usuário que registrou o agente, se aplicável.
string
Carimbo de data/hora ISO 8601 se a chave do agente foi marcada como comprometida.
string
Carimbo de data/hora de expiração automática, se configurado.
string
Carimbo de data/hora de criação ISO 8601.
string
Carimbo de data/hora da última atualização ISO 8601.

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

Resposta

Detalhes do agente

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>