Zum Hauptinhalt springen

Überblick

Azure AI Search ist Microsofts KI-gestützte Plattform für die Informationssuche. Mit der Langdock-Integration kannst du semantische Vektorsuchen über deine indexierten Dokumente direkt aus Conversations heraus durchführen.
Authentifizierung: API Key
Kategorie: KI & Suche
Verfügbarkeit: Alle Workspace-Tarife

Voraussetzungen

Bevor du die Integration einrichtest, stelle sicher, dass du Folgendes hast:
  • Ein Azure-Abonnement mit Zugriff auf Azure AI Search
  • Eine Azure AI Search Service-Instanz mit mindestens einem Index
  • Einen Admin-API-Key für deinen Azure AI Search Service
  • Dokumente, die in deinen Index mit Vektor-Embeddings hochgeladen wurden (1536 Dimensionen für OpenAIs text-embedding-ada-002)
Pro-Tipp: Wenn du neu bei Azure AI Search bist, schau dir Microsofts Vector Search Dokumentation an, um deinen ersten Index mit Vector-Search-Unterstützung einzurichten.

Einrichtung

1

Zu Integrationen navigieren

Geh in Langdock zu Integrationen und finde Azure AI Search in der Integrationsliste.
2

Zugangsdaten eingeben

Fülle die erforderlichen Konfigurationsfelder aus (siehe Tabelle unten).
3

Verbindung testen

Speichere die Integration – Langdock überprüft, ob dein Index existiert und erreichbar ist.
4

Suche starten

Tagge die Integration mit @ in einem beliebigen Chat oder füge die Search documents-Aktion zu deinem Assistenten hinzu, um deine indexierten Dokumente zu durchsuchen.

Konfigurationsparameter

Erforderliche Felder

FeldBeschreibungBeispiel
NameEin Name für diese VerbindungFirmen-Wissensdatenbank
API KeyAdmin-Key aus Azure Portal -> KeysDein Admin-Key
Index NameDer genaue Name deines Azure AI Search Indexlangdock-prod-firma
URLDein Azure AI Search Service-Endpunkthttps://my-service.search.windows.net
Search FieldDer Vektor-Feldname in deinem Index-SchemacontentVector
Top KAnzahl der abzurufenden Suchergebnisse5

Optionale Felder

FeldBeschreibungStandard
Embedding DimensionDimension deiner Vektor-Embeddings1536
Embedding ModelVerwendetes Modell für Embeddings (nur Anzeige)Ada v2
SelectKommagetrennte Felder, die zurückgegeben werdenAlle Felder
FilterOData-Filterausdruck zur Eingrenzung der ErgebnisseKeiner
Wo du deine Zugangsdaten findest:
  • Service URL: Azure Portal -> Dein Search Service -> Overview -> kopiere das Url-Feld
  • API Key: Azure Portal -> Dein Search Service -> Keys -> kopiere einen Admin-Key

Verfügbare Aktionen

Dokumente durchsuchen

azureaisearch.searchDocuments
Führt eine semantische Vektorsuche über deine indexierten Dokumente durch. Benötigt Bestätigung: Nein Parameter:
  • query (VECTOR, Required): Vektor-Anfrage für semantische Suche
Output: Liefert Suchergebnisse mit folgender Struktur:
  • value: Array von Suchergebnis-Objekten mit:
    • @search.score: Relevanz-Score
    • @search.highlights: Hervorgehobene Textausschnitte
    • Feldwerte aus den indexierten Dokumenten
  • @odata.count: Gesamtzahl der Ergebnisse
  • @odata.nextLink: Link zur nächsten Ergebnisseite (falls verfügbar)
Embeddings generieren: Du kannst die Langdock Embedding API verwenden, um die Vektor-Embeddings für deinen Azure AI Search Index zu generieren.

Typische Anwendungsfälle

Unternehmensweite Wissenssuche

Durchsuche interne Dokumentationen, Richtlinien und Wissensdatenbanken mit natürlicher Sprache

Recherche & Analyse

Finde relevante Forschungsarbeiten, Berichte und Daten aus großen Dokumentensammlungen

Kundensupport

Rufe schnell Produktinformationen, FAQs und Support-Artikel ab, um Kundenanfragen zu beantworten

Content Discovery

Entdecke relevante Inhalte aus Archiven, Wikis oder Dokumenten-Repositories

Fehlerbehebung

ProblemUrsacheLösung
Index nicht gefundenIndex-Name stimmt nicht überein oder existiert nichtÜberprüfe, ob der genaue Index-Name im Azure Portal mit deiner Konfiguration übereinstimmt (Groß-/Kleinschreibung beachten)
Keine SuchergebnisseKeine Dokumente oder ungültige EmbeddingsStelle sicher, dass Dokumente mit gültigen 1536-dimensionalen Embeddings in dein Vektorfeld hochgeladen wurden
Niedrige Such-ScoresEmbedding-Modell stimmt nicht übereinStelle sicher, dass alle Dokumente das gleiche Embedding-Modell verwenden (z.B. text-embedding-ada-002)
Authentifizierung fehlgeschlagenUngültiger oder abgelaufener API-KeyKopiere einen neuen Admin-Key aus Azure Portal -> Keys
Checkliste zur Validierung
  • Service URL Format: https://[service-name].search.windows.net
  • Index-Name stimmt genau überein (Groß-/Kleinschreibung beachten)
  • Search Field entspricht deinem Vektorfeld-Namen (z.B. contentVector)
  • Dokumente enthalten gültige Vektor-Embeddings

Support

Für zusätzliche Hilfe mit der Azure AI Search-Integration kontaktiere [email protected].