Integuru v0

本仓库包含了我们公开发布的 Integuru Agent 的最早版本。它展示了最初的实现路径：通过浏览器网络请求，为没有官方 API 的平台生成可运行的集成代码。

自那时起我们一直在持续开发，最新版本的 Integuru 可在 www.integuru.com 访问。

Integuru v0 演示

Integuru in action

Integuru v0 的功能

你只需使用 create_har.py 生成一个包含所有浏览器网络请求的文件以及一个包含 Cookie 的文件，并编写一段描述浏览器中所触发操作的 Prompt。Agent 随后会输出可运行的 Python 代码，通过请求平台的内部端点来执行所需的操作。

工作原理

假设我们想要下载水电费账单：

Agent 首先识别出下载账单的网络请求。例如，请求 URL 可能如下所示：
```
https://www.example.com/utility-bills?accountId=123&userId=456
```
它会识别出该请求中依赖于其他请求的部分。上述 URL 包含动态部分（accountId 和 userId），这些部分需要从其他请求中获取。
```
accountId=123 userId=456
```
它会找到提供这些参数的请求，并将下载请求与它们建立依赖关系。它还会将这些请求关联到原始请求，从而构建出一个依赖图（dependency graph）。
```
GET https://www.example.com/get_account_id
GET https://www.example.com/get_user_id
```
此过程将持续重复，直到被检查的请求不再依赖于其他请求，且仅需要身份验证 Cookie 即可。
Agent 从图中没有出边的节点（请求）开始向上遍历，直到到达根节点，并将每个节点转换为可运行的函数。

特性

生成请求依赖图，以实现执行目标操作的最终请求。
支持输入变量（例如，选择下载文档的“年份”）。目前该功能仅支持图生成阶段，代码生成的输入变量功能即将推出！
生成能够访问图中所有请求的代码，以完成所需的操作。

安装设置

设置你的 OpenAI API Keys 并添加 OPENAI_API_KEY 环境变量。（我们建议使用能够访问至少与 OpenAI o1-mini 同等能力模型的账户。与 OpenAI o1-preview 相当的模型最为理想。）
通过 poetry 安装 Python 依赖：
```
poetry install
```
打开一个 poetry shell：
```
poetry shell
```

将 Poetry 虚拟环境注册到 Jupyter：

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

运行以下命令启动浏览器：
```
poetry run python create_har.py
```
登录你的目标平台并执行所需操作（例如下载水电费账单）。
运行 Integuru：
```
poetry run integuru --prompt "download utility bills" --model 
```
你也可以通过 Jupyter Notebook main.ipynb 来运行。

建议使用 gpt-4o 作为图生成的模型，因为它支持函数调用（function calling）。如果用户的 OpenAI 账户中可用，Integuru 会自动切换到 o1-preview 进行代码生成。

使用方法

配置完项目后，你可以使用 Integuru 来分析和逆向工程外部平台的 API 请求。只需提供相应的 .har 文件以及描述你想要触发的操作的 Prompt 即可。

poetry run integuru --help
Usage: integuru [OPTIONS]

Options:
  --model TEXT                    The LLM model to use (default is gpt-4o)
  --prompt TEXT                   The prompt for the model  [required]
  --har-path TEXT                 The HAR file path (default is
                                  ./network_requests.har)
  --cookie-path TEXT              The cookie file path (default is
                                  ./cookies.json)
  --max_steps INTEGER             The max_steps (default is 20)
  --input_variables ...
                                  Input variables in the format key value
  --generate-code                 Whether to generate the full integration
                                  code
  --help                          Show this message and exit.

运行单元测试

要使用 pytest 运行单元测试，请执行以下命令：

poetry run pytest

持续集成 (CI) 工作流

本仓库包含一个使用 GitHub Actions 的 CI 工作流。工作流定义在 .github/workflows/ci.yml 文件中，并会在每次推送到 main 分支或发起 Pull Request 时触发。工作流执行以下步骤：

检出代码。
配置 Python 3.12。
使用 poetry 安装依赖。
使用 pytest 运行测试。

关于 2FA 的说明

当目标网站使用双重身份验证（2FA）时，工作流保持不变。请确保...

Integuru-AI/Integuru