Arize AI インテグレーション スキル

SPACE — 多くの --space フラグと ARIZE_SPACE 環境変数は、スペースの名前 (例：my-workspace) または base64 スペースID (例：U3BhY2U6...) を受け入れます。ax spaces list で確認できます。 注記: ai-integrations create は --space を受け入れません — AI インテグレーションはアカウント範囲です。list、get、update、delete でのみ --space を使用してください。

概念

• AI インテグレーション = Arize に登録された保存済みの LLM プロバイダー認証情報。評価者がジャッジモデルを呼び出すときや、Arize の他の機能があなたに代わって LLM を実行する必要があるときに使用
• プロバイダー = インテグレーションの基盤となる 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"

大規模な結果セットをページネーション：

# 最初のページを取得
ax ai-integrations list --space SPACE --limit 20 -o json

# 前のレスポンスのカーソルを使用して次のページを取得
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   # 名前の代わりに 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 ロールベースの認証を使用します。Arize が想定すべきロールの ARN を --provider-metadata で指定してください：

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
# または名前/ID で直接：
ax ai-integrations get NAME_OR_ID

---

AI インテグレーションの更新

update は部分的な更新です — 提供したフラグのみが変更されます。省略されたフィールドはそのままです。

# 名前を変更
ax ai-integrations update NAME_OR_ID --name "New Name"

# API キーをローテーション
ax ai-integrations update NAME_OR_ID --api-key $OPENAI_API_KEY

# モデルリストを変更 (すべての既存モデル名を置き換え)
ax ai-integrations update NAME_OR_ID --model-name gpt-4o --model-name gpt-4o-mini

# ベース URL を更新 (Azure、カスタム、または 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   # 名前の代わりに 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: インテグレーションを使用する LLM-as-judge 評価者を作成 → arize-evaluator を使用
• arize-experiment: インテグレーションによってサポートされている評価者を使用する実験を実行 → arize-experiment を使用

---

将来の使用のために認証情報を保存

references/ax-profiles.md § Save Credentials for Future Use を参照。