跳到主要内容

使用 OpenHands GitHub Action

本指南解释如何在您自己的项目中使用 OpenHands GitHub Action。

在 OpenHands 仓库中使用 Action

要在仓库中使用 OpenHands GitHub Action,您可以:

  1. 在仓库中创建一个 issue。
  2. 为该 issue 添加 fix-me 标签或在 issue 上留下以 @openhands-agent 开头的评论。

该 action 将自动触发并尝试解决问题。

在新仓库中安装 Action

要在您自己的仓库中安装 OpenHands GitHub Action,请按照 OpenHands Resolver 的 README 进行操作。

使用技巧

迭代式解决

  1. 在仓库中创建一个 issue。
  2. 为该 issue 添加 fix-me 标签,或留下以 @openhands-agent 开头的评论。
  3. 通过检查拉取请求来查看解决问题的尝试。
  4. 通过一般评论、审查评论或内联线程评论提供反馈。
  5. 为拉取请求添加 fix-me 标签,或以 @openhands-agent 开头来回应特定评论。

标签与宏命令的区别

  • 标签(fix-me):请求 OpenHands 处理整个 issue 或拉取请求。
  • 宏命令(@openhands-agent):请求 OpenHands 仅考虑 issue/拉取请求描述和特定评论

高级设置

添加自定义仓库设置

您可以按照resolver 的 README为 OpenHands 提供自定义指示。

自定义配置

GitHub resolver 将自动检查有效的仓库密钥仓库变量来自定义其行为。 您可以设置的自定义选项有:

属性名称类型用途示例
LLM_MODEL变量设置与 OpenHands 一起使用的 LLMLLM_MODEL="anthropic/claude-3-5-sonnet-20241022"
OPENHANDS_MAX_ITER变量设置代理迭代的最大限制OPENHANDS_MAX_ITER=10
OPENHANDS_MACRO变量自定义用于调用 resolver 的默认宏OPENHANDS_MACRO=@resolveit
OPENHANDS_BASE_CONTAINER_IMAGE变量自定义沙箱(了解更多OPENHANDS_BASE_CONTAINER_IMAGE="custom_image"
TARGET_BRANCH变量合并到 main 以外的分支TARGET_BRANCH="dev"