arize-ai-provider-integration

Arize AI 統合スキル

SPACE — ほとんどの --space フラグと ARIZE_SPACE 環境変数には、スペースの名前（例：my-workspace）または base64 形式のスペースID（例：U3BhY2U6...）を指定できます。ax spaces list で確認できます。 注： ai-integrations create は --space を受け付けません。AI 統合はアカウント単位です。--space は list、get、update、delete でのみ使用してください。

概念

• AI 統合 = Arize に登録された、保存済みの LLM プロバイダー認証情報です。評価器が判定モデルを呼び出すため、およびユーザーに代わって LLM を呼び出す必要があるその他の Arize 機能で使用されます
• プロバイダー = 統合の基盤となる LLM サービスです（例：openAI、anthropic、awsBedrock）
• 統合 ID = 統合の base64 エンコードされたグローバル識別子です（例：TGxtSW50ZWdyYXRpb246MTI6YUJjRA==）。評価器の作成や、その他の後続操作に必要です
• スコープ設定 = 統合を使用できるスペースまたはユーザーを制御する可視性ルールです
• 認証タイプ = Arize がプロバイダーに対して認証する方法です。default（プロバイダー API キー）、proxy_with_headers（カスタムヘッダーを使用したプロキシ経由）、または bearer_token（ベアラートークン認証）があります

前提条件

タスクにそのまま進み、必要な ax コマンドを実行してください。事前にバージョン、環境変数、プロファイルを確認しないでください。

ax コマンドが失敗した場合は、エラーに応じてトラブルシューティングしてください。

• command not found またはバージョンエラー → references/ax-setup.md を参照してください
• 401 Unauthorized / API キーがない → ax profiles show を実行して現在のプロファイルを確認してください。プロファイルがない場合や API キーが間違っている場合は、references/ax-profiles.md に従って作成または更新してください。ユーザーがキーを持っていない場合は、https://app.arize.com/admin > API Keys に案内してください
• スペースが不明 → ax spaces list を実行して名前から選ぶか、ユーザーに確認してください
• LLM プロバイダーの呼び出しに失敗（OPENAI_API_KEY / ANTHROPIC_API_KEY がない）→ ax ai-integrations list --space SPACE を実行して、プラットフォーム管理の認証情報があるか確認してください。存在しない場合は、ユーザーにキーの提供を依頼するか、arize-ai-provider-integration スキルを使用して統合を作成してください
• セキュリティ： .env ファイルを読み込んだり、ファイルシステムを検索して認証情報を探したりしないでください。Arize の認証情報には ax profiles を、LLM プロバイダーのキーには ax ai-integrations を使用してください。これらの方法で認証情報を取得できない場合は、ユーザーに確認してください。

---

AI 統合の一覧表示

スペースでアクセス可能なすべての統合を一覧表示します。

ax ai-integrations list --space SPACE

名前でフィルタリングします（大文字と小文字を区別しない部分一致）。

ax ai-integrations list --space SPACE --name "openai"

件数の多い結果をページ分割します。

# Get first page
ax ai-integrations list --space SPACE --limit 20 -o json

# Get next page using cursor from previous response
ax ai-integrations list --space SPACE --limit 20 --cursor CURSOR_TOKEN -o json

主なフラグ：

フラグ	説明
--space	統合を絞り込むスペース名または ID
--name	統合名に対する、大文字と小文字を区別しない部分一致フィルター
--limit	最大結果数（1～100、デフォルトは 15）
--cursor	前回の応答から取得したページネーショントークン
-o, --output	出力形式：table（デフォルト）または json

応答フィールド：

フィールド	説明
id	base64 形式の統合 ID — 後続のコマンドで使用するためにコピーしてください
name	人が読める名前
provider	LLM プロバイダーの列挙値（下記の「サポート対象プロバイダー」を参照）
has_api_key	認証情報が保存されている場合は true
model_names	許可されたモデルのリスト。すべてのモデルが有効な場合は null
enable_default_models	このプロバイダーのデフォルトモデルが許可されているかどうか
function_calling_enabled	ツール／関数呼び出しが有効かどうか
auth_type	認証方式：default、proxy_with_headers、または bearer_token

---

特定の統合を取得する

ax ai-integrations get NAME_OR_ID
ax ai-integrations get NAME_OR_ID -o json
ax ai-integrations get NAME_OR_ID --space SPACE   # required when using name instead of ID

統合の完全な設定を確認する場合や、作成後に ID を確認する場合に使用します。

---

AI 統合を作成する

作成する前に、必ず統合を一覧表示してください。ユーザーに適した統合がすでにある可能性があります。

ax ai-integrations list --space SPACE

適した統合がない場合は、新しく作成してください。必須のフラグはプロバイダーによって異なります。

OpenAI

ax ai-integrations create \
  --name "My OpenAI Integration" \
  --provider openAI \
  --api-key $OPENAI_API_KEY

Anthropic

ax ai-integrations create \
  --name "My Anthropic Integration" \
  --provider anthropic \
  --api-key $ANTHROPIC_API_KEY

Azure OpenAI

ax ai-integrations create \
  --name "My Azure OpenAI Integration" \
  --provider azureOpenAI \
  --api-key $AZURE_OPENAI_API_KEY \
  --base-url "https://my-resource.openai.azure.com/"

AWS Bedrock

AWS Bedrock は IAM ロールベースの認証を使用します。--provider-metadata で、Arize が引き受けるロールの ARN を指定してください。

ax ai-integrations create \
  --name "My Bedrock Integration" \
  --provider awsBedrock \
  --provider-metadata '{"role_arn": "arn:aws:iam::123456789012:role/ArizeBedrockRole"}'

Vertex AI

Vertex AI は GCP サービスアカウントの認証情報を使用します。--provider-metadata で GCP のプロジェクトとリージョンを指定してください。

ax ai-integrations create \
  --name "My Vertex AI Integration" \
  --provider vertexAI \
  --provider-metadata '{"project_id": "my-gcp-project", "location": "us-central1"}'

Gemini

ax ai-integrations create \
  --name "My Gemini Integration" \
  --provider gemini \
  --api-key $GEMINI_API_KEY

NVIDIA NIM

ax ai-integrations create \
  --name "My NVIDIA NIM Integration" \
  --provider nvidiaNim \
  --api-key $NVIDIA_API_KEY \
  --base-url "https://integrate.api.nvidia.com/v1"

カスタム（OpenAI 互換エンドポイント）

ax ai-integrations create \
  --name "My Custom Integration" \
  --provider custom \
  --base-url "https://my-llm-proxy.example.com/v1" \
  --api-key $CUSTOM_LLM_API_KEY

サポートされているプロバイダー

プロバイダー	必須の追加フラグ
openAI	--api-key <key>
anthropic	--api-key <key>
azureOpenAI	--api-key <key>, --base-url <azure-endpoint>
awsBedrock	--provider-metadata '{"role_arn": "<arn>"}'
vertexAI	--provider-metadata '{"project_id": "<gcp-project>", "location": "<region>"}'
gemini	--api-key <key>
nvidiaNim	--api-key <key>, --base-url <nim-endpoint>
custom	--base-url <endpoint>

すべてのプロバイダーで使えるオプションのフラグ

フラグ	説明
--model-name	許可するモデル名（複数指定する場合は繰り返します。例：--model-name gpt-4o --model-name gpt-4o-mini）。省略すると、すべてのモデルが許可されます
--enable-default-models	プロバイダーのデフォルトモデルリストを有効にします
--function-calling-enabled	ツール／関数呼び出しのサポートを有効にします
--auth-type	認証タイプ：default、proxy_with_headers、または bearer_token
--headers	JSON オブジェクトまたはファイルパスでカスタムヘッダーを指定します（プロキシ認証用）
--provider-metadata	プロバイダー固有のメタデータを JSON オブジェクトまたはファイルパスで指定します

作成後

返されたインテグレーション ID（例：TGxtSW50ZWdyYXRpb246MTI6YUJjRA==）を保存してください。評価器の作成やその他の後続コマンドで必要になります。見失った場合は、次のコマンドで取得できます。

ax ai-integrations list --space SPACE -o json
# or by name/ID directly:
ax ai-integrations get NAME_OR_ID

---

AI インテグレーションを更新する

update は部分更新です。指定したフラグのみが変更され、省略したフィールドはそのまま保持されます。

# Rename
ax ai-integrations update NAME_OR_ID --name "New Name"

# Rotate the API key
ax ai-integrations update NAME_OR_ID --api-key $OPENAI_API_KEY

# Change the model list (replaces all existing model names)
ax ai-integrations update NAME_OR_ID --model-name gpt-4o --model-name gpt-4o-mini

# Update base URL (for Azure, custom, or NIM)
ax ai-integrations update NAME_OR_ID --base-url "https://new-endpoint.example.com/v1"

ID の代わりに名前を使用する場合は、--space SPACE を追加してください。create で受け付けられるフラグは、どれも update に渡せます。

---

AI インテグレーションを削除する

**警告：**削除すると元に戻せません。このインテグレーションを参照する評価器は、実行できなくなります。

ax ai-integrations delete NAME_OR_ID --force
ax ai-integrations delete NAME_OR_ID --space SPACE --force   # required when using name instead of ID

すぐに削除せず確認プロンプトを表示するには、--force を省略してください。

---

トラブルシューティング

問題	解決方法
ax: command not found	references/ax-setup.md を参照してください
401 Unauthorized	API キーにこのスペースへのアクセス権がない可能性があります。https://app.arize.com/admin > API Keys でキーとスペース ID を確認してください
No profile found	ax profiles show --expand を実行してください。ARIZE_API_KEY 環境変数を設定するか、~/.arize/config.toml に書き込んでください
Integration not found	ax ai-integrations list --space SPACE で確認してください
作成後に has_api_key: false と表示される	認証情報が保存されていません。正しい --api-key または --provider-metadata を指定して、update を再実行してください
評価器の実行が LLM エラーで失敗する	ax ai-integrations get INT_ID でインテグレーションの認証情報を確認してください。必要に応じて API キーをローテーションしてください
provider が一致しない	作成後にプロバイダーを変更することはできません。削除して、正しいプロバイダーで作成し直してください

---

関連スキル

• arize-evaluator：AI インテグレーションを使用する LLM-as-judge 評価器を作成します → arize-evaluator を使用
• arize-experiment：AI インテグレーションを利用する評価器で実験を実行します → arize-experiment を使用

---

認証情報を保存して今後も使用する

references/ax-profiles.md § 認証情報を保存して今後も使用する を参照してください。