Saltar al contenido principal

Agents

Los agentes de IA que procesan el correo entrante: su modelo, su system prompt, el historial de versiones del prompt y el catálogo de modelos disponibles. Ver el modelo Agent y el modelo LlmModel.

ComandoHTTPDescripción
agents listGET /agentsLista los agents del workspace.
agents getGET /agents/{id}Obtiene un agent, incluyendo su versión actual.
agents createPOST /agentsCrea un agent. La versión empieza en 1.
agents upsertPUT /agentsCrea o actualiza, emparejado por id y luego external_id.
agents updatePATCH /agents/{id}Actualiza. Cambiar el system_message incrementa la versión.
agents deleteDELETE /agents/{id}Soft-delete.
agents versions listGET /agents/{id}/versionsHistorial de versiones del prompt.
models listGET /modelsCatálogo de modelos LLM disponibles vía AI Gateway, con precios.

Ejemplos​

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

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

# Crear
kobana inbox agents create \
  --json '{"label": "Triaje", "llm_model": "anthropic/claude-sonnet-5", "system_message": "Clasificas correos de soporte entrantes..."}'

# Crear o actualizar, emparejado por external_id
kobana inbox agents upsert \
  --json '{"external_id": "triage-v1", "label": "Triaje", "llm_model": "anthropic/claude-sonnet-5"}'

# Actualizar el prompt (incrementa la versión)
kobana inbox agents update \
  --params '{"id": "AGENT_ID"}' \
  --json '{"system_message": "Clasificas correos de soporte y los marcas por urgencia..."}'

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

# Historial de versiones del 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 pasos​