Skip to main content

Agents

The AI agents that process incoming mail: their model, their system prompt, their prompt version history and the catalogue of models available. See the Agent model and the LlmModel model.

CommandHTTPDescription
agents listGET /agentsList agents in the workspace.
agents getGET /agents/{id}Fetch one agent, including its current version.
agents createPOST /agentsCreate an agent. Version starts at 1.
agents upsertPUT /agentsCreate or update, matched by id then external_id.
agents updatePATCH /agents/{id}Update. Changing system_message bumps the version.
agents deleteDELETE /agents/{id}Soft-delete.
agents versions listGET /agents/{id}/versionsPrompt version history.
models listGET /modelsCatalogue of LLM models available through the AI Gateway, with prices.

Examples​

# List, filtered by model
kobana inbox agents list \
  --params '{"llm_model": "anthropic/claude-sonnet-5"}' \
  --fields "id,label,llm_model"

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

# Create
kobana inbox agents create \
  --json '{"label": "Triage", "llm_model": "anthropic/claude-sonnet-5", "system_message": "You triage inbound support e-mail..."}'

# Create or update, matched by external_id
kobana inbox agents upsert \
  --json '{"external_id": "triage-v1", "label": "Triage", "llm_model": "anthropic/claude-sonnet-5"}'

# Update the prompt (bumps the version)
kobana inbox agents update \
  --params '{"id": "AGENT_ID"}' \
  --json '{"system_message": "You triage inbound support e-mail and tag it by urgency..."}'

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

# Prompt version history
kobana inbox agents versions list \
  --params '{"id": "AGENT_ID"}' \
  --fields "version,system_message,created_at"

# Model catalogue
kobana inbox models list --fields "id,provider,input_price,output_price"

Next steps​