Instalando o plug-in para o Eclipse IDE

watsonx Code Assistant

Crie uma chave de API e adicione o plug-in watsonx Code Assistant ao seu Eclipse IDE.

Compatibilidade

O plug-in é compatível com:

  • Eclipse Eclipse IDE para desenvolvedores Java ou Eclipse IDE para desenvolvedores Java corporativos e da Web
  • Versões 2024-06, 2024-09, 2024-12, 2025-03, 2025-06, 2025-09
  • No Windows, o plug-in requer o tempo de execução Microsoft Edge WebView2. Nas versões mais recentes do Windows, isso pode já estar instalado.

Sistemas operacionais:

  • macOS
  • Windows 11
  • Fedora Linux 41
  • Red Hat Enterprise Linux 8
  • Ubuntu 20.04

Criar uma chave de API em IBM Cloud

Em vez de um nome de usuário e senha, cada desenvolvedor usa uma chave de API pessoal para fazer login.

Para criar uma chave API:

  1. Faça login em IBM Cloud API Keys.

    Certifique-se de que esteja usando a conta IBM Cloud na qual a instância de watsonx Code Assistant da sua organização está provisionada.

  2. Clique em Criar.

  3. Digite " IBM watsonx Code Assistant API key como o nome de sua chave de API. Opcionalmente, insira uma descrição.

  4. Clique em Criar.

  5. Clique em Download ou Copiar e armazene a chave da API em um local seguro.

    A chave fica disponível por apenas 296 segundos. Certifique-se de armazená-lo em algum lugar onde você possa encontrá-lo mais tarde.

Instale o plug-in

O plug-in necessário depende do plano que você está usando.

Plug-ins por plano
Plano Descrição Nome do plug-in Suporte ao idioma de exibição
Plano Trial Avaliação gratuita limitada com chat de IA generativo integrado para código. watsonx Code Assistant Inglês (en), japonês (ja), coreano (ko)
Plano Essentials IA generativa integrada para sugestões de código, explicações de código, documentação de código e testes de unidade. watsonx Code Assistant Inglês (en), japonês (ja), coreano (ko)
Plano Standard Todos os recursos do plano Essentials, além dos recursos de modernização do Java empresarial, explicação aprimorada do código e geração aprimorada de testes unitários.

Para a instalação do plano Standard, duas entradas aparecem em sua lista de softwares instalados, uma para watsonx Code Assistant e outra para watsonx Code Assistant for Enterprise Java Applications. Os dois plug-ins são dependências para essa instalação. É necessária a versão 1.3.1 ou posterior de watsonx Code Assistant e a versão 1.1.0 ou posterior de watsonx Code Assistant for Enterprise Java Applications.		 IBM watsonx Code Assistant for Enterprise Java Applications Somente em inglês (en)

Para obter detalhes completos do plano, consulte:

Do Eclipse Marketplace

Para instalar o plug-in do Eclipse Marketplace:

  1. Abra o Eclipse IDE.

  2. Escolha a instalação para o plano que você está usando:

  3. Clique e arraste o botão Instalar para o espaço de trabalho em seu Eclipse IDE.

  4. Em Confirm Features (Confirmar recursos), revise os itens e clique em Confirm (Confirmar).

  5. Em Review Licenses (Revisar licenças), leia a licença, clique para concordar e, em seguida, clique em Finish(Concluir).

  6. Em Autoridades de confiança, clique na caixa de seleção e, em seguida, clique em Confiança selecionada.

  7. Em Trust Artifacts, clique na caixa de seleção Type (Tipo ) e, em seguida, clique em Trust Selected (Confiança selecionada).

  8. Você precisa reiniciar Eclipse. Em Software Updates (Atualizações de software), clique em Restart Now (Reiniciar agora).

Do Eclipse IDE

Para instalar o plug-in a partir de seu Eclipse IDE:

  1. Em seu Eclipse IDE, clique no menu Ajuda e escolha Eclipse Marketplace.

  2. Escolha a instalação para o plano que você está usando:

    • Plano Trial Plano Essentials Para instalar o plug-in dos planos Trial e Essentials, pesquise por watsonx Code Assistant.
    • Plano padrão Para instalar o plug-in para planos padrão, pesquise por watsonx Code Assistant for Enterprise Java Applications.

  3. Clique no botão Install (Instalar ) do plug-in de que você precisa.

  4. Em Confirm Features (Confirmar recursos), revise os itens e clique em Confirm (Confirmar).

  5. Em Review Licenses (Revisar licenças), leia a licença, clique para concordar e, em seguida, clique em Finish(Concluir).

  6. Em Autoridades de confiança, clique na caixa de seleção e, em seguida, clique em Confiança selecionada.

  7. Em Trust Artifacts, clique na caixa de seleção Type (Tipo ) e, em seguida, clique em Trust Selected (Confiança selecionada).

  8. Você precisa reiniciar Eclipse. Em Software Updates (Atualizações de software), clique em Restart Now (Reiniciar agora).

Abra o plug-in

Para abrir watsonx Code Assistant:

  1. Depois que Eclipse for reiniciado, clique em Window, selecione Show View e clique em Other.

  2. Na caixa de diálogo Mostrar exibição, abra a pasta watsonx Code Assistant, selecione Chat e clique em Abrir.

  3. Clique em Log in com sua chave de API.

  4. Nas Preferências de segurança, digite sua chave de API IBM watsonx Code Assistant.

  5. Se sua conta estiver associada a mais de um data center IBM Cloud, selecione também a região preferida na lista suspensa.

  6. Clique em Aplicar e fechar para sair das Preferências de segurança.

Configure seu ambiente Java corporativo

Plano Standard Se você estiver usando o plano Standard e quiser trabalhar com aplicativos Java corporativos, precisará configurar seu ambiente. Para obter mais informações, consulte Configuração de seu ambiente Java corporativo.

Atualizar as configurações de proxy do site HTTP

Se a sua organização usa um servidor proxy HTTP, é necessário atualizar as configurações do Eclipse IDE para que ele possa se conectar corretamente. Você pode receber erros de console quando tentar se conectar e essa configuração estiver ausente.

  1. Abra as configurações do site Eclipse IDE.
  2. Na seção Geral, clique em Conexões de rede.
  3. Defina o Active Provider como Manual.
  4. Selecione o esquema, como HTTPS, e clique em Edit (Editar ).
  5. Digite o host URL e a porta do seu servidor proxy HTTP.
  6. Se for necessário incluir informações de autenticação, clique em Requires Authentication (Requer autenticação ) e digite seu nome de usuário e senha.
  7. Clique em OK para aplicar as alterações.

Proteja sua configuração

IBM watsonx Code Assistant não fornece nenhum controle de segurança adicional. Siga estas etapas para proteger adequadamente sua configuração.

Seu ambiente Eclipse

Aplique todas as atualizações Eclipse IDE para ajudar a garantir que você tenha a segurança e as correções de bugs mais recentes.

Os registros do plug-in watsonx Code Assistant são armazenados em arquivos *.log em <your home directory>/.wca. Esses arquivos não são criptografados, a não ser pela criptografia fornecida pelo seu sistema de arquivos. Proteja os registros contra acesso indevido.

Armazenamento de conversas de bate-papo

IBM watsonx Code Assistant armazena todo o histórico de conversas de bate-papo localmente no sistema de arquivos em <your home directory>/.wca/chat.db, em um formato de banco de dados definido por SQLite. IBM watsonx Code Assistant não compartilha essas conversas com ninguém. Esse arquivo não é criptografado, a não ser pela criptografia fornecida pelo seu sistema de arquivos. Proteja esse arquivo contra acesso indevido.

Dados de telemetria

IBM watsonx Code Assistant não coleta nenhum dado de telemetria. Em geral, watsonx Code Assistant não envia nenhum dado que processa para terceiros, inclusive para IBM.

Faça logout de sua chave de API

Se necessário, você pode fazer logout da sua chave de API. Fazer logout e reinserir sua chave de API pode ajudar a resolver qualquer problema de autenticação que você encontrar.

Para fazer logout:

  1. Abra o bate-papo.

  2. Clique no ícone Logout.

Use o Console para ver os detalhes da atividade

Você pode usar a visualização do Console do Eclipse IDE para ver detalhes sobre o que o plug-in está fazendo e registrando, além de verificar se há erros.

Para abrir a visualização do Console:

  1. No Eclipse, clique em Window, selecione Show View e clique em Console.

  2. Na visualização do Console, clique no ícone Exibir Console Selecionado para selecionar watsonx Code Assistant ou watsonx Code Assistant: LSP. Ambos fornecem mais detalhes sobre o que o plug-in está fazendo.

Para ajustar a visualização do console e o registro para o plug-in Eclipse:

  1. Abra as configurações do Eclipse IDE.

  2. Clique na entrada Configurações watsonx Code Assistant.

  3. Em Log level (Nível de registro ), mude do padrão INFO para outra configuração, como WARN.

Desinstalar o plug-in

Se você precisar desinstalar watsonx Code Assistant, siga estas etapas:

  1. No editor Eclipse, clique em Help e, em seguida, clique em Install New Software.

  2. Clique em O que já está instalado?

  3. Na guia Software instalado, selecione watsonx Code Assistant e clique em Desinstalar.

  4. Em Uninstall (Desinstalar), revise os itens e clique em Finish(Concluir).

  5. Você precisa reiniciar Eclipse. Em Software Updates (Atualizações de software), clique em Restart Now (Reiniciar agora).