# ワークフローの構築

> ワークフローの構築 - エージェントワークフローのカスタムモデルをエージェントプレイグラウンドに接続したら、ワークフローを比較およびテストしながら、Codespaceまたはワークショップでエージェント
> ワークフローのコードを変更できます。

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-07-15T05:55:44.569708+00:00` (UTC).

## Primary page

- [ワークフローの構築](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-eval/agentic-workflow-build.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [エージェントワークフローのコンポーネント](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-eval/agentic-workflow-build.html.md#agentic-workflow-components): In-page section heading.
- [エージェントのワークフローを変更](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-eval/agentic-workflow-build.html.md#modify-an-agentic-workflow): In-page section heading.
- [Codespace](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-eval/agentic-workflow-build.html.md#codespace): In-page section heading.
- [ワークショップ](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-eval/agentic-workflow-build.html.md#workshop): In-page section heading.

## Documentation content

[エージェントワークフローのカスタムモデルをエージェントプレイグラウンドに接続](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-eval/agentic-playground.html.md#connect-an-agentic-workflow) したら、ワークフローを比較およびテストしながら、Codespaceまたはレジストリワークショップでワークフローのコードを変更できます。 コードの変更は、エージェントのプレイグラウンドに反映され、エージェントワークフローの構築者は、コンソールにデプロイするための本番環境対応のエージェントワークフローを構築するまで、エクスペリメントを繰り返すことができます。

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

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

| ファイル | 内容 |
| --- | --- |
| __init__.py | Pythonパッケージ初期化ファイル。ディレクトリをPythonパッケージにします。 |
| custom.py | LLMを呼び出すためのボルトオンのガバナンスAPI（chatフック）を実装し、それらのパラメーターを（myagent.pyで定義されている）エージェントに渡すカスタムモデルコード。 |
| myagent.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-applicationリポジトリ | マルチエージェントフレームワークでのAIエージェントの構築およびデプロイのためのドキュメントとすぐに使えるテンプレート。 これらのテンプレートを使用すると、最小限の設定要件で独自のエージェントを簡単に設定できます。 |
| agent-tool-templatesリポジトリ | レジストリで利用可能なグローバルエージェントツールのドキュメントとソースコード。 これらのツールのソースコードは、エージェントのワークフローで独自のカスタムモデルツールを作成するためのテンプレートとして使用できます。 |
| datarobot-user-modelsリポジトリ | DataRobotでカスタムモデル、カスタムタスク、カスタムノートブック環境を構築、デバッグ、テスト、実行するためのツール、テンプレート、情報です。 カスタムモデルのインフラストラクチャは、エージェントワークフローの基盤です。 |
| カスタムモデル構築のドキュメント | カスタムモデルの構築、テスト、実行に関するドキュメント。 |
| ワークショップのドキュメント | DataRobot UIを使用して、モデルアーティファクトをアップロードし、カスタムモデルを作成、テスト、および一元化されたモデル管理・デプロイハブであるコンソールにデプロイするためのドキュメント。 |

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

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

### Codespace

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

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

**ワークフローの比較（ヘッダー）:**
[https://docs.datarobot.com/ja/docs/images/agentic-playground-open-codespace-1.png](https://docs.datarobot.com/ja/docs/images/agentic-playground-open-codespace-1.png)

**ワークフローの比較（サイドバー）:**
[https://docs.datarobot.com/ja/docs/images/agentic-playground-open-codespace-2.png](https://docs.datarobot.com/ja/docs/images/agentic-playground-open-codespace-2.png)

**単一モデルのチャット:**
[https://docs.datarobot.com/ja/docs/images/agentic-playground-open-codespace-3.png](https://docs.datarobot.com/ja/docs/images/agentic-playground-open-codespace-3.png)


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

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

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

### ワークショップ

Codespaceでエージェントのワークフローを変更するのと同様に、レジストリのワークショップでエージェントコードを直接変更することもできます。 詳しくは [ワークショップ](https://docs.datarobot.com/ja/docs/workbench/nxt-registry/nxt-model-workshop/index.html.md) のドキュメントをご覧ください。 ワークショップで [エージェントのワークフローへの変更内容](https://docs.datarobot.com/ja/docs/workbench/nxt-registry/nxt-model-workshop/nxt-create-custom-model.html.md#assemble-the-custom-model) を保存すると、新しいバージョンが作成され、プレイグラウンドに接続されているエージェントのワークフローに渡されます。

ワークショップからは、エージェントのプレイグラウンドでは利用できない [評価指標とモデレーションを設定する](https://docs.datarobot.com/ja/docs/workbench/nxt-registry/nxt-model-workshop/nxt-configure-evaluation-moderation.html.md) こともできます。