Deploy agentic tools¶

エージェントを構築する際に、エージェントのワークフローに不可欠なタスクを処理するためのツールを統合する必要がよくあります。これは、通常、外部サービスとの通信を伴う複雑なユースケースで必要になります。エージェントワークフローのコードに直接埋め込まれているツールもあれば、外部にデプロイされてエージェントプロセスによって呼び出されるツールもあります。外部にデプロイされたツールは個別に拡張できるため、リソースを大量に消費する操作、I/Oバウンドタスク、および再利用可能な機能に最適です。ツールを外部にデプロイすると、コンソールで本番環境対応の監視、リスク軽減、およびモデレーション機能も有効になります。

グローバルエージェントツール¶

コンソールへのデプロイでは、以下のグローバルツールを利用できます。

ツールの識別

すべてのグローバルツールには、[Tool]識別子がプレフィックスとして付けられます。この識別子を使用して、グローバルモデルとツールリストをフィルターし、ツールのみを表示します。

ツール	説明	備考
Get Data Registry Dataset	`dataset_id`を使用してDataRobotのデータレジストリからデータセットを取得し、CSV形式でrawバイトとしてそのデータセットを返します。	N/A
Make AutoML Predictions	`pandas.DataFrame`を受け取り、そのデータを使用して、指定された予測モデルから予測を返します。	引数`columns_to_return_with_predictions`は、入力データセットから列を返すようにツールに指示します。これは、予測を確実に解釈できるようにするために使用します。たとえば、予測値のインデックスや順序に依存できないため、どの予測がどれであるかを確認できるように、IDやその他の識別列を返したい場合があります。
Make Text Generation Predictions	文字列を受け取り、指定されたDataRobotテキスト生成モデル（LLM）から予測を返します。	要約やテキスト補完などの作業に適しています。このツールは、TextGenerationのデプロイにのみ使用し、連続値、分類、その他のターゲットタイプには使用しないでください。
Make Time Series Predictions	時系列モデルから予測を返します。	このツールを使用する前に、必要なデータがすべて揃っていることを確認してください。時系列モデルには予測ポイントが必要です。また、入力データにも特定の要件があります。
Render Plotly Chart	指定された仕様とデータセットIDに基づいて生成およびレンダリングされたPlotlyチャートオブジェクトを含むJSONオブジェクトを返します。	Plotlyチャートを生成する際、仕様内のプレースホルダー（列名を二重の波括弧で囲んだもの、例：`{{ column_name }}`）は、データレジストリのデータセット内の指定された列の対応する値に置き換えられます。データレジストリのデータセットは`dataset_id`入力パラメーターで識別されます。
Render Vega-Lite Chart	Vega-Lite仕様をJSON形式で渡すことによってVega-Liteチャートを生成し、チャートのBase64エンコードされたイメージをJSONで返します。	チャートのデータを指定するには、データレジストリにチャート化するデータセットの`dataset_id`を渡します。
Search Data Registry	検索語を使ってDataRobotのデータレジストリ内のデータセットを検索します。一致するデータセットを`pandas.DataFrame`として返します。	データレジストリでは、部分一致はサポートされていません。このツールで期待どおりの結果が得られない場合は、より具体的な検索クエリーで再試行してください。
Summarize DataFrame	統計やデータインサイトなど、`pandas.DataFrame`の詳細なサマリーをMarkdown形式で提供します。	N/A

エージェントツールのターゲットタイプ

すべてのグローバルツールのターゲットタイプは非構造化で、ターゲットはtargetです。

ツールの詳細については、公開されているagent-tool-templatesリポジトリのソースコードにアクセスしてください。各ツールにはglobal.model.sourceタグが付けられ、そのツールのソースファイルを含むディレクトリにリンクしています。これにより、その内容を調べてモデルの詳細を確認したり、その入出力スキーマを確認したり、カスタマイズされたツールを構築するためのテンプレートとしてコードを使用したりできます。リポジトリのリンクを見つけるには：

：fontawesome-solid-globe： グローバルフィルターを適用し、リストで[ツール]を探します。
バージョンを開き、そのバージョンでキー値セクションまで下にスクロールします。
タグパネルを開き、global.model.sourceタグを見つけます。
タグの値にカーソルを合わせると、完全なURLが表示されます。また、リンクをクリックすると、そのツールのディレクトリのリポジトリが開きます。