Einrichten von Verbindungsanlagen

watsonx Code Assistant Standardplan

Ein Verbindungs-Asset enthält die Verbindungsdetails Ihres Vektorspeichers. Watsonx Code Assistant verwendet das Verbindungs-Asset, um sich mit Ihrem Vektorspeicher zu verbinden und den Kontext für Ihre Anweisungen im Chat abzurufen.

Vorbereitende Schritte

  • Überprüfen Sie die Anwendungsszenarien. Weitere Informationen finden Sie unter Einsatzszenarien.
  • Stellen Sie sicher, dass Sie ein IBM Cloud Konto haben.
  • Stellen Sie eine Instanz von Milvus oder Elasticsearch DB auf IBM Cloud bereit.
  • Abrufen der Liste der indizierten Code-Repositories und des Dokuments im Vektorspeicher.

Erstellen einer Verbindungsanlage

Watsonx Code Assistant verwendet Verbindungs-Assets in Ihrem Bereitstellungsbereich, um auf Code-Repository-Inhalte zuzugreifen, die in Ihrem Vektorspeicher indiziert sind. Erstellen Sie ein Verbindungs-Asset für jeden Index in Ihrem Vektorspeicher.

Der Name des Verbindungs-Assets muss mit dem Namen des Code-Repositorys übereinstimmen. Wenn die Repository-Url beispielsweise git@github.ibm.com:my-org/mycode.git lautet, muss der Name des Verbindungs-Assets mycode lauten. Wenn Sie ein Verbindungs-Asset für die Dokumentationsindizes erstellen, muss der Name des Verbindungs-Assets das Format docs_<name> haben. Sie können <name> durch den Namen des indizierten Dokuments mit dem Präfix docs ersetzen.

Watsonx Code Assistant verwendet den Beschreibungsabschnitt des Verbindungs-Assets, um weitere Konfigurationsdetails über Ihren Vektorspeicher zu lesen.

So erstellen Sie ein Verbindungs-Asset:

  1. Öffnen Sie Ihre watsonx Code Assistant Service-Instanz.

  2. Klicken Sie auf das Symbol Navigationsmenü und wählen Sie dann Einsätze.

  3. Wählen Sie Ihren Bereitstellungsraum.

  4. Wechseln Sie zur Registerkarte Assets in Ihrem Bereitstellungsbereich.

  5. Gehen Sie zu Anlagen importieren > Datenzugriff > Verbindung.

  6. Wählen Sie unter Verbindung hinzufügen den Verbindungstyp Elasticsearch oder Milvus.

    • Für den Verbindungstyp Elasticsearch fügen Sie die folgenden Felder hinzu:

      Elasticsearch einstellungen der Verbindungsart
      Parameter Beschreibung
      Name Geben Sie den Namen der Verbindung Elasticsearch ein. Der Verbindungsname Elasticsearch muss mit dem Namen des Repository übereinstimmen, um den Befehl @repo zu verwenden, oder mit docs_ beginnen, um den Befehl @docs zu verwenden.
      Beschreibung Geben Sie die zusätzlichen Informationen des Verbindungs-Assets im JSON-Format in die folgenden Felder ein:

      {

      "index_name": "add the name of your index",

      "db_type": "elasticsearch",

      "ssl_assert_fingerprint": "your_fingerprint",

      "embedding_details": {

      "model_id": "msmarco-MiniLM-L-6-v3"

      }

      }
      URL Geben Sie die Verbindung URL für Ihre Elasticsearch Instanz ein.
      Benutzername und Kennwort Geben Sie die Anmeldedaten für Ihre Elasticsearch Instanz ein.
      SSL-Zertifikat Optional: Geben Sie das SSL-Zertifikat ein, um eine sichere Verbindung mit der Instanz Elasticsearch herzustellen. Sie können Ihre Elasticsearch Verbindung nicht ohne ein SSL-Zertifikat testen, Sie können jedoch trotzdem auf „Verbindung speichern“ klicken, um die Verbindung zu speichern.

    • Für den Verbindungstyp Milvus fügen Sie die folgenden Felder hinzu:

      Milvus einstellungen der Verbindungsart
      Parameter Beschreibung
      Name Geben Sie den Namen der Verbindung Milvus ein. Der Verbindungsname Milvus muss mit dem Repository-Namen des Befehls @repo übereinstimmen oder mit docs_ beginnen, um den Befehl @docs zu verwenden.
      Beschreibung Geben Sie die zusätzlichen Informationen des Verbindungs-Assets im JSON-Format in die folgenden Felder ein:

      {

      "index_name": "füge den Namen deines Indexes hinzu",

      "db_type": "milvus",

      "embedding_details": {

       "model_id": "msmarco-MiniLM-L-6-v3"

      }

      }
      Host Geben Sie den Host URL für Ihre Milvus Instanz ein.
      Port Geben Sie die Portnummer für Ihre Milvus Instanz ein.
      Datenbank Setzen Sie den Parameter Datenbank auf Standard.
      Benutzername und Kennwort Setzen Sie den Benutzernamen auf ibmlhapikey und geben Sie in das Feld Passwort einen API-Schlüssel ein, der aus dem Konto IBM Cloud mit der Instanz IBM watsonx.data generiert wird.
      SSL-Zertifikat Optional: Geben Sie das SSL-Zertifikat ein, um eine sichere Verbindung mit der Instanz Milvus herzustellen. Sie können Ihre Milvus Verbindung auch ohne SSL-Zertifikat testen.

  7. Klicken Sie auf Erstellen.