Integuru

环境要求

• Python 环境（需配合 Poetry 使用）
• 已安装 Poetry 包管理工具
• OpenAI API Key，建议账号可访问不低于 o1-mini 能力的模型
• 可登录目标平台的浏览器环境
• 能访问 OpenAI 云服务的网络

安装与启动步骤

1. 1配置 API 密钥

   设置 OPENAI_API_KEY 环境变量，后续调用 OpenAI 模型时使用，密钥不要提交到公开仓库。

   export OPENAI_API_KEY=sk-xxxxxxxx

   复制

2. 2安装依赖

   在项目根目录用 poetry 安装 README 中要求的 Python 依赖，生成虚拟环境。

   poetry install

   复制

3. 3进入虚拟环境

   打开 poetry shell，后续命令也可不加 poetry run 直接在 shell 内执行。

   poetry shell

   复制

4. 4注册 Jupyter 内核

   把 Poetry 虚拟环境注册为名为 integuru 的 Jupyter 内核，方便用 main.ipynb 运行。

   poetry run ipython kernel install --user --name=integuru

   复制

5. 5抓取网络请求

   启动浏览器，登录目标平台并完成目标操作（如下载账单），生成 har 与 cookies 文件。

   poetry run python create_har.py

   复制

6. 6运行智能体

   传入描述动作的 prompt 和模型名，智能体分析请求并输出可运行的 Python 集成代码。

   poetry run integuru --prompt "download utility bills" --model gpt-4o --generate-code

   复制

7. 7查看可用参数

   不确定参数时先看帮助，可确认 har 路径、cookie 路径、最大步数等默认值。

   poetry run integuru --help

   复制

8. 8运行单元测试

   可选步骤，用 pytest 验证本地环境是否安装正确。

   poetry run pytest

   复制

关键配置

如何确认成功

运行 integuru 后输出生成的 Python 集成代码即成功；也可先执行 poetry run integuru --help 确认命令可用。

常见问题

注意事项

• 必须在浏览器中登录目标平台并真实执行一次目标操作，智能体才能拿到有效请求。
• 模型能力至少需与 OpenAI o1-mini 相当，官方更推荐 o1-preview 级别。
• 该仓库为公开的最早版本 Integuru v0，最新版本在 integuru.com 官网提供。
• 推荐在隔离的虚拟环境中运行，避免影响系统 Python 依赖。