Modo GUI
O OpenHands fornece um modo de Interface Gráfica do Usuário (GUI) para interagir com o assistente de IA.
Instalação e Configuração
- Siga as instruções de instalação para instalar o OpenHands.
- Após executar o comando, acesse o OpenHands em http://localhost:3000.
Interagindo com a GUI
Configuração Inicial
- No primeiro lançamento, você verá uma página de configurações.
- Selecione um
Provedor de LLM
e umModelo de LLM
nos menus suspensos. Se o modelo necessário não existir na lista, ative as opçõesAvançadas
e insira-o com o prefixo correto na caixa de textoModelo Personalizado
. - Insira a
Chave de API
correspondente para o provedor escolhido. - Clique em
Salvar Alterações
para aplicar as configurações.
Configuração do Token do GitHub
O OpenHands exporta automaticamente um GITHUB_TOKEN
para o ambiente shell se ele estiver disponível. Isso pode acontecer de duas maneiras:
Instalação Local: O usuário insere diretamente seu token do GitHub.
Configurando um Token do GitHub
- Gere um Personal Access Token (PAT):
- No GitHub, vá para Settings > Developer Settings > Personal Access Tokens > Tokens (classic).
- New token (classic)
- Escopos necessários:
repo
(Controle total de repositórios privados)
- Fine-Grained Tokens
- All Repositories (Você pode selecionar repositórios específicos, mas isso afetará o que retorna na pesquisa de repositórios)
- Minimal Permissions (Selecione Meta Data = Read-only para pesquisa, Pull Requests = Read and Write, Content = Read and Write para criação de branches)
- Insira o Token no OpenHands:
- Clique no botão Settings (ícone de engrenagem).
- Navegue até a seção
GitHub Settings
. - Cole seu token no campo
GitHub Token
. - Clique em
Save Changes
para aplicar as alterações.
Políticas de Token Organizacional
Se você estiver trabalhando com repositórios organizacionais, configurações adicionais podem ser necessárias:
- Verifique os Requisitos da Organização:
- Os administradores da organização podem impor políticas específicas de token.
- Algumas organizações exigem que os tokens sejam criados com SSO habilitado.
- Revise as configurações de política de token da sua organização.
- Verifique o Acesso à Organização:
- Vá para as configurações do seu token no GitHub.
- Procure a organização em
Organization access
. - Se necessário, clique em
Enable SSO
ao lado da sua organização. - Conclua o processo de autorização SSO.
Solução de Problemas
Problemas comuns e soluções:
-
Token Não Reconhecido:
- Certifique-se de que o token esteja salvo corretamente nas configurações.
- Verifique se o token não expirou.
- Verifique se o token possui os escopos necessários.
- Tente regenerar o token.
-
Acesso à Organização Negado:
- Verifique se o SSO é necessário, mas não está habilitado.
- Verifique a associação à organização.
- Entre em contato com o administrador da organização se as políticas de token estiverem bloqueando o acesso.
-
Verificando se o Token Funciona:
- O aplicativo mostrará uma marca de seleção verde se o token for válido.
- Tente acessar um repositório para confirmar as permissões.
- Verifique o console do navegador em busca de mensagens de erro.
OpenHands Cloud: O token é obtido por meio da autenticação OAuth do GitHub.
Autenticação OAuth
Ao usar o OpenHands Cloud, o fluxo OAuth do GitHub solicita as seguintes permissões:
- Acesso ao repositório (leitura/escrita)
- Gerenciamento de fluxo de trabalho
- Acesso de leitura à organização
Para autenticar o OpenHands:
- Clique em
Sign in with GitHub
quando solicitado. - Revise as permissões solicitadas.
- Autorize o OpenHands a acessar sua conta do GitHub.
- Se estiver usando uma organização, autorize o acesso à organização se solicitado.
Configurações Avançadas
- Dentro da página Settings, ative as opções
Advanced
para acessar configurações adicionais. - Use a caixa de texto
Custom Model
para inserir manualmente um modelo se ele não estiver na lista. - Especifique uma
Base URL
se necessário para o seu provedor de LLM.
Interagindo com a IA
- Digite seu prompt na caixa de entrada.
- Clique no botão de envio ou pressione Enter para enviar sua mensagem.
- A IA processará sua entrada e fornecerá uma resposta na janela de chat.
- Você pode continuar a conversa fazendo perguntas de acompanhamento ou fornecendo informações adicionais.
Dicas para Uso Eficaz
- Seja específico em suas solicitações para obter as respostas mais precisas e úteis, conforme descrito nas melhores práticas de prompting.
- Use o painel de workspace para explorar a estrutura do seu projeto.
- Use um dos modelos recomendados, conforme descrito na seção LLMs.
Lembre-se, o modo GUI do OpenHands é projetado para tornar sua interação com o assistente de IA o mais suave e intuitiva possível. Não hesite em explorar seus recursos para maximizar sua produtividade.