Listar agentes
Os agentes da organização da chave que a pessoa dela pode usar, em ordem de nome. Fora ficam os arquivados e, numa chave restrita a agentes, os que não estão na seleção. O `id` ou o `handle` de cada um vai no endereço de `POST /v1/agents/{agentId}/run`. Exige o escopo runs:read.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Header Parameters
Slug (ou id) de uma organização cliente do parceiro dono da chave. Aceito só em GET /v1/agents, POST /v1/agents/{agentId}/run, POST /v1/agents/{agentId}/stream, POST /v1/agents/{agentId}/threads, POST /v1/runs/{runId}/continue, GET /v1/runs/{runId}, POST /v1/runs/{runId}/stream, POST /v1/runs/{runId}/stop, POST /v1/runs/{runId}/plan e POST /v1/runs/{runId}/prewarm, e só com o escopo partner:execute: a operação roda dentro da organização cliente, como a identidade de sistema dela, sobre as cópias gerenciadas dos agentes do parceiro. Qualquer outra rota responde 400 org_header_not_supported. Organização que não existe ou não é cliente deste parceiro: 404 client_not_found.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agents"{ "agents": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "handle": "string", "name": "string", "avatar": "string", "source_agent_id": "d9ad10f6-6845-4542-89b9-c3395e83005a", "created_at": "2019-08-24T14:15:22Z" } ]}Referência da API
Como chamar o VolundOS do seu próprio código — autenticação, escopos e o que cada operação faz.
Disparar um agente
Três modos. Sem `callback_url` e sem `async`, a conexão fica aberta e a resposta traz o texto final. Com `callback_url`, a resposta é imediata (202) e o resultado é enviado àquele endereço quando o run termina. Com `async: true`, a resposta é imediata (202) e nada é enviado — o desfecho é consultado em `transcript_url`. Com `user`, a conversa sai em nome dessa pessoa da aplicação ligada à chave (conversa, cota, consumo e conexões no modo de cada pessoa), e não do dono da chave. Ver `user` e `mcp` no corpo. Exige o escopo runs:execute.