第二部分,模型与 Providers

Azure、Bedrock、Vertex 与 Cloudflare

配置企业云 Provider 的端点、区域、账号和网关,并保持最小权限与可审计性。

云 Provider 的额外变量

Azure OpenAI 需要资源端点和对应密钥,Amazon Bedrock 依赖 AWS 身份与区域,Vertex AI 依赖 Google Cloud 项目和凭据,Cloudflare Provider 还需要账号和 Gateway 标识。

这些配置不仅决定模型可用性,也决定数据经过的地域和组织边界。生产部署前应由云管理员确认权限与审计。

  • 使用工作负载身份或短期凭据。
  • 限制可调用模型和区域。
  • 通过企业网关统一记录请求。
  • 不要给编码代理完整云管理员权限。
  • 明确故障时的 Provider 回退策略。

连接验证

先用 --list-models 确认目录,再运行只读小任务。区分身份失败、模型未部署、区域不支持和网关兼容问题。

自定义代理端点应在 models.json 中声明正确 API 类型,而不是假设所有网关都完全兼容 OpenAI。

官方资料

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁,命令、包名和接口以官方最新文档为准。

Pi 源代码和官方文档采用 MIT License。Copyright (c) 2025 Mario Zechner。本站保留原版权与许可声明,完整文本见 MIT License