インストール¶
Agentic Starterのテンプレートリポジトリは、マルチエージェントフレームワーク、FastAPIバックエンドサーバー、Reactフロントエンド、およびMCPサーバーを使用してエージェントワークフローを構築およびデプロイするための、すぐに使用可能なアプリケーションテンプレートを提供します。 このテンプレートは、最小限の設定要件で新しいエージェントアプリケーションをセットアップするプロセスを合理化し、ローカルでの開発とテストに加えて、DataRobot内の本番環境へのワンコマンドデプロイをサポートします。
必須ツールをインストールし、環境を設定するには、以下のセクションを確認してください。
システム要件¶
ご利用のシステムがAgentic Starterのテンプレートを実行するための最小要件を満たしていることを確認します。
- オペレーティングシステム: macOSまたはLinux(Windowsはサポートされていません)
- Python:バージョン3.10以上
オペレーティングシステムの互換性
このリポジトリは、macOSおよびLinuxオペレーティングシステムとのみ互換性があります。 Windowsを使用している場合は、DataRobot codespace、Windows Subsystem for Linux (WSL)、またはサポート対象のOSを実行する仮想マシンの使用を検討してください。
必須ツールのインストール¶
開始する前に、以下のツールをインストールしておく必要があります。 これらのツールがすでにインストールされている場合は、下の表に示されている必要なバージョン(またはそれ以降)であることを確認してください。 ツールをインストールするコマンドの例については、詳細なインストールコマンドセクションを参照してください。
ツールをシステム全体にインストールする
ツールは、仮想環境ではなく、ターミナルセッションで利用できるように、必ずシステム全体にインストールしてください。
| ツール | バージョン | 説明 | Installation guide |
|---|---|---|---|
| dr-cli | >= 0.2.28 | DataRobot CLI。 | DataRobot CLIの開始方法(インストールと設定)。GitHub dr-cli(別の方法) |
| git | >= 2.30.0 | バージョン管理システム。 | gitインストールガイド |
| uv | >= 0.9.0 | Pythonパッケージマネージャー。 | uvインストールガイド |
| Pulumi | >= 3.163.0 | インフラストラクチャ・アズ・コードツール。 | Pulumiインストールガイド |
| Taskfile | >= 3.43.3 | タスクランナー。 | Taskfileインストールガイド |
| NodeJS | >= 24 | フロントエンド開発用のJavaScriptランタイム。 | NodeJSインストールガイド |
詳細なインストールコマンド¶
以下のセクションでは、macOSおよびLinux(Debian/Ubuntu/DataRobot codespace)向けのインストールコマンドの例を紹介します。 ご使用のオペレーティングシステムに対応する下のタブをクリックしてください。
macOSユーザーは、Homebrewを使用して必須ツールをインストールできます。 Homebrewをまだインストールしていない場合は、まずインストールしてください。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # If homebrew is not already installed
次に、それを使用して必須ツールをインストールします。
brew install datarobot-oss/taps/dr-cli uv pulumi/tap/pulumi go-task node git
Linuxユーザーは、ディストリビューションのパッケージマネージャーを使用して、必須ツールをインストールできます。
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
ローカルPulumiログイン
Pulumiアカウントをお持ちでない場合は、pulumi login --localを使用してローカルログインするか、PulumiのWebサイトで無料アカウントを作成してください。
制限のあるネットワークの設定¶
インターネットに直接アクセスできない環境(エアギャップ環境)では、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ファイルの最後にあります。 存在しない場合は、手動で追加します。