# インストール

> インストール - エージェントワークフローの開発に必要なコンポーネントをインストールします。

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.563475+00:00` (UTC).

## Primary page

- [インストール](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-install.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [システム要件](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-install.html.md#system-requirements): In-page section heading.
- [必須ツールのインストール](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-install.html.md#install-prerequisite-tools): In-page section heading.
- [詳細なインストールコマンド](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-install.html.md#_1): In-page section heading.
- [制限のあるネットワークの設定](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-install.html.md#restricted-network-setup): In-page section heading.
- [Pythonパッケージ](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-install.html.md#restricted-network-python-packages): In-page section heading.

## Documentation content

[Agentic Starterのテンプレートリポジトリ](https://github.com/datarobot-community/datarobot-agent-application) は、マルチエージェントフレームワーク、FastAPIバックエンドサーバー、Reactフロントエンド、およびMCPサーバーを使用してエージェントワークフローを構築およびデプロイするための、すぐに使用可能なアプリケーションテンプレートを提供します。
このテンプレートは、最小限の設定要件で新しいエージェントアプリケーションをセットアップするプロセスを合理化し、ローカルでの開発とテストに加えて、DataRobot内の本番環境へのワンコマンドデプロイをサポートします。

必須ツールをインストールし、環境を設定するには、以下のセクションを確認してください。

## システム要件

ご利用のシステムがAgentic Starterのテンプレートを実行するための最小要件を満たしていることを確認します。

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

> [!WARNING] オペレーティングシステムの互換性
> このリポジトリは、macOSおよびLinuxオペレーティングシステムとのみ互換性があります。 Windowsを使用している場合は、 [DataRobot codespace](https://docs.datarobot.com/ja/docs/workbench/wb-notebook/codespaces/index.html.md) 、 [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) 、またはサポート対象のOSを実行する仮想マシンの使用を検討してください。

## 必須ツールのインストール

開始する前に、以下のツールをインストールしておく必要があります。
これらのツールがすでにインストールされている場合は、下の表に示されている必要なバージョン（またはそれ以降）であることを確認してください。
ツールをインストールするコマンドの例については、 [詳細なインストールコマンド](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-install.html.md#detailed-installation-commands) セクションを参照してください。

> [!TIP] ツールをシステム全体にインストールする
> ツールは、仮想環境ではなく、ターミナルセッションで利用できるように、必ず システム全体に インストールしてください。

| ツール | バージョン | 説明 | Installation guide |
| --- | --- | --- | --- |
| dr-cli | >= 0.2.55 | 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:**
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:**
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 
```


> [!NOTE] ローカルPulumiログイン
> Pulumiアカウントをお持ちでない場合は、 `pulumi login --local` を使用してローカルログインするか、 [PulumiのWebサイト](https://app.pulumi.com/signup) で無料アカウントを作成してください。

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

インターネットに直接アクセスできない環境（エアギャップ環境）では、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プラグインの特定のバージョン。 指定しない場合、テンプレートにバンドルされているバージョンがデフォルトとなります。 |

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

> [!NOTE] 内部プロキシの要件
> 内部プロキシは、Pulumiのプラグインインストールと互換性のある構造でDataRobot Pulumiプラグインファイルをホストする必要があります。 [GitHubの公式リリース](https://github.com/datarobot-community/pulumi-datarobot/releases) のディレクトリおよびファイルの構造を反映したものでなければなりません。

#### 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/"] 
```

> [!NOTE] 設定による影響
> この設定を行うと、すべてのPythonパッケージのインストールがプロキシ経由でルーティングされます。 対象となるのは以下の操作です。
> 
> ローカル開発（
> uv sync
> ）
> Dockerイメージのビルド
> カスタムモデルのデプロイ
> プレイグラウンドの操作
> インフラストラクチャのデプロイ

> [!TIP] 設定を見つける
> `[tool.uv.pip]` セクションは `pyproject.toml` ファイルの最後にあります。 存在しない場合は、手動で追加します。