Goose 接入指南
Goose 是一款由 Block（前 Square）开发的开源 AI Agent 客户端，适合通过自然语言完成代码生成、文件修改、命令执行和项目分析等开发任务。通过配置 OpenAI Compatible Provider，Goose 可以接入 Step 模型，并结合本地工具链完成常见开发工作流。
本文档介绍 Goose 接入 Step API 的准备条件、配置步骤与基础验证方法。
概述
Goose 支持通过 OpenAI Compatible API 接入第三方大模型。完成 Provider 配置后，可以在 Goose 中直接调用 Step 模型，执行对话问答、代码编辑和工具调用等任务。
通过配置自定义 Provider，Goose 可以调用 Step 模型实现以下能力：
- 自主任务执行：自动编辑文件、运行 Shell 命令。
- 代码库分析：理解项目结构并回答复杂编程问题。
- 自动化流程：结合本地工具链完成端到端开发任务。
前置条件
在开始之前，请确保满足以下条件。
安装 Goose
请先安装 Goose 命令行工具或桌面客户端。
订阅 Step Plan
在开始配置前，请先确认当前账号已完成 Step Plan 订阅。只有在账号具备对应计划或调用权限后，后续模型调用与额度使用才会正常生效。
如需订阅或购买，请访问：platform.stepfun.com/step-plan
获取 Step API Key
登录 StepFun 开放平台，获取用于身份认证的 API Key，并妥善保存。
确认接口信息
请提前确认以下连接信息：
- Base URL：
https://api.stepfun.com/step_plan/v1 - 协议类型：
OpenAI Compatible
配置步骤
进入配置界面
在 Goose 桌面端中，点击 Settings，选择 Providers，然后点击 Add Provider。
填写配置参数
在弹出的配置窗口中，按照以下信息填写：
- Provider Type：选择
OpenAI Compatible - Display Name：填写
StepFun - API URL：填写
https://api.stepfun.com/step_plan/v1 - API Key：粘贴你在 Step 平台获取的 Key
- Available Models：填写以下模型名称
step-3.5-flash完成配置后，Goose 即可通过该 Provider 调用 Step 模型。
测试接入
配置完成后，在 Goose 主对话窗口中切换到 StepFun Provider 下的任意模型，并通过以下示例进行验证。
基础对话测试
输入：
你好，你是谁？预期结果：返回由阶跃星辰（StepFun）提供的模型身份回复。
工具能力测试
输入：
请列出我当前目录下的所有文件。预期结果：Goose 会调用本地目录工具，并使用 Step 模型总结输出文件列表。
代码编辑测试
输入：
帮我创建一个名为 hello.py 的文件，内容是输出当前时间。预期结果：Goose 自动生成代码并将文件保存到本地磁盘。
常见问题
Tool 无法识别或连接超时
可能原因：当前网络环境无法直接访问 API 地址。
建议检查：
- 网络代理设置是否正确
- API URL 末尾是否误加了斜杠
模型列表为空
如果模型下拉列表未显示内容，请检查 Available Models 配置项是否已手动填入具体模型标识符，例如：
step-3.5-flash如果未填写具体模型名称，下拉菜单可能无法正常显示。
总结
通过 Goose 的 OpenAI Compatible 模式，开发者可以将 Step 模型的推理能力与 Goose 的本地工具链结合，用于执行代码生成、文件操作和项目分析等任务。
建议优先使用 step-3.5-flash 完成接入验证与日常开发任务。