Agents

Os agentes de IA que processam o e-mail recebido: seu modelo, seu system prompt, o histórico de versões do prompt e o catálogo de modelos disponíveis. Veja o modelo Agent e o modelo LlmModel.

Comando	HTTP	Descrição
agents list	GET /agents	Lista agents no workspace.
agents get	GET /agents/{id}	Busca um agent, incluindo sua versão atual.
agents create	POST /agents	Cria um agent. A versão começa em 1.
agents upsert	PUT /agents	Cria ou atualiza, casado por id e depois external_id.
agents update	PATCH /agents/{id}	Atualiza. Mudar o system_message incrementa a versão.
agents delete	DELETE /agents/{id}	Soft-delete.
agents versions list	GET /agents/{id}/versions	Histórico de versões do prompt.
models list	GET /models	Catálogo de modelos LLM disponíveis via AI Gateway, com preços.

Exemplos

# Listar, filtrado por modelo
kobana inbox agents list \
  --params '{"llm_model": "anthropic/claude-sonnet-5"}' \
  --fields "id,label,llm_model"

# Buscar um
kobana inbox agents get \
  --params '{"id": "AGENT_ID"}' \
  --fields "id,label,llm_model,system_message"

# Criar
kobana inbox agents create \
  --json '{"label": "Triagem", "llm_model": "anthropic/claude-sonnet-5", "system_message": "Você triagem e-mails de suporte recebidos..."}'

# Criar ou atualizar, casado por external_id
kobana inbox agents upsert \
  --json '{"external_id": "triage-v1", "label": "Triagem", "llm_model": "anthropic/claude-sonnet-5"}'

# Atualizar o prompt (incrementa a versão)
kobana inbox agents update \
  --params '{"id": "AGENT_ID"}' \
  --json '{"system_message": "Você triagem e-mails de suporte e marca por urgência..."}'

# Soft-delete
kobana inbox agents delete --params '{"id": "AGENT_ID"}' --dry-run

# Histórico de versões do prompt
kobana inbox agents versions list \
  --params '{"id": "AGENT_ID"}' \
  --fields "version,system_message,created_at"

# Catálogo de modelos
kobana inbox models list --fields "id,provider,input_price,output_price"

Próximos passos

• Inboxes — qual inbox aponta para qual agent.
• Agent runs e uso — cada execução que este agent produziu.