Saltar para o conteúdo principal
POST
Registrar Agente

Registrar Agente

POST /v1/agents Regista uma nova identidade de agente de máquina para o inquilino autenticado. A plataforma gera um par de chaves Ed25519 para o agente, atribui um ID de agente compatível com MAIP e regista a chave inicial no livro-razão do histórico de chaves. Os agentes recém-registados começam com o estado active e uma pontuação de confiança inicial de 0.500.
O número de agentes que você pode registrar depende do seu plano de faturamento. Se você exceder o limite do seu plano, a API retorna 402 Payment Required. Entre em contato com as vendas para limites de agentes de nível empresarial.

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 no formato maip:<tenant8>:<ulid>. Use este valor em todas as chamadas de API subsequentes que referenciam este agente.
string
UUID do locatário proprietário.
string
O tipo de agente registrado.
string
Nome do agente legível por humanos.
string
Descrição do agente, se fornecida.
string
Nível de confiança inicial. Agentes recém-registrados começam em "authenticated".
number
Pontuação de confiança numérica (0,0 a 1,0). Agentes recém-registrados começam em 0.500.
string
Status do ciclo de vida do agente. Sempre "active" na criação.
string
Chave pública Ed25519 codificada em Base64url gerada para este agente. Armazene esta com segurança para verificação de assinatura.
string
Identificador único para a chave de assinatura do agente. Referenciado em recibos e atestações.
string[]
Os escopos efetivos atribuídos ao agente.
object
O objeto de metadados, se fornecido.
number
Profundidade atual da cadeia de delegação. Sempre 0 para agentes diretamente registrados. A profundidade máxima é 8 por protocolo MAIP.
string
UUID do usuário que registrou o agente, se autenticado via token de usuário.
string
Timestamp de expiração, se definido.
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

Corpo

application/json
display_name
string
obrigatório

Nome do agente legível por humanos

Maximum string length: 256
agent_type
enum<string>

Classificação do agente

Opções disponíveis:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
description
string

Descrição em texto livre da finalidade do agente

expires_at
string<date-time> | null
metadata
any

Metadados arbitrários de chave-valor

scopes
string[]

Escopos de permissão concedidos ao agente

Resposta

Agente registrado

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>