GoHumanLoop WeWork 是针对GoHumanLoop在企业微信场景下进行审批、获取信息操作的示例服务。方便用户在使用GohumanLoop时，对接到自己的企业微信环境中。

GoHumanLoop 项目地址：https://github.com/ptonlix/gohumanloop ✈️

[!NOTE] > GoHumanLoop: A Python library empowering AI agents to dynamically request human input (approval/feedback/conversation) at critical stages. Core features:

• Human-in-the-loop control: Lets AI agent systems pause and escalate >decisions, enhancing safety and trust.
• Multi-channel integration: Supports Terminal, Email, API, and frameworks like LangGraph/CrewAI (soon).
• Flexible workflows: Combines automated reasoning with human oversight for reliable AI operations.

Ensures responsible AI deployment by bridging autonomous agents and human judgment.

• 项目配置样例文件在conf/app.conf.example中

appname = gohumanloop-wework
httpport = 9800 # HTTP 端口按需配置

# wework
agentid = 1000003 # 企业微信应用ID
corpsecret = XXXXX # 应用Secret
corpid = XXXXX # 企业ID
ptoken = XXXXX # Token
pkey = XXXXX # EncodingAESKey

# template
approve_template_id = 8TmoaR5xEaZsuzKyRT4Zt82FLYCYXVN5EVk6R # 审批模板ID
info_template_id = 3WN63LowuwFRsDXft1GbiQi4NrYyLApeejYCBs3S # 信息模板ID
creator_userid = ChenFuDong # 创建人ID，详情参考企业微信文档
approver_userid = ChenFuDong # 审批人ID (默认审批人，实际可通过 GoHumanLoop Metadata数据指定)

# database
datapath = ./data/gohumanloop.db # 数据库路径

• 修改配置文件

mv conf/app.conf.example conf/app.conf

目前这个版本中，支持审批和信息获取。分别使用两个模板，模板格式固定，需要参考以下配置：

审批模板

• 参考图片内的字段，都是文本控件和多行文本控件。包括以下字段
  1. 任务 ID
  2. 对话 ID
  3. 请求 ID
  4. HumanLoop 类型
  5. 申请内容
  6. 申请问题
  7. 申请说明

以上字段由 GoHumanLoop 库来传输并自动填充并自动发起审批流程

审批模板

• 审批流程可以参考上图设置，审批人设置为自选

信息获取模板

• 参考图片内的字段，都是文本控件和多行文本控件。详情同审批流程模板和说明

信息获取模板

• 信息获取流程不需要具体审批，只需要获取具体信息。没有设置审批人，只设置了办理人，专用于获取信息。

GoHumanLoop Wework 支持两种部署方式手动部署和 Docker 部署。

Go 版本要求：1.23.0

• 下载代码

git clone https://github.com/ptonlix/gohumanloop-wework.git

• 编译

make build

./gohumanloop-wework

• 提前安装好 Docker 服务

docker pull ptonlix/gohumanloop-wework:latest

• 运行容器

docker run -d \
  --name gohumanloop-wework \
  -v /path/to/local/conf:/app/conf \
  -v /path/to/local/data:/app/data \
  -p 9800:9800 \
  ptonlix/gohumanloop-wework:latest

以 Nginx 为例，可以参考在 Nginx 配置文件中添加以下路由配置

location ^~ /humanloop/ {
        proxy_pass http://127.0.0.1:9800/gohumanloop/callback;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Real-Port $remote_port;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

location ^~ /api/v1/humanloop/ {
        proxy_pass http://127.0.0.1:9800;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Real-Port $remote_port;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

location ^~ /api/v1/apikey/ {
        proxy_pass http://127.0.0.1:9800;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Real-Port $remote_port;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

GoHumanLoop与Gohumanloop-Wework架构关系

• GoHumanLoop提供了一套统一的 API 接口，通过API Provider对外提供。
• gohumanloop-wework实现了API Consumer的功能，通过API Provider来获取审批相关的信息，并且通过企业微信 WeWork API 实现了与用户的企业微信应用进行交互，发送审批请求和获取审批事件回调等。

gohumanloop-wework采用Beego作为 Web 框架。sqlite作为简单的数据存储。go-workwx作为企业微信 API 实现。提供一个可拓展的 GoHumanLoop 企业微信审批示例服务。

• 访问 Swagger 文档:

go run main.go

http://127.0.0.1:9800/docs

GoHumanLoop Wework 和文档均开源，我们欢迎以问题、文档和 PR 等形式做出贡献。

🎉 如果你对本项目感兴趣，欢迎扫码联系作者交流