Add Azure SQL tables as knowledge source

Wenn du Azure SQL-Tabellen als Wissensquelle integrierst, verankerst du deinen Agenten in den strukturierten Daten, die in deiner Azure SQL-Datenbank gespeichert sind. Ihr Makler kann Fragen beantworten, indem er aus den von Ihnen ausgewählten Tabellen liest und dabei die dem Herstellern zur Verfügung stehenden Verbindungsdaten und Berechtigungen verwendet.

Note

Um Azure SQL-Tabellen als Wissensquelle hinzuzufügen, müssen Sie die Berechtigung haben, auf die zugrundeliegende Datenbank und Tabellen zuzugreifen. Fehlende oder unzureichende Berechtigungen könnten verhindern, dass Server, Datenbanken oder Tabellen während der Einrichtung sichtbar oder auswählbar sind.

Prerequisites

• Eine Azure SQL-Datenbank oder Azure SQL Managed Instance, die Ihre Organisation über Power Platform erreichen kann.

• Zugangsdaten, die sich mit der Datenbank verbinden und die Tabellen lesen können, die du hinzufügen möchtest (zum Beispiel Microsoft Entra ID oder SQL-Authentifizierung, je nachdem, wie deine Verbindung konfiguriert ist).

• Zugang zum Copilot Studio und die Erlaubnis, den Agenten zu bearbeiten.

• Netzwerkzugang ist so konfiguriert, dass Power Platform Ihren Azure SQL-Server erreichen kann. Zum Beispiel Firewall-Regeln, die Azure-Dienste erlauben, oder private Konnektivität, je nach Anforderung Ihrer Organisation.

Berechtigungen und Authentifizierung

Azure SQL-Kenntnisse nutzen die Power Platform SQL-Verbindung, die du während der Einrichtung erstellst oder auswählst. Während der Laufzeit verlässt sich der Agent auf die Microsoft-Authentifizierung des Agent-Nutzers und den über diesen Verbindungspfad gewährten Zugriff.

• Nutzer erhalten nur Antworten basierend auf Daten, auf die der Hersteller über die konfigurierten Verbindungen und Datenbankberechtigungen des Herstellers zugreifen kann.

• Wenn während der Einrichtung keine Tabellen erscheinen, überprüfen Sie, ob die Verbindung außerhalb von Copilot Studio erfolgreich ist und das Konto diese Tabellen auflisten und lesen kann.

Bereite deine Azure SQL-Datenbank vor

Copilot Studio-Agenten unterstützen Azure SQL-Datenbanken oder SQL Server. Bevor Sie Tabellen hinzufügen, stellen Sie sicher, dass Ihre Tabellen folgende Konfiguration haben:

• Klare Spaltennamen, wobei kryptische Abkürzungen vermieden werden. Verwenden Sie CustomerName z. B. anstelle von CustNm.
• Primärschlüssel definiert für jede Tabelle. Der Agent verwendet Primärschlüssel, um Zeilen zu identifizieren und Ergebnisse zurückzugeben.
• Beschreibende Daten, die dem Agenten helfen, den Kontext der Daten zu verstehen und Fragen genauer zu beantworten. Verwenden Sie OrderDate z. B. anstelle von Date1.

Füge Azure SQL-Tabellen zu deinem Agent hinzu

Um Azure SQL-Tabellen als Wissensquelle hinzuzufügen, führen Sie die folgenden Schritte durch:

1. Eröffne deinen Copilot Studio-Agenten.

2. Wählen Sie die Registerkarte Erstellen aus.

3. Im Komponentenpanel wählen Sie Wissen.

4. Im Dialogfeld "Wissen hinzufügen" wähle Azure SQL (oder SQL Server, je nach dem in deiner Umgebung angezeigten Label).

5. Erstellen oder wählen Sie eine Verbindung zu Ihrer Azure SQL-Datenbank:

   • Wenn du noch keine Verbindung hast, wähle Neue Verbindung erstellen (oder Verbindung hinzufügen).

   • Gib den Servernamen und den Datenbanknamen für deine Azure SQL-Ressource ein.

   • Wählen Sie den von Ihrer Organisation geforderten Authentifizierungstyp, melden Sie sich an oder geben Sie Zugangsdaten an und stellen Sie die Verbindung her.

   • Wenn bereits eine Verbindung besteht, wählen Sie sie aus der Liste und fahren Sie fort.

6. Finde eine oder mehrere Tabellen, die hinzugefügt werden können. Nutzen Sie das Suchfeld, um die Liste bei Bedarf einzugrenzen, und wählen Sie dann die Tabellen aus, die der Agent verwenden soll.

   Note

   Füge nur Tabellen hinzu, die der Agent braucht, um Nutzerfragen zu beantworten. Verwenden Sie gut benannte Tabellen mit klaren Spaltennamen, damit der Agent die Daten zuverlässiger interpretieren kann.

7. Überprüfen Sie den Wissensnamen und die Beschreibung. Geben Sie eine detaillierte Beschreibung an, da diese die Orchestrierung des Agenten unterstützt und dem Agenten hilft, den Kontext der Wissensquelle zu verstehen.

8. Wählen Sie "Zum Agent hinzufügen" aus, um das Hinzufügen der Wissensquelle abzuschließen.

Nachdem du die Wissensquelle hinzugefügt hast

Nachdem du Azure SQL hinzugefügt hast:

• Bestätigen Sie, dass die Wissensquelle auf der Knowledge-Seite des Agenten mit der Verbindung und ausgewählten Tabellen erscheint, die Sie gewählt haben.

• Veröffentlichen Sie den Agenten, damit die Wissensquelle in der veröffentlichten Erfahrung verfügbar ist.

• Testen Sie Ihren Makler mit Fragen, die aus den ausgewählten Tabellen beantwortet werden sollten. Zum Beispiel: "Zeig mir die fünf Kunden mit den meisten Kunden nach Gesamtumsatz im letzten Monat." Wenn die zurückgegebenen Ergebnisse leer oder falsch sind, stellen Sie sicher, dass die Tabelle die erwarteten Daten enthält und die Abfrage mit Ihrem Schema übereinstimmt.

Tip

Erstellen Sie eine diagnostische Ansicht in Azure SQL, die einen kleinen, bekannten Datensatz zurückgibt. Verwenden Sie diesen Datensatz, um zu bestätigen, dass die Verbindung funktioniert, bevor Sie Produktionstabellen verwenden.

Verbesserung der Antwortqualität

Klare Benennungen und Beschreibungen helfen dem Agenten zu verstehen, wann und wie er Ihre Azure SQL-Daten verwenden soll.

• Verwenden Sie einen spezifischen Namen der Wissensquelle, der die Geschäftsdomäne widerspiegelt (zum Beispiel "Customer orders – Azure SQL") anstelle eines generischen Labels.

• Schreiben Sie eine detaillierte Beschreibung , die erklärt, welche Daten die Tabellen enthalten, welche Geschäftsfragen sie beantworten und welche wichtigen Filter oder Beziehungen es gibt.

• Wählen Sie nur relevante Tabellen aus. Zusätzliche Tabellen können die Erdung verwässern und es dem Agenten erschweren, die richtigen Daten auszuwählen.

• Ich bevorzuge lesbares Schema. Tabellen und Spalten mit unternehmensfreundlichen Namen liefern in der Regel bessere Antworten als undurchsichtige technische Namen.

Beispielbeschreibung

Das folgende Beispiel zeigt die Art von Beschreibung, die der generativen Orchestrierung hilft, die richtige Wissensquelle auszuwählen:

Azure SQL Knowledge for Contoso order management. Enthält Tabellen für Kunden, Bestellungen und Bestelllinien. Nutzen Sie diese Quelle für Fragen zu Bestellstatus, Bestellhistorie, Kundenkäufen, bestellten Produktmengen und Umsatz nach Kunden oder Datum. Nutze sie nicht für Inventar auf Lager oder für die Verfolgung des Versanddienstleisters.