세션 작업

세션이 생성되면 이러한 작업을 사용하여 세션을 읽기, 업데이트, 보관 또는 삭제할 수 있습니다. 세션을 생성하고 작업을 전송하는 방법은 세션 시작하기를 참조하세요.

세션 상태

세션은 다음 상태를 거쳐 진행됩니다. 세션 수명 주기에 대해서는 세션 시작하기를 참조하세요.

에이전트 구성 업데이트

새 에이전트 버전을 생성하지 않고도 세션 중간에 권한 정책을 포함한 세션의 agent.tools 및 agent.mcp_servers를 업데이트할 수 있습니다. 업데이트는 세션에 국한되며 기본 에이전트로 다시 전파되지 않습니다.

업데이트의 의미는 전체 교체입니다. 즉, 제공된 배열이 새 값이 됩니다. 기존 항목을 유지하려면 세션을 GET으로 가져와 배열을 수정한 다음 POST로 다시 전송하세요.

에이전트를 업데이트하려면 세션이 idle 상태여야 합니다. 실행 중인 에이전트를 업데이트해야 하는 경우 세션을 중단하세요.

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

세션 조회

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

세션 나열

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

세션 보관

세션을 보관하면 기록을 보존하면서 새 이벤트가 전송되지 않도록 할 수 있습니다. running 상태의 세션은 보관할 수 없습니다. 즉시 보관해야 하는 경우 중단 이벤트를 전송하세요.

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

세션 삭제

세션을 삭제하면 해당 레코드, 이벤트 및 연결된 샌드박스가 영구적으로 제거됩니다. running 상태의 세션은 삭제할 수 없습니다. 즉시 삭제해야 하는 경우 중단 이벤트를 전송하세요.

파일, 메모리 스토어, 볼트, 스킬, 환경 및 에이전트는 독립적인 리소스이며 세션 삭제의 영향을 받지 않습니다.

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