Skip to content

インストール

DataRobot Agentic Workflow Templatesリポジトリには、マルチエージェントフレームワークでのAIエージェントの構築およびデプロイのための、すぐに使えるテンプレートが用意されています。 これらのテンプレートは、最小限の構成要件で独自のエージェントをセットアップするプロセスを合理化し、ローカルでの開発とテスト、およびDataRobot内の本番環境へのデプロイの両方をサポートします。

task start(quickstart.py)を実行する前に、以下のインストールとセットアップの手順を実行することができます。

System requirements

ご利用のシステムがDataRobot Agent Templatesを実行するための最小要件を満たしていることを確認します。

  • オペレーティングシステム:macOSまたはLinux(Windows はサポートされていません)
  • Python:バージョン3.10以上

Operating system compatibility

This repository is only compatible with macOS and Linux operating systems. If you are using Windows, consider using a DataRobot Codespace, Windows Subsystem for Linux (WSL), or a virtual machine running a supported OS.

Required tools

Before running any agentic workflow commands, you must have the following tools installed system-wide (not in a virtual environment) so they are always available in your terminal session.

ツール バージョン 説明
git >= 2.30.0 バージョン管理システム。
uv >= 0.6.10 高速Pythonパッケージインストールマネージャー。
Pulumi >= 3.163.0 一般的なプログラミング言語でクラウドインフラストラクチャを定義および管理するためのインフラストラクチャ・アズ・コードツール。
Taskfile >= 3.43.3 タスクランナーおよびビルドツール。

Build tools required

You will also need a compatible C++ compiler and associated build tools installed on your system to compile some Python packages. The required tools vary depending on your operating system. For specific setup details, refer to the OS-specific installation instructions below.

インストール方法

OSごとのインストール手順に従って、必要なツールをすべてインストールします。

macOS

Homebrewパッケージマネージャーを使ってインストールします。

brew install git uv pulumi go-task/tap/go-task
xcode-select --install 

Linux

パッケージマネージャーと公式のインストールスクリプトを使ってインストールします。

Install tools using apt package manager.

sudo apt-get update && sudo apt-get install git build-essential
curl -LsSf https://astral.sh/uv/install.sh | sh
curl -fsSL https://get.pulumi.com/ | sh
curl -sL https://taskfile.dev/install.sh | sh 

Install tools using dnf package manager.

sudo dnf install git
sudo dnf groupinstall "Development Tools"
curl -LsSf https://astral.sh/uv/install.sh | sh
curl -fsSL https://get.pulumi.com/ | sh
curl -sL https://taskfile.dev/install.sh | sh 

Install tools using yum package manager.

sudo yum install git
sudo yum groupinstall "Development Tools"
curl -LsSf https://astral.sh/uv/install.sh | sh
curl -fsSL https://get.pulumi.com/ | sh
curl -sL https://taskfile.dev/install.sh | sh 

環境を設定する

リポジトリと資格情報を指定して開発環境を設定します。

リポジトリのクローンを作成する

エージェントのワークフローをローカルで開発する場合の最初の手順は、DataRobotのエージェントテンプレートリポジトリのクローンを作成することです。

Download the repository

または、リポジトリをZIPファイルとしてダウンロードし、任意の場所に解凍することもできます。

You can either clone the repository to your local machine using Git or download it as a ZIP file.

git clone https://github.com/datarobot-community/datarobot-agent-templates.git
cd datarobot-agent-templates 

Clone the release branch for your installation using Git:

git clone -b release/11.3 https://github.com/datarobot-community/datarobot-agent-templates.git
cd datarobot-agent-templates 

Customizing workflows

To customize or track your own workflows, you can fork this repository, change the remote URL, or create a new repository.

環境変数の設定

ローカル環境ファイルにDataRobot APIの資格情報を設定します。 ルートディレクトリに.envファイルを作成します。

nano .env  # or vim .env, code .env, etc. 

Alternatively, copy and rename the sample environment file (.env.template) and provide the necessary environment variables in the file.

cp .env.template .env  
# Previously, .env.template was .env.sample 

In the .env file, add the required environment variables:

CodespacesでのDataRobotの資格情報

DataRobotのCodespaceを使用している場合は、ファイルからDATAROBOT_API_TOKENおよびDATAROBOT_ENDPOINT環境変数を削除します。これらはCodespace環境にすでに存在しているためです。

.env
1
2
3
4
5
# Refer to https://docs.datarobot.com/en/docs/api/api-quickstart/index.html#create-a-datarobot-api-key
# and https://docs.datarobot.com/en/docs/api/api-quickstart/index.html#retrieve-the-api-endpoint
# Can be deleted in a DataRobot codespace
DATAROBOT_API_TOKEN=<DATAROBOT_API_TOKEN>
DATAROBOT_ENDPOINT=<DATAROBOT_ENDPOINT> 
環境変数 説明
DATAROBOT_API_TOKEN Generate from the DataRobot UI.
DATAROBOT_ENDPOINT
  • Cloud users: https://app.datarobot.com/api/v2, https://app.eu.datarobot.com/api/v2, or https://app.jp.datarobot.com/api/v2.
  • On-premise users: Use your environment's endpoint.

制限のあるネットワークの設定

インターネットに直接アクセスできない環境(エアギャップ環境)では、GitHubではなく内部プロキシからDataRobotプラグインをインストールするようにPulumiを設定します。 これらの環境変数を設定すると、すべてのPulumiプラグインのダウンロードが内部プロキシにリダイレクトされ、外部の更新チェックが無効になります。

以下の変数を.envファイルに追加します。

.env
PULUMI_SKIP_UPDATE_CHECK=1
PULUMI_DATAROBOT_DEFAULT_URL=http://internal-proxy-for-pulumi
# OPTIONAL
PULUMI_DATAROBOT_PLUGIN_VERSION=v0.10.27 
環境変数 必須 説明
PULUMI_SKIP_UPDATE_CHECK はい 1に設定すると、エアギャップモードが有効になります。 これにより、外部の更新チェックが無効になり、カスタムプラグインサーバーの使用が可能になります。
PULUMI_DATAROBOT_DEFAULT_URL はい DataRobot Pulumiプラグインをホストする内部プロキシサーバーのベースURL。 これにより、デフォルトのGitHubリリースソースが置き換えられます。
PULUMI_DATAROBOT_PLUGIN_VERSION いいえ インストールするDataRobot Pulumiプラグインの特定のバージョン。 指定しない場合、テンプレートにバンドルされているバージョンがデフォルトとなります。

仕組み

PULUMI_SKIP_UPDATE_CHECK=1が設定されている場合、デプロイタスクはpulumi plugin install resource datarobot <version> --server <url>を実行します。 これにより、プラグインのダウンロードが外部ソースではなく内部プロキシ経由でルーティングされるようになります。

内部プロキシの要件

内部プロキシは、Pulumiのプラグインインストールと互換性のある構造でDataRobot Pulumiプラグインファイルをホストする必要があります。 GitHubの公式リリースのディレクトリおよびファイルの構造を反映したものでなければなりません。

Pythonパッケージ

制限のあるネットワーク環境では、パブリックPyPIにアクセスしようとすると、uv sync操作が失敗します。 これを解決するには、uvが内部のPyPIプロキシを使うように設定します。

プロキシを設定するには、エージェントプロジェクトのagent/pyproject.tomlファイルを編集し、[tool.uv.pip]セクションのコメントを解除して、URLを内部PyPIプロキシに置き換えます。 例:

agent/pyproject.toml
[tool.uv.pip]
extra-index-url = ["https://your-internal-pypi-proxy.example.com/simple/"] 

設定による影響

この設定を行うと、すべてのPythonパッケージのインストールがプロキシ経由でルーティングされます。 対象となるのは以下の操作です。

  • ローカル開発(uv sync
  • Dockerイメージのビルド
  • カスタムモデルのデプロイ
  • プレイグラウンドの操作
  • インフラストラクチャのデプロイ

設定を見つける

[tool.uv.pip]セクションはpyproject.tomlファイルの最後にあります。 存在しない場合は、手動で追加します。