Goose

概述

Goose 是一个开源 AI 代理，专注于通过桌面应用、命令行界面（CLI）和 API 三种方式，帮助开发者自动化代码编写、工作流执行等任务。学完本教程，你将能够：

• 在本地部署 Goose 代理，并连接至你的代码仓库或工作流工具
• 通过 CLI 或 API 调用 Goose 执行代码生成、测试、部署等操作
• 在桌面应用中可视化监控代理执行状态，并手动干预任务

前置条件

• 操作系统：macOS 12+、Windows 10+ 或 Linux（Ubuntu 20.04+）
• 已安装 Python 3.8+ 或 Node.js 16+（用于 CLI 和 API 模式）
• 网络连接：需访问 GitHub 仓库以下载项目文件
• 可选：OpenAI API 密钥或其他 LLM 提供商密钥（若使用外部模型）

安装与配置

1. 下载 Goose 项目

打开终端，执行以下命令克隆仓库：

git clone https://github.com/your-org/goose.git
cd goose

预期结果：本地 goose 目录下出现 README.md、src/、config/ 等文件。

2. 安装依赖

根据你的使用场景选择安装方式：

• 桌面应用：下载对应操作系统的安装包（位于 dist/ 目录下），双击运行安装。
• CLI 模式：运行 pip install -r requirements.txt（Python）或 npm install（Node.js）。
• API 模式：运行 pip install goose-api（Python 包）或 npm install goose-api（Node.js 包）。

注意事项：若使用 Python 虚拟环境，请先激活虚拟环境再安装。

3. 配置 LLM 连接

编辑 config.yaml 文件（位于项目根目录），设置模型提供商：

llm:
  provider: openai
  api_key: "your-api-key-here"
  model: "gpt-4"

• 若使用本地模型（如 Llama），将 provider 改为 local，并指定模型路径。
• 若不配置 API 密钥，Goose 将使用默认的轻量模型（功能受限）。

使用 Goose 执行任务

桌面应用模式

1. 启动 Goose 桌面应用（双击图标）。
2. 在主界面点击「新建任务」。
3. 输入任务描述，例如：「生成一个 Python 脚本，读取 CSV 文件并计算每列平均值」。
4. 点击「开始执行」，应用将自动调用 LLM 生成代码并执行。
5. 在右侧面板查看执行日志和结果。

预期结果：任务完成后，左侧显示生成的代码，右侧显示执行输出。

CLI 模式

1. 打开终端，确保已进入项目目录。
2. 运行命令：

goose run "为当前目录下的所有 .py 文件添加类型注解"

• 可选参数：--model gpt-4 指定模型，--verbose 显示详细日志。
• 执行过程中，终端会实时显示每一步的推理和操作。

预期结果：终端输出「已修改 3 个文件」，并在对应文件中添加类型注解。

API 模式

1. 启动 API 服务：

goose serve --port 8080

2. 发送 POST 请求：

curl -X POST http://localhost:8080/run \
  -H "Content-Type: application/json" \
  -d '{"task": "重构 src/utils.py 中的函数，使其符合 PEP 8 规范"}'

预期结果：API 返回 JSON，包含 status: "completed" 和 result: "已修改 utils.py"。

常见问题与排查

适用边界

• Goose 适用于单次任务或低复杂度的工作流（如代码生成、文件修改、测试运行）。
• 不适用于需要持久化状态或长时间运行的任务（如实时监控、持续部署流水线）。
• 若任务涉及敏感数据（如数据库密码），建议在任务描述中使用占位符，并手动替换。