Agent SDKの概要

単発の生成だけでは足りないアプリケーションでは、Phaseo Agent SDKを使用します。

• 複数ステップのツールループ
• ローカルランタイムツール
• Gatewayを使ったモデルターン
• アプリケーションが所有する再開可能な実行状態
• 厳密な呼び出し承認、human-in-the-loopツール、手動ツール、再開可能な続行
• ランタイム検証、進捗を通知するツール、復旧可能なツールエラー
• 再生可能なイベントコンシューマーを備えたモデル出力ストリーミング
• 動的なターン設定、組み合わせ可能な停止条件、正規化された使用量とコスト
• モデルの再試行、ツールのタイムアウト、制限付きツール並行実行、ライフサイクルイベント
• Phaseo Devtoolsによるローカルキャプチャ
• コアClient SDKと同じ言語での一貫したリクエストルーティング

​

対応言語

現在のAgent SDK言語は、Phaseoクイックスタートで提供される主要なClient SDKの言語と同じです。

• TypeScript
• Python
• Go
• C#
• PHP
• Ruby
• Rust

​

共通モデル

どのAgent SDKも同じランタイムモデルを採用しています。

• エージェントを1つ定義する
• 0個以上のローカルツールを定義する
• Gateway接続のモデルクライアントを作成する
• responses APIで上限付きループを実行する
• ライフサイクルイベントまたはDevtoolsのトレースを調べる
• 返された実行状態を保存し、人間の判断後に再開する

TypeScriptがAPI設計のリファレンスです。Python、Go、C#、PHP、Rubyは、各言語固有のコールバックや並行処理、タイムアウト、キャンセルのプリミティブを使って、言語横断の広範な契約を提供します。Rustは同期実行の対応ランタイムで、ローカル/外部ツール、厳密なIDによる承認、人によるレビュー、モデル再試行、シリアライズ可能な実行状態、ライフサイクルコールバック、使用量集計を備えています。JavaとC++は引き続き開発中です。

​

言語間の機能契約

PHPとRubyでは、プロバイダーのストリームイベントを通常の同期イテレーションAPIで取得できます。ホスト型ランタイムやバックグラウンドのPhaseoサービスは不要です。

​

Client SDK、Agent SDK、API

Agent SDKのGatewayアダプターは、モデルターンを対応するClient SDKに委譲します。requestOptionsフックまたは同等の仕組みを持つ言語では、追加のResponses APIフィールドを渡せます。その場合もAgent SDKがmodel、input、instructions、ローカル関数ツールを管理します。Rust 0.1アダプターは現在、追加のリクエストオプションフックなしで正規化されたエージェントフィールドを送信します。

​

レシピ

クックブックにはTypeScriptのワークフローと言語別の開始例があります。

• 長時間実行可能なエージェントループを構築する
• エージェントによるWeb検索で調査する
• プリセット駆動のエージェントでサポートを振り分ける
• ローカルランタイムツールでコードをレビューする
• ローカルツールを並行実行する