セッション操作

セッションが存在する場合、これらの操作を使用してセッションの読み取り、更新、アーカイブ、または削除を行います。セッションの作成と作業の送信については、セッションの開始を参照してください。

セッションのステータス

セッションは以下のステータスを経て進行します。セッションのライフサイクルについては、セッションの開始を参照してください。

エージェント設定の更新

新しいエージェントバージョンを作成することなく、セッションの途中で、権限ポリシーを含むセッションの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"