Saltar para o conteúdo principal
GET
Listar Agentes

Listar Agentes

GET /v1/agents Retorna uma lista paginada de todas as identidades de agente de máquina registradas sob o inquilino autenticado. Os resultados podem ser filtrados por tipo de agente, status e nível de confiança. Os agentes são retornados em ordem cronológica inversa (os mais recentes primeiro).

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

object[]
Array de objetos de identidade do agente. Cada objeto contém o registro completo do agente incluindo agent_id, agent_type, display_name, status, trust_level, trust_score, scopes, public_key, key_id, metadata, delegation_depth, created_at, e updated_at.
integer
Contagem total de agentes que correspondem aos critérios de filtro, em todas as páginas.

Exemplo

Autorizações

X-API-Key
string
header
obrigatório

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

Parâmetros de consulta

agent_type
enum<string>

Filtrar por tipo de agente

Opções disponíveis:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
status
enum<string>

Filtrar por estado do agente

Opções disponíveis:
active,
suspended,
revoked
trust_level
string
limit
integer

Número máximo de agentes a serem retornados

Intervalo necessário: 1 <= x <= 100
offset
integer

Número de agentes a ignorar

Intervalo necessário: x >= 0

Resposta

Lista paginada de agentes

items
object[]
total
integer