Prima di iniziare

• Rivedere gli scenari dei casi d'uso. Per ulteriori informazioni, vedere Scenari d'uso.
• Assicuratevi di avere un account IBM Cloud.
• Provisionare un'istanza di Milvus o Elasticsearch DB su IBM Cloud.
• Ottenere l'elenco dei repository di codice indicizzati e dei documenti nell'archivio vettoriale.

Creazione di un asset di connessione

Watsonx Code Assistant utilizza le risorse di connessione nello spazio di distribuzione per accedere al contenuto del repository di codice indicizzato nell'archivio vettoriale. Creare una risorsa di connessione per ogni indice dell'archivio vettoriale.

Il nome della risorsa di connessione deve corrispondere al nome del repository di codice. Ad esempio, se l'url del repository è git@github.ibm.com:my-org/mycode.git, il nome della risorsa di connessione deve essere mycode. Se si crea una risorsa di connessione per gli indici di documentazione, il nome della risorsa di connessione deve essere nel formato docs_<name>. Si può sostituire <name> con il nome del documento indicizzato con il prefisso docs.

Watsonx Code Assistant utilizza la sezione della descrizione dell'asset di connessione per leggere ulteriori dettagli sulla configurazione del proprio archivio vettoriale.

Per creare una risorsa di connessione:

1. Aprire l'istanza del servizio watsonx Code Assistant.

2. Fare clic sull'icona Menu di navigazione , quindi selezionare Deployment.

3. Selezionare lo spazio di distribuzione.

4. Andare alla scheda Assets dello spazio di distribuzione.

5. Andare su Importa attività > Accesso ai dati > Connessione.

6. Selezionare il tipo di connessione Elasticsearch o Milvus in Aggiungi connessione.

   • Per il tipo di connessione Elasticsearch, aggiungere i seguenti campi:

     Elasticsearch impostazioni del tipo di connessione

     Parametro	Descrizione
     Nome	Inserire il nome della connessione Elasticsearch. Il nome della connessione Elasticsearch deve essere uguale al nome del repository per usare il comando @repo o deve iniziare con docs_ per usare il comando @docs.
     Descrizione	Inserire le informazioni aggiuntive dell'asset di connessione nel formato JSON con i seguenti campi: { "index_name": "aggiungi il nome del tuo indice", "db_type": "elasticsearch", "ssl_assert_fingerprint": "your_fingerprint", "embedding_details": { "model_id": "msmarco-MiniLM-L-6-v3" } }
     URL	Inserire la connessione URL per l'istanza Elasticsearch.
     Nome utente e password	Inserire le credenziali dell'istanza Elasticsearch.
     Certificato SSL	Opzionale: Inserire il certificato SSL per creare una connessione sicura con l'istanza Elasticsearch. Non puoi testare la tua connessione Elasticsearch senza un certificato SSL, ma puoi comunque fare clic su Salva connessione per salvarla.

   • Per il tipo di connessione Milvus, aggiungere i seguenti campi:

     Milvus impostazioni del tipo di connessione

     Parametro	Descrizione
     Nome	Inserire il nome della connessione Milvus. Il nome della connessione Milvus deve essere uguale al nome del repository per il comando @repo o deve iniziare con docs_ per usare il comando @docs.
     Descrizione	Inserire le informazioni aggiuntive dell'asset di connessione nel formato JSON con i seguenti campi: { "index_name": ""aggiungi il nome del tuo indice", "db_type": "milvus", "embedding_details": { "model_id": "msmarco-MiniLM-L-6-v3" } }
     Host	Inserire l'host URL per l'istanza Milvus.
     Porta	Inserire il numero di porta dell'istanza Milvus.
     Database	Impostare il parametro Database come predefinito.
     Nome utente e password	Impostare il nome utente su ibmlhapikey e inserire una chiave API generata dall'account IBM Cloud con l'istanza IBM watsonx.data nel campo Password.
     Certificato SSL	Opzionale: Inserire il certificato SSL per creare una connessione sicura con l'istanza Milvus. È possibile testare la connessione a Milvus senza un certificato SSL.

7. Fai clic su Crea.