OpenAI 配置

OpenAI 页面在这套手册里的作用，不是单独形成一套 SDK 教程，而是告诉你：如何把 OpenAI 放进 Agently 的统一请求层里。

适合什么时候读

• 你已经看过 模型设置总览
• 你决定先用 OpenAI 作为 provider
• 你想知道 OpenAI 在 Agently 里该怎么配置，而不是直接跳过到裸 SDK

你会学到什么

• OpenAI 的基础接入信息从哪里获取
• 如何通过 OpenAICompatible 统一接入
• 什么时候应该继续看更底层的接口兼容说明

官网与控制台

• 官网：https://openai.com/
• API Key：https://platform.openai.com/api-keys
• 模型列表：https://platform.openai.com/docs/models/overview

最小示例

from agently import Agently

Agently.set_settings(
    "OpenAICompatible",
    {
        "base_url": "https://api.openai.com/v1",
        "api_key": "YOUR_OPENAI_API_KEY",
        "model": "gpt-4o-mini",
    },
)

放到项目里时的推荐做法

与其把配置长期写死在代码里，更推荐放进 SETTINGS.yaml 或环境变量，再由设置层加载。

OpenAICompatible:
  base_url: https://api.openai.com/v1
  api_key: ${ENV.OPENAI_API_KEY}
  model: gpt-4o-mini

常见误区

• 把 provider 页面当成 Agently 的主入口，而不是请求层的一种具体配置。
• 刚接 OpenAI 就开始单独写一层 provider wrapper。
• 看到 OpenAI 的原始请求体字段后，忘了 Agently 还有自己的统一设置层。

下一步去哪

• 要理解统一配置层：回到 模型设置总览
• 要看 OpenAI 请求体和兼容细节：看 OpenAI 接口格式与请求规范
• 要继续进入请求开发主线：看 输出控制概览

Related Skills（可选）

• agently-model-setup