人間が実行するエージェントの実行

実行ステータスのライフサイクル

Atlas Agent Engine は、各実行APIレスポンスの statusフィールドに現在のステータスを報告します。人間によるレビューを必要としない実行は、次のステータスを通過します。

• pending

• running

• completed or error

人間のレビューのために実行が一時停止されると、次のステータスを通過します。

• pending

• running

• suspended

• resuming

• completed or error

再生保証

OA が実行を再開すると、一時停止の前に完了したすべてのステップのキャッシュされた結果が返されます。エージェントは同じコードパスを再実行しますが、OA は前の手順を再度実行中のではなく、保存された結果を提供します。レビュー点の後のステップのみが初めて実行されます。

このリプレイ保証により、重複するアクションを防止できます。例、エージェントがレビューのために一時停止する前にメールを送信した場合、再開された実行によってそのメールが2 回目に送信されることはありません。

レビューの決定

エージェントが一時停止すると、レプリカは一時停止された実行に関する決定を送信します。この決定を送信するには、次の入力を提供してください。

次のセクションでは、これらを入力するさまざまな方法について説明します。

APIの使用

APIを使用して一時停止した実行を再開するには、POST /api/v1/projects/{project_id}/executions/{execution_id}/resume?workspace_id={workspace_id}APIエンドポイントに リクエストを送信します。リクエスト本文には、「再開リクエスト本文」に示されているように、レビューの決定が含まれます。実行エンドポイントのスコープはプロジェクトに限定されます。プロジェクトID、 実行ID、 ワークスペースIDのプレースホルダーを独自の値に置き換えます。

お好みのツールのタブを選択して、中断された実行を再開する POSTリクエストの例を確認してください。各例の X-Mdb-Agent-Engine-Custom-Authorization ヘッダーは、カスタム ヘッダーを再送信する方法を示しています。

curl -X POST "https://agentengine.mongodb.com/api/v1/projects/$PROJECT_ID/executions/$EXECUTION_ID/resume?workspace_id=$WORKSPACE_ID" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Mdb-Agent-Engine-Custom-Authorization: my-user-id" \
  -H "Content-Type: application/json" \
  -d '{"decision": "approve", "reviewer_notes": "optional context"}'

import httpx
response = httpx.post(
    f"https://agentengine.mongodb.com/api/v1/projects/{project_id}/executions/{execution_id}/resume",
    params={"workspace_id": workspace_id},
    headers={
        "Authorization": f"Bearer {api_key}",
        "X-Mdb-Agent-Engine-Custom-Authorization": "my-user-id",
        "Content-Type": "application/json",
    },
    json={"decision": "approve", "reviewer_notes": "optional context"},
)

{"decision": "approve", "reviewer_notes": "approved after verifying customer identity"}

CLI の使用

インタラクティブターミナルでメッセージなしで agentengine invoke コマンドを実行すると、CLI によってストリーミングチャット セッションが開始されます。この 対話モードでは、エージェントが人間によるレビューの呼び出しを一時停止するときに、CLI はインライン レビューのプロンプトを自動的に表示します。

CLI は、エージェントが提供した一時停止コンテキストと、許可された決定の番号付きリストを出力します。 CLI 出力は、次の例のようになります。

--- Execution suspended for human review ---
  claim_id: CLM-4821
  task_description: Approve refund of $240 for order #98765
Select a decision:
  1) approve
  2) reject
Select [1-2]:

決定を選択すると、次の例に示すように、CLI によって任意のレビューア ノートの入力を求められます。

Reviewer notes (optional): [default: ]

その後、CLI は実行を再開し、Execution resumed. セッションは開いたままなので、エージェントの再開後の出力を取得するために追跡メッセージを送信できます。

コマンドの詳細については、「agentengine invoke CLI からエージェントを呼び出す 」を参照してください。

UI の使用

Atlas Agent Engine UI には、Pending Reviews ページに一時停止された実行が表示されます。ここでは、一時停止された実行を検査して決定を送信できます。 UIから中断された実行を再開するには、次の手順を実行します。