用途:管理 Arize 中存储 LLM 提供商凭据的 AI 集成,供评测器调用裁判模型,以及其他需要代表用户调用 LLM 的功能使用。
主要能力:列出、查看、创建、部分更新和删除集成;支持按名称过滤、游标分页与 JSON 输出;支持多种提供商(OPEN_AI、ANTHROPIC、AZURE_OPEN_AI、AWS_BEDROCK、VERTEX_AI、GEMINI、NVIDIA_NIM、CUSTOM、LITELLM、FIREWORKS、TOGETHER_AI);可设置允许的模型、默认模型、函数调用、认证类型(DEFAULT、PROXY_WITH_HEADERS、BEARER_TOKEN、OAUTH2_CLIENT_CREDENTIALS)、自定义请求头与提供商元数据;通过 --scopings 控制哪些空间可用。
使用方式:常用命令包括 ax ai-integrations list --space SPACE、ax ai-integrations get NAME_OR_ID、ax ai-integrations create、ax ai-integrations update NAME_OR_ID、ax ai-integrations delete NAME_OR_ID --force。create 不接受 --space(集成是账户级),其余命令在使用名称时需加 --space。创建时除 LiteLLM、Fireworks、Together AI 外,每个提供商都需提供模型来源:--enable-default-models 或至少一个 --model-name,否则返回 400。Bedrock 和 Vertex 用 --provider-metadata 而非 --api-key。创建后应记录返回的集成 ID(如 TGxtSW50ZWdyYXRpb246MTI6YUJjRA==)供下游使用。
限制与安全:不要读取 .env 或搜索文件系统查找凭据;不要把密钥粘贴到聊天中,应让用户在自己的终端导出提供商密钥后运行命令。删除是永久操作,引用该集成的评测器将无法运行。若集成已存在,应先列出再创建。错误排查包括命令未找到(参考 ax-setup.md)、401、无配置文件、集成未找到、has_api_key 为 false 等。相关技能:arize-evaluator、arize-experiment。