Pular para o conteúdo principal

Usando a Ação do GitHub OpenHands

Este guia explica como usar a Ação do GitHub OpenHands, tanto dentro do repositório OpenHands quanto em seus próprios projetos.

Usando a Ação no Repositório OpenHands

Para usar a Ação do GitHub OpenHands em um repositório, você pode:

  1. Criar uma issue no repositório.
  2. Adicionar a etiqueta fix-me à issue ou deixar um comentário na issue começando com @openhands-agent.

A ação será acionada automaticamente e tentará resolver a issue.

Instalando a Ação em um Novo Repositório

Para instalar a Ação do GitHub OpenHands em seu próprio repositório, siga o README para o OpenHands Resolver.

Dicas de Uso

Resolução Iterativa

  1. Crie uma issue no repositório.
  2. Adicione a etiqueta fix-me à issue ou deixe um comentário começando com @openhands-agent.
  3. Revise a tentativa de resolver a issue verificando o pull request.
  4. Faça um acompanhamento com feedback por meio de comentários gerais, comentários de revisão ou comentários de thread inline.
  5. Adicione a etiqueta fix-me ao pull request ou aborde um comentário específico começando com @openhands-agent.

Etiqueta versus Macro

  • Etiqueta (fix-me): Solicita ao OpenHands que aborde a issue ou pull request inteiro.
  • Macro (@openhands-agent): Solicita ao OpenHands que considere apenas a descrição da issue/pull request e o comentário específico.

Configurações Avançadas

Adicionar configurações personalizadas do repositório

Você pode fornecer instruções personalizadas para o OpenHands seguindo o README para o resolver.

Configurações personalizadas

O GitHub resolver verificará automaticamente se há segredos do repositório ou variáveis do repositório válidos para personalizar seu comportamento. As opções de personalização que você pode definir são:

Nome do atributoTipoFinalidadeExemplo
LLM_MODELVariávelDefinir o LLM a ser usado com o OpenHandsLLM_MODEL="anthropic/claude-3-5-sonnet-20241022"
OPENHANDS_MAX_ITERVariávelDefinir o limite máximo de iterações do agenteOPENHANDS_MAX_ITER=10
OPENHANDS_MACROVariávelPersonalizar a macro padrão para invocar o resolverOPENHANDS_MACRO=@resolveit
OPENHANDS_BASE_CONTAINER_IMAGEVariávelSandbox personalizado (saiba mais)OPENHANDS_BASE_CONTAINER_IMAGE="custom_image"
TARGET_BRANCHVariávelMesclar em um branch diferente de mainTARGET_BRANCH="dev"