Piに接続
Unity Gatewayを介して、モデルおよびスキルとともにPiを使用します。Unity Gateway CLI（ug）がワークスペースのサインインと構成を処理します。または、接続を手動で構成することもできます。Piには組み込みのMCPクライアントがないため、MCPツールには個別のPi拡張機能が必要です。
始める前に
You need your Databricks ワークスペース URL and access to the models and skills you want to use.For manual setup, install Pi and have a Databricks personal access token.
手動で構成するには、<workspace-hostname> を Databricks ワークスペースのホスト名に置き換え、<databricks-pat> をトークンに置き換えます。ワークスペースで使用可能な完全なモデル名を使用し、関連のない設定を維持しながら、構成エントリを既存のファイルにMergeします。
管理者によってデバイスがすでに構成されている場合は、組織の設定手順に従ってください。
Unity Gateway CLIを使用する
ugをインストールし、プロジェクトディレクトリからこのコマンドを実行します：
ug pi
メッセージが表示されたら、ワークスペースを選択してサインインします。コマンドにより、ゲートウェイモデルが構成された Pi が開きます。コーディングを起動するか、/model を入力して別の構成済みモデルを選択します。
モデルを手動で構成する
Piをインストールし、この設定を~/.pi/agent/models.jsonにMergeします：
{
"providers": {
"databricks-claude": {
"baseUrl": "https://<workspace-hostname>/ai-gateway/anthropic",
"api": "anthropic-messages",
"apiKey": "<databricks-pat>",
"authHeader": true,
"compat": {
"supportsEagerToolInputStreaming": false
},
"models": [{ "id": "system.ai.claude-sonnet-4-6" }]
}
}
}
/modelを使用してpiを起動し、モデルを選択します。ゲートウェイを経由するClaudeモデルに対してsupportsEagerToolInputStreaming: falseを維持します。
その他のモデルファミリーの場合は、対応するAPIとベースURLを持つプロバイダーを追加します。同じapiKeyおよびauthHeaderフィールドを使用して、利用可能なモデルIDを一覧表示します。
モデル |
|
|
|---|---|---|
GPT |
|
|
Gemini |
|
|
Piのモデル構成ドキュメントを参照してください。
スキルを追加
Unity Gateway CLIを使用する
公開されたスキルのdownload：
ug skills add
スキルを選択してから、Piを再起動します。~/.agents/skills/からダウンロードを読み取ります。Piにスキルを使用するか、SKILL.mdにある名前を使用して/skill:<name>を呼び出すように依頼します。
スキルを手動で構成する
すでに所有しているファイルの場合は、各完了したスキルフォルダを ~/.agents/skills/ またはプロジェクトの .pi/skills/ に配置します。Pi のスキルに関するドキュメントを参照してください。
MCP support
Piには組み込みのMCPクライアントがなく、ug mcp addはPiをサポートしていません。downloadしたスキルを使用してください。MCPサービスとスキルレジストリには、個別のPi拡張機能が必要です。Piの拡張機能のドキュメントを参照してください。
Unity Gatewayのスキルはベータ版です。有効化とアクセス許可については、スキルのガバナンスを参照してください。
トラブルシューティング
モデルリクエストが失敗した場合: ゲートウェイのURL、トークンの有効期限、モデル名、および権限を確認してください。
A downloaded skill is missing: Check that its complete folder contains SKILL.md in a supported directory.Re-ラン ug skills add with the same options to 更新 downloaded skills.
ワークスペースのサインインまたはugの設定に問題がある場合は、ug doctorを実行してください。