ワークフローの構築¶

エージェントワークフローのカスタムモデルをエージェントプレイグラウンドに接続したら、ワークフローを比較およびテストしながら、Codespaceまたはレジストリワークショップでワークフローのコードを変更できます。コードの変更は、エージェントのプレイグラウンドに反映され、エージェントワークフローの構築者は、コンソールにデプロイするための本番環境対応のエージェントワークフローを構築するまで、エクスペリメントを繰り返すことができます。

エージェントワークフローのコンポーネント¶

エージェントのワークフローを構築するために、標準ワークフローのカスタムモデルコードには、以下のコンポーネントを含めることができます。

ファイル	内容
`__init__.py`	Pythonパッケージ初期化ファイル。ディレクトリをPythonパッケージにします。
`custom.py`	LLMを呼び出すためのボルトオンのガバナンスAPI（`chat`フック）を実装し、それらのパラメーターを（`agent.py`で定義されている）エージェントに渡すカスタムモデルコード。
`agent.py`	エージェントコード。必須の`invoke`メソッドを使用して、`MyAgent`クラスにエージェントワークフローを実装します。このクラスにツール統合プロパティを追加して、デプロイされたツールとやり取りできます。
`config.py`	環境変数、ランタイムパラメーター、およびDataRobotの資格情報から設定を読み込むためのコード。
`mcp_client.py`	ツール連携のためのMCPサーバー接続管理を提供するコード（オプション。MCPツールを使用する場合にのみ必要です）。
`tool_deployment.py`	`BaseTool`クラスコード。ツールの実装に必要なすべてのメタデータが含まれています。
`tool.py`	デプロイされたツールとのインターフェイスのためのコードで、入力引数やスキーマを定義します。多くの場合、このファイルは`tool.py`という名前にはなりません。これは、複数のツールを実装する場合があるためです。この例では、この機能は`tool_ai_catalog_search.py`で定義されています。
`model-metadata.yaml`	エージェントのワークフローに必要なカスタムモデルのメタデータとランタイムパラメーター。
`pyproject.toml`	最新のPythonパッケージング標準を使用した、エージェントのワークフローに必要なライブラリ（とバージョン）。

エージェントワークフローの構築の詳細については、以下のリソースを参照してください。

リソース	説明
`datarobot-agent-templates`リポジトリ	マルチエージェントフレームワークでのAIエージェントの構築およびデプロイのためのドキュメントとすぐに使えるテンプレート。これらのテンプレートを使用すると、最小限の設定要件で独自のエージェントを簡単に設定できます。
`agent-tool-templates`リポジトリ	レジストリで利用可能なグローバルエージェントツールのドキュメントとソースコード。これらのツールのソースコードは、エージェントのワークフローで独自のカスタムモデルツールを作成するためのテンプレートとして使用できます。
`datarobot-user-models`リポジトリ	DataRobotでカスタムモデル、カスタムタスク、カスタムノートブック環境を構築、デバッグ、テスト、実行するためのツール、テンプレート、情報です。カスタムモデルのインフラストラクチャは、エージェントワークフローの基盤です。
カスタムモデル構築のドキュメント	カスタムモデルの構築、テスト、実行に関するドキュメント。
ワークショップのドキュメント	DataRobot UIを使用して、モデルアーティファクトをアップロードし、カスタムモデルを作成、テスト、および一元化されたモデル管理・デプロイハブであるコンソールにデプロイするためのドキュメント。

エージェントのワークフローを変更¶

エージェントのプレイグラウンドに接続されたエージェントワークフローは、指標の要求、比較、評価に応じて継続的に変更および開発できます。これは、手動で構築したカスタムツール、およびパブリックリポジトリ`datarobot-agent-templates内のエージェントテンプレートを使用してプログラムで構築したツールで機能します。

Codespace¶

Codespaceは、エージェントのプレイグラウンドでテストしながら、エージェントのワークフローを開発するための主要な方法です。 DataRobotでは、Codespaceはエージェントのファイルを表示、変更、および実行するために使用できる開発環境です。 Codespaceで行われた変更は、レジストリワークショップのカスタムエージェントと同様に、エージェントプレイグラウンドのエージェントワークフローに渡されます。

Codespaceでエージェントのワークフローを開発するには、次のいずれかの場所でCodespaceで開くオプションを見つけます。

ワークフローの比較（ヘッダー）ワークフローの比較（サイドバー）単一モデルのチャット

これらのどのオプションでも、選択したエージェントワークフローのパネルにCodespaceが開きます。そこでは、プレイグラウンドで特定された問題に対処するためにエージェントのコードを変更できます。

Codespaceのロード

エージェントのファイルがロードされている間、パネルにはCodespaceの起動を待っています...というメッセージが表示されます。

エージェントコードの変更が終了したら、保存をクリックして、その変更をプレイグラウンドおよびレジストリワークショップに接続されているエージェントワークフローに反映させます。

ワークショップ¶

Codespaceでエージェントのワークフローを変更するのと同様に、レジストリのワークショップでエージェントコードを直接変更することもできます。詳しくはワークショップのドキュメントをご覧ください。ワークショップでエージェントのワークフローへの変更内容を保存すると、新しいバージョンが作成され、プレイグラウンドに接続されているエージェントのワークフローに渡されます。

ワークショップからは、エージェントのプレイグラウンドでは利用できない評価指標とモデレーションを設定することもできます。