インストール¶
The DataRobot Agentic Application Template repository provides a ready-to-use application template for building and deploying agentic workflows with multi-agent frameworks, a FastAPI backend server, a React frontend, and an MCP server. The template streamlines the process of setting up new agentic applications with minimal configuration requirements and supports local development and testing, as well as one-command deployments to production environments within DataRobot.
Review the following sections to install the prerequisite tools and configure your environment.
システム要件¶
Ensure your system meets the minimum requirements for running DataRobot Agentic Application Template.
- オペレーティングシステム:macOSまたはLinux(Windows はサポートされていません)
- Python:バージョン3.10以上
オペレーティングシステムの互換性
このリポジトリは、macOSおよびLinuxオペレーティングシステムとのみ互換性があります。 If you are using Windows, consider using a DataRobot codespace, Windows Subsystem for Linux (WSL), or a virtual machine running a supported OS.
Install prerequisite tools¶
Before you begin, you'll need the following tools installed. If you already have these tools installed, ensure that they are at the required version (or newer) indicated in the table below. For example commands to install the tools, see the Detailed installation commands section.
Install tools system-wide
Make sure to install the tools system-wide rather than in a virtual environment so they are available in your terminal sessions.
| ツール | バージョン | 説明 | Installation guide |
|---|---|---|---|
| dr-cli | >= 0.2.28 | The DataRobot CLI. | dr-cli installation guide |
| git | >= 2.30.0 | バージョン管理システム。 | git installation guide |
| uv | >= 0.9.0 | A Python package manager. | uv installation guide |
| Pulumi | >= 3.163.0 | An Infrastructure as Code tool. | Pulumi installation guide |
| Taskfile | >= 3.43.3 | A task runner. | Taskfile installation guide |
| NodeJS | >= 24 | JavaScript runtime for frontend development. | NodeJS installation guide |
Detailed installation commands¶
The following sections provide example installation commands for macOS and Linux (Debian/Ubuntu/DataRobot codespace). Click the tab below that corresponds to your operating system:
macOS users can install the prerequisite tools using Homebrew. First, install Homebrew if you don't already have it.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # If homebrew is not already installed
Then, install the prerequisite tools with it:
brew install datarobot-oss/taps/dr-cli uv pulumi/tap/pulumi go-task node git
Linux users can install the prerequisite tools using the package manager for their distribution.
curl https://cli.datarobot.com/install | sh
sudo apt-get update
sudo apt-get install -y python3 python3-pip python3-venv
sudo apt-get install -y git
curl -LsSf https://astral.sh/uv/install.sh | sh
curl -fsSL https://get.pulumi.com | sh
sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d
sudo apt-get install -y nodejs npm
Local Pulumi login
If you do not have a Pulumi account, use pulumi login --local for local login or create a free account at the Pulumi website.
制限のあるネットワークの設定¶
インターネットに直接アクセスできない環境(エアギャップ環境)では、GitHubではなく内部プロキシからDataRobotプラグインをインストールするようにPulumiを設定します。 これらの環境変数を設定すると、すべてのPulumiプラグインのダウンロードが内部プロキシにリダイレクトされ、外部の更新チェックが無効になります。
以下の変数を.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プロキシに置き換えます。 例:
[tool.uv.pip]
extra-index-url = ["https://your-internal-pypi-proxy.example.com/simple/"]
設定による影響
この設定を行うと、すべてのPythonパッケージのインストールがプロキシ経由でルーティングされます。 対象となるのは以下の操作です。
- ローカル開発(
uv sync) - Dockerイメージのビルド
- カスタムモデルのデプロイ
- プレイグラウンドの操作
- インフラストラクチャのデプロイ
設定を見つける
[tool.uv.pip]セクションはpyproject.tomlファイルの最後にあります。 存在しない場合は、手動で追加します。