Criação e implantação de conectores personalizados

Crie, teste e implemente um conector de dados personalizado no watsonx, utilizando o Connector Forge. O processo inclui a geração de artefatos de conectores por meio de um agente de codificação com IA, a validação da conectividade e da autenticação, e a implantação do conector por meio de opções sem servidor, do tipo “ OpenShift, ” ou auto-hospedadas, antes de registrá-lo para uso nos serviços d watsonx.

Criando um conector

  1. No seu ambiente do watsonx, abra “Conexões da plataforma” e selecione a guia “Connector Forge ”.
  2. Na guia “Forja de conectores”, clique em “Criar um conector ”.
  3. Copie o comando e use-o para clonar o repositório do Connector Forge na sua máquina local.
  4. Abra o repositório clonado no Claude Code ou no Bob. Altere o agente para o modo personalizado do Connector Forge, que já está pré-configurado no repositório.
  5. Especifique o nome da fonte de dados à qual você deseja se conectar no agente de codificação de IA, por exemplo: "Criar um conector para Salesforce ".

O agente solicita as informações necessárias em várias etapas até que todos os parâmetros de configuração do conector sejam coletados. Durante esse processo, o agente gera os artefatos do conector. O resultado principal é um arquivo JSON DSL que define o conector.

  1. Quando a implantação estiver concluída, volte à janela do Connector Forge e clique no ícone Atualizar. Seu novo conector aparecerá na tabela “Selecionar um conector ”.
  2. (Opcional) Edite o nome e a descrição do conector usando o ícone “Editar” nas guias “Nome” e “Descrição ”.

Testando um conector localmente

Antes de implantar o conector, teste-o localmente para garantir que ele seja aprovado em todas as verificações necessárias. O agente de programação com IA realiza uma série de verificações e orienta você na resolução de quaisquer problemas.

  • Conectividade: Confirma se o conector consegue acessar a fonte de dados de destino.
  • Autenticação: Confirma que suas credenciais são válidas e foram aceitas.
  • Recuperação de dados: Confirma que o conector consegue ler dados da fonte de dados. Analise os resultados do teste e siga as instruções do agente para corrigir os problemas antes de prosseguir com a implantação.

Implantação de um conector

Escolha uma opção de implantação com base no seu ambiente e nos seus requisitos.

Implantação sem servidor (totalmente automatizada)

Use esta opção se desejar uma implantação totalmente gerenciada e automatizada.

  • É necessário ter uma conta no IBM Cloud ou no AWS.
  • O agente de programação de IA automatiza toda a implantação em um ambiente de execução sem servidor ( IBM, Code Engine ou AWS Lambda ).
  • O registro do conector é automatizado.

OpenShift implantação (automatizada, com opção de retorno ao modo manual disponível)

Use esta opção se você gerencia seu próprio cluster e deseja que o conector seja executado no mesmo cluster que sua instalação do Cloud Pak for Data.

  • Requer um cluster do tipo " OpenShift " ou " Cloud Pak for Data " gerenciado pelo cliente
  • O agente de programação de IA automatiza a implantação no seu cluster usando as APIs da plataforma.
  • O registro do conector é automatizado.

Implantação em servidor auto-hospedado (manual com instruções fornecidas pelo agente)

Use esta opção se o seu ambiente não permitir conceder ao agente acesso às APIs de infraestrutura.

  • Requer um ambiente Docker ou Kubernetes gerenciado pelo cliente
  • O agente de programação de IA fornece um pacote de implantação com uma imagem do Docker e instruções.
  • Você deve registrar o conector manualmente.

Registrando o conector no site watsonx

Registre o conector para utilizá-lo com os serviços d watsonx. Se você optar pela implantação automatizada, o agente de codificação com IA conclui essa etapa automaticamente. Para uma implantação manual em servidor próprio, siga estas etapas:

  1. No seu ambiente do watsonx, abra "Conexões da plataforma".
  2. Selecione “Nova conexão ”.
  3. Na lista de conexões, selecione seu conector personalizado.
  4. Insira os dados de conexão necessários e salve.