Usando a Ação do GitHub OpenHands

Este guia explica como usar a Ação do GitHub OpenHands 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 do 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. Forneça feedback através de comentários gerais, comentários de revisão ou comentários em linha.
5. Adicione a etiqueta fix-me ao pull request, ou direcione 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 ao repositório

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

Configurações personalizadas

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

Nome do atributo	Tipo	Finalidade	Exemplo
LLM_MODEL	Variável	Define o LLM a ser usado com OpenHands	LLM_MODEL="anthropic/claude-3-5-sonnet-20241022"
OPENHANDS_MAX_ITER	Variável	Define o limite máximo para iterações do agente	OPENHANDS_MAX_ITER=10
OPENHANDS_MACRO	Variável	Personaliza a macro padrão para invocar o resolver	OPENHANDS_MACRO=@resolveit
OPENHANDS_BASE_CONTAINER_IMAGE	Variável	Sandbox personalizado (saiba mais)	OPENHANDS_BASE_CONTAINER_IMAGE="custom_image"
TARGET_BRANCH	Variável	Mesclar para uma branch diferente de main	TARGET_BRANCH="dev"