Antes de Iniciar

• Analise os cenários de casos de uso. Para obter mais informações, consulte Cenários de casos de uso.
• Certifique-se de que você tenha uma conta em IBM Cloud.
• Provisione uma instância de Milvus ou Elasticsearch DB em IBM Cloud.
• Obter a lista de repositórios de código indexados e documentar no armazenamento de vetores.

Criação de um ativo de conexão

Watsonx Code Assistant usa ativos de conexão em seu espaço de implantação para acessar o conteúdo do repositório de código que é indexado em seu armazenamento de vetores. Crie um ativo de conexão para cada índice em seu armazenamento de vetores.

O nome do ativo de conexão deve corresponder ao nome do repositório de código. Por exemplo, se a url do repositório for git@github.ibm.com:my-org/mycode.git, o nome do ativo de conexão deverá ser mycode. Se você criar um ativo de conexão para os índices de documentação, o nome do ativo de conexão deverá estar no formato docs_<name>. Você pode substituir <name> pelo nome do documento indexado com o prefixo docs.

Watsonx Code Assistant usa a seção de descrição do ativo de conexão para ler mais detalhes de configuração sobre seu armazenamento de vetores.

Para criar um ativo de conexão:

1. Abra sua instância de serviço watsonx Code Assistant.

2. Clique no ícone Menu de e selecione Deployments.

3. Selecione seu espaço de implantação.

4. Vá para a guia Assets (Ativos ) do seu espaço de implantação.

5. Vá para Importar ativos > Acesso a dados > Conexão.

6. Selecione o tipo de conexão Elasticsearch ou Milvus em Add connection (Adicionar conexão ).

   • Para o tipo de conexão Elasticsearch, adicione os seguintes campos:

     Elasticsearch configurações do tipo de conexão

     Parâmetro	Descrição
     Nome	Digite o nome da conexão Elasticsearch. O nome da conexão Elasticsearch deve ser o mesmo que o nome do repositório para usar o comando @repo ou iniciar com docs_ para usar o comando @docs.
     Descrição	Insira as informações adicionais do ativo de conexão no formato JSON com os seguintes campos: { "index_name": "add the name of your index" (adicione o nome do seu índice), "db_type" (tipo de banco de dados): "elasticsearch", "ssl_assert_fingerprint": "your_fingerprint", "embedding_details": { "model_id": "msmarco-MiniLM-L-6-v3" } }
     URL	Digite a conexão URL para sua instância Elasticsearch.
     Nome de Usuário e Senha	Digite as credenciais de sua instância Elasticsearch.
     Certificado SSL	Opcional: Digite o certificado SSL para criar uma conexão segura com a instância Elasticsearch. Não é possível testar a conexão Elasticsearch sem um certificado SSL, mas você pode clicar em Save connection (Salvar conexão) para salvar a conexão.

   • Para o tipo de conexão Milvus, adicione os seguintes campos:

     Milvus configurações do tipo de conexão

     Parâmetro	Descrição
     Nome	Digite o nome da conexão Milvus. O nome da conexão Milvus deve ser o mesmo do nome do repositório do comando @repo ou iniciar com docs_ para usar o comando @docs.
     Descrição	Insira as informações adicionais do ativo de conexão no formato JSON com os seguintes campos: { "index_name": ""adicione o nome de seu índice", "db_type": "milvus", "embedding_details": { "model_id": "msmarco-MiniLM-L-6-v3" } }
     Host	Digite o host URL para sua instância Milvus.
     Porta	Digite o número da porta de sua instância Milvus.
     Banco de dados	Defina o parâmetro Database como padrão.
     Nome de Usuário e Senha	Defina o nome de usuário como ibmlhapikey e insira uma chave de API gerada a partir da conta IBM Cloud com a instância IBM watsonx.data no campo Password (Senha).
     Certificado SSL	Opcional: Digite o certificado SSL para criar uma conexão segura com a instância Milvus. Você pode testar sua conexão Milvus sem um certificado SSL.

7. Clique em Criar.