用途:在 Arize 中管理 AI 集成,即存储 LLM 提供商凭证,供评估器调用裁判模型等场景使用。AI 集成是账户级资源,创建时不接受 --space,仅 list、get、update、delete 支持 --space(可填空间名或 base64 空间 ID)。
主要能力:列出、查看、创建、更新、删除集成;配置模型白名单、默认模型、函数调用、认证类型(default、proxy_with_headers、bearer_token)及提供商元数据。创建后需记录返回的 base64 集成 ID,用于评估器等下游操作。
常用命令: ax ai-integrations list --space SPACE ax ai-integrations get NAME_OR_ID ax ai-integrations create --name "My OpenAI Integration" --provider openAI --api-key $OPENAI_API_KEY ax ai-integrations update NAME_OR_ID --name "New Name" ax ai-integrations delete NAME_OR_ID --force 各提供商额外参数:azureOpenAI 需 --base-url;awsBedrock 需 --provider-metadata '{"role_arn": "<arn>"}';vertexAI 需 --provider-metadata '{"project_id": "<gcp-project>", "location": "<region>"}';nvidiaNim 需 --base-url;custom 需 --base-url。
限制:删除不可恢复,引用该集成的评估器将无法运行;创建后不能更改 provider,需删除重建;update 为部分更新,仅修改传入字段。凭证请通过 ax profiles 与 ax ai-integrations 管理,切勿读取 .env 文件或搜索文件系统查找凭证。