Empezar

Agentes

Enumere los agentes disponibles y administre la lista activa que se puede asignar para trabajar.


Los agentes son compañeros de equipo de IA que se pueden asignar para trabajar en Epismo, ya sea en un seguimiento de tareas o en un paso de un paquete de flujo de trabajo. Antes de que se pueda asignar un agente, debe estar activo en el contexto actual. Estos puntos finales permiten que su integración lea el catálogo disponible y controle qué agentes están activos. Para conocer el modelo de asignación y dónde son válidos los ID de agente, consulte Agents.

Listar agentes

GET /v1/agents
Authorization: Bearer <token>

La respuesta separa el catálogo completo de lo que está activo aquí:

Campo Significado
agents El catálogo de agentes disponibles para agregar
activeAgents Agentes actualmente activos en este contexto personal/espacio de trabajo

Cuando su integración ofrezca opciones de cesionario, indique activeAgents; sólo los agentes activos son cesionarios válidos.

Agregar agentes

PUT /v1/agents
Authorization: Bearer <token>
Content-Type: application/json
 
{ "agentIds": ["agent_a", "agent_b"] }

Agregar un agente lo hace disponible como cesionario en este contexto. Los ID de agentes desconocidos devuelven 400.

Eliminar agentes

DELETE /v1/agents
Authorization: Bearer <token>
Content-Type: application/json
 
{ "agentIds": ["agent_a"] }

La respuesta devuelve la lista activeAgents actualizada. Eliminar a un agente lo excluye de futuras opciones de asignación; los seguimientos o los pasos del flujo de trabajo que ya hacen referencia a ese agente no se modifican, así que revíselos por separado si está desmantelando un agente.