Operaciones de sesión

Una vez que existe una sesión, usa estas operaciones para leerla, actualizarla, archivarla o eliminarla. Consulta Iniciar una sesión para crear una sesión y enviarle trabajo.

Estados de sesión

Las sesiones avanzan a través de estos estados. Consulta Iniciar una sesión para ver el ciclo de vida de la sesión.

Actualizar la configuración del agente

Puedes actualizar agent.tools y agent.mcp_servers de una sesión, incluidas las políticas de permisos, en medio de la sesión sin crear una nueva versión del agente. Las actualizaciones son locales a la sesión y no se propagan de vuelta al agente subyacente.

La semántica de una actualización es de reemplazo completo: el arreglo proporcionado es el nuevo valor. Para conservar las entradas existentes, haz un GET de la sesión, modifica el arreglo y envíalo de vuelta con POST.

La sesión debe estar en idle para actualizar el agente. Interrumpe la sesión si necesitas actualizar el agente mientras está en ejecución.

ant beta:sessions update --session-id "$SESSION_ID" <<'YAML'
agent:
  tools:
    - type: agent_toolset_20260401
    - type: mcp_toolset
      mcp_server_name: linear
  mcp_servers:
    - type: url
      name: linear
      url: https://mcp.linear.app/sse
YAML

Recuperar una sesión

ant beta:sessions retrieve --session-id "$SESSION_ID"

Listar sesiones

ant beta:sessions list --agent-id "$AGENT_ID"

Archivar una sesión

Archiva una sesión para evitar que se envíen nuevos eventos mientras se conserva su historial. Una sesión en estado running no se puede archivar; envía un evento de interrupción si necesitas archivarla de inmediato.

ant beta:sessions archive \
  --session-id "$SESSION_ID"

Eliminar una sesión

Elimina una sesión para borrar permanentemente su registro, eventos y sandbox asociado. Una sesión en estado running no se puede eliminar; envía un evento de interrupción si necesitas eliminarla de inmediato.

Los archivos, almacenes de memoria, bóvedas, habilidades, entornos y agentes son recursos independientes y no se ven afectados por la eliminación de la sesión.

ant beta:sessions delete \
  --session-id "$SESSION_ID"