用途 该技能用于把某个应用程序的模型调用配置为经由 Pydantic AI Gateway 路由，并处理随之相关的提供商路由与 Gateway 凭据。它面向应用级集成，不用于观察或路由 Claude Code/Codex 这类编码智能体本身；编码会话记录与提供商设置应使用其他流程。它也与 logfire-instrumentation 分开：Logfire 写入令牌用于发送遥测，Gateway 密钥用于授权模型请求，二者不能互相替代。它不配置编码智能体提供商、遥测或 MCP 集成。
主要能力
- 识别应用：在修改文件前检查仓库，定位现有模型客户端、模型、提供商、环境变量加载方式和可运行入口；若请求已指明应用或仓库存在明确的推理客户端，则沿用其提供商协议与模型。
- 凭据处理：复用仓库既有密钥机制中的 Gateway 凭据，或通过 UI 的 Connect 流程/CLI 凭据流程获取项目级 Gateway 密钥；不打印一次性密钥，不把密钥写入源码、日志、测试或快照，不提交到版本控制。
- 配置应用：优先保留已有客户端与依赖版本。Pydantic AI 使用 gateway 模型形式（如 gateway/openai:gpt-5.2），并同时设置 PYDANTIC_AI_GATEWAY_BASE_URL 与 PYDANTIC_AI_GATEWAY_API_KEY；OpenAI 兼容客户端使用 Connect 提供的精确 Gateway 基础 URL 与路由；Anthropic、Google 等原生客户端使用对应提供商的 Gateway 片段，不跨协议翻译。
- 验证单次请求：使用不含敏感数据的小型合成载荷走选定路由，检查响应与应用错误处理；如有可读能力的 Logfire 登录，可查询该项目确认 Gateway 侧到达情况，否则标记为未验证。最后运行项目的格式化、类型检查、构建与针对性测试，并报告提供商、路由、模型、端点类别、凭据变量与请求结果。
使用方式 该技能以技能文档形式提供操作指南，用户可在智能体会话中按其步骤执行：先检查仓库并确认目标应用，再复用或获取 Gateway 密钥并存入环境变量，然后做最小改动完成客户端配置，最后发送一次真实请求验证并运行项目检查。若已有准备好的设置交接（已确定项目与凭据），应直接复用，不重复认证或重新选择项目。
适用场景 适用于已有推理客户端、希望将模型流量统一经 Gateway 路由的应用；需要配置或复用 Gateway 凭据、但不想暴露密钥的场景；以及需要在配置后做一次有界真实请求验证的集成工作。
限制 需用户确认项目、区域、提供商与现有凭据机制；创建密钥不会激活 Gateway、配置提供商计费或选择路由端点；公共 API 因 Gateway 未激活或权限不足拒绝创建时，需处理对应前置条件；缺失 OAuth 范围需重新授权；启用付费提供商访问需用户同意；自托管源与托管区域不同，需使用确认的 Gateway 资源与路由；文档中的提供商路径不保证该组织已启用。若无法安全更新密钥机制，应请用户通过其常规密钥管理器安装。