Skip to main content
単発のテキストリクエスト以上の処理が必要な場合に、このレシピを使います。
  • 複数ステップのツールループ
  • ローカルランタイムツール
  • 再開可能な実行
  • エージェント処理のための単一のGateway経由エントリーポイント

1. SDKをインストールする

2. 小さなランタイムツールを定義する

最初のツールは決定的で、簡単に確認できるものにします。

3. エージェントを作成する

4. Gatewayアダプターを使う

5. ステップ間で保持される情報

各ステップが完了すると、返される実行状態に次の情報が追加されます。
  • 実行ID
  • メッセージ履歴
  • 返されたツール呼び出し
  • ローカルツールの結果
  • 実行完了時の最終出力
リクエストやプロセスをまたいで再開するには、返された値をアプリケーションに保存し、後からcontinueRun()に渡します。

6. 最初のバージョンをシンプルに保つ場面

  • ワークフローごとにエージェントを1つ用意する
  • リクエストをまたいで再開する前にアプリケーション側でシリアライズする
  • 汎用ツールレジストリを作る前にツールを少数に絞る
  • 各実行につき、実行IDとGatewayリクエストIDを含むログを1行出力する

7. このレシピを拡張する場面

次の要件が出てきたら、最初の永続化ループを拡張します。
  • 承認のための一時停止
  • 返された実行状態のアプリケーション側での永続化
  • 共通のランタイムツールを使う複数のエージェント定義
その場合もGatewayアダプターはそのまま使い、ストアとオーケストレーションを拡張します。

関連ガイド

最終更新日 2026年10月2日