Teilen über

Tutorial: Teil 1 – Erstellen von Ressourcen zum Erstellen einer benutzerdefinierten Chatanwendung mit dem Prompt Flow-SDK

  • Artikel

In diesem Tutorial verwenden Sie das Prompt Flow SDK (und andere Bibliotheken), um eine Chat-App für Ihr Einzelhandelsunternehmen namens Contoso Trek zu bewerten, zu erstellen, zu konfigurieren und bereitzustellen. Ihr Einzelhandelsunternehmen ist auf Campingausrüstung und Outdoorkleidung spezialisiert. Die Chat-App soll Fragen zu Ihren Produkten und Diensten beantworten. Beispielsweise kann die Chat-App Fragen wie „Welches Zelt ist am wasserdichtesten?“ oder „Was ist der beste Schlafsack für kaltes Wetter?“ beantworten.

Dieses Tutorial ist der erste Teil eines dreiteiligen Tutorials. In diesem Teil 1 wird gezeigt, wie ein Administrator eines Azure-Abonnements die für Teile 2 und 3 der Tutorialreihe benötigten Ressourcen erstellt und konfiguriert. Teile 2 und 3 zeigen, wie ein Entwickler die Ressourcen verwendet. In vielen Organisationen kann dieselbe Person beide Rollen übernehmen. In diesem ersten Teil wird Folgendes vermittelt:

  • Erstellen eines Azure KI Studio-Hubs
  • Erstellen eines Projekts
  • Erstellen eines Azure KI-Suchindex
  • Konfigurieren des Zugriffs für die Azure KI-Suche- und Azure KI-Suche-Ressourcen

Wenn Sie andere Lernprogramme oder Schnellstarts abgeschlossen haben, haben Sie möglicherweise bereits einige der für dieses Lernprogramm erforderlichen Ressourcen erstellt. Wenn Sie dies getan haben, können Sie diese Schritte hier überspringen.

Dieses Tutorial ist der erste Teil eines dreiteiligen Tutorials.

Voraussetzungen

Wichtig

Sie müssen über die erforderlichen Berechtigungen verfügen, um Rollenzuweisungen in Ihrem Azure-Abonnement hinzufügen zu können. Das Erteilen von Berechtigungen per Rollenzuweisung ist nur dem Besitzer der jeweiligen Azure-Ressourcen möglich. Möglicherweise müssen Sie Ihren Azure-Abonnementbesitzer (der eventuell Ihr IT-Administrator ist) darum bitten, dieses Tutorial für Sie abzuschließen.

Azure KI Studio und Azure-Portal

In diesem Lernprogramm verwenden Sie Azure-Ressourcen, um die Chat-App zu erstellen. Sie verwenden sowohl Azure KI Studio als auch das Azure-Portal, um diese Ressourcen zu erstellen und zu konfigurieren.

  • Als Administrator verwenden Sie das Azure-Portal, um den Zugriff auf Ressourcen zu konfigurieren.
  • Als Entwickler verwenden Sie Azure KI Studio, um diese Ressourcen zu gruppieren, die zum Erstellen, Auswerten und Bereitstellen der Chat-App erforderlich sind. Sie können auch mit Ihren Modellen und Bereitstellungen in KI Studio interagieren.

Erstellen eines Azure KI Studio-Hubs

Befolgen Sie diese Schritte, um einen Hub in Azure KI Studio zu erstellen:

  1. Wechseln Sie in Azure KI Studio zur Startseite, und melden Sie sich mit Ihrem Azure-Konto an.

  2. Wählen Sie im linken Bereich Alle Hubs aus, und wählen Sie dann + Neuer Hub aus.

    Screenshot: Schaltfläche zum Erstellen eines neuen Hubs.

  3. Geben Sie im Dialogfeld Neuen Hub erstellen einen Namen für Ihren Hub ein (z. B. contoso-hub), und wählen Sie Weiter aus. Lassen Sie die Standardoption Azure KI Services verbinden ausgewählt. Für den Hub wird eine neue Verbindung für KI-Dienste erstellt.

    Screenshot: Dialogfeld zum Verbinden von Diensten beim Erstellen eines neuen Hubs.

  4. Überprüfen Sie die Informationen, und wählen Sie Erstellen aus.

    Screenshot: Dialogfeld zum Überprüfen der Einstellungen für den neuen Hub.

  5. Sie können den Fortschritt der Huberstellung im Assistenten anzeigen.

    Screenshot: Dialogfeld zum Überprüfen des Fortschritts beim Erstellen von Hubressourcen.

Erstellen eines Projekts

Um ein Azure KI-Projekt in Azure KI Studio zu erstellen, führen Sie diese Schritte aus:

  1. Wechseln Sie zur Homepage von Azure KI Studio.
  2. Wählen Sie + New project aus.
  3. Geben Sie einen Namen für das Projekt ein.
  4. Wählen Sie den Hub aus, den Sie im vorherigen Schritt erstellt haben.

Sobald ein Projekt erstellt worden ist, können Sie im linken Navigationsbereich auf den Playground, die Tools und andere Objekte zugreifen.

Erstellen eines Azure KI-Suchindex

Ziel dieser Anwendung ist es, Ihre benutzerdefinierten Daten als Grundlage für die Modellantworten zu verwenden. Der Suchindex wird verwendet, um relevante Dokumente basierend auf der Frage des Benutzers abzurufen.

Für die Erstellung eines Suchindex benötigen Sie einen Azure KI-Suche-Dienst und eine Verbindung.

Hinweis

Die Erstellung eines Azure KI-Suche-Diensts und der Suchindizes ist mit Kosten verbunden. Details zu Preisen und Tarifen für den Azure KI-Suche-Dienst finden Sie auf der Erstellungsseite. Dort können Sie die Kosten überprüfen, bevor Sie die Ressource erstellen.

Erstellen eines Azure KI-Suche-Diensts

Wenn Sie bereits über einen Azure KI-Suche-Dienst verfügen, können Sie direkt mit dem nächsten Abschnitt fortfahren.

Andernfalls können Sie einen Azure KI-Suche-Dienst über das Azure-Portal erstellen.

  1. Erstellen Sie einen Azure KI-Suche-Dienst im Azure-Portal.
  2. Wählen Sie Ihre Ressourcengruppe und Instanzdetails aus. Auf dieser Seite finden Sie Details zu Preisen und Tarifen.
  3. Durchlaufen Sie den Assistenten, und wählen Sie Überprüfen + zuweisen aus, um die Ressource zu erstellen.
  4. Bestätigen Sie die Details Ihres Azure KI-Suche-Diensts (einschließlich der vorkalkulierten Kosten).
  5. Wählen Sie Erstellen aus, um den Azure KI-Suche-Dienst zu erstellen.

Verbinden der Azure KI-Suche mit Ihrem Projekt

Wenn Sie in Ihrem Projekt bereits über eine Verbindung für Azure KI-Suche verfügen, können Sie direkt mit dem Konfigurieren des Zugriffs für den Azure KI-Suche-Dienst fortfahren.

Suchen Sie in Azure KI Studio nach einer mit Azure KI-Suche verbundenen Ressource.

  1. Wechseln Sie in KI Studio zu Ihrem Projekt, und wählen Sie im linken Bereich Einstellungen aus.
  2. Überprüfen Sie im Abschnitt Verbundene Ressourcen, ob bei Ihnen eine Verbindung vom Typ „Azure KI-Suche“ vorhanden ist.
  3. Wenn Sie über eine Azure KI-Suche-Verbindung verfügen, können Sie fortfahren, um den Zugriff für Ressourcen zu konfigurieren.
  4. Wählen Sie andernfalls Neue Verbindung > Azure KI-Suche aus.
  5. Suchen Sie in den Optionen nach Ihrem Azure KI-Suche-Dienst, und wählen Sie Verbindung hinzufügen aus.
  6. Durchlaufen Sie den Assistenten, um die Verbindung zu erstellen. Weitere Informationen zum Hinzufügen von Verbindungen finden Sie in dieser Schrittanleitung.

Konfigurieren des Zugriffs für Ressourcen

In diesem Abschnitt wird gezeigt, wie Sie die verschiedenen Zugriffssteuerelemente konfigurieren, die für die Ressourcen erforderlich sind, die Sie in den vorherigen Abschnitten erstellt haben.

Es empfiehlt sich, Microsoft Entra ID anstelle von API-Schlüsseln zu verwenden. Um diese Authentifizierung verwenden zu können, müssen Sie die richtigen Zugriffssteuerungen festlegen und die richtigen Rollen für Ihre Dienste zuweisen.

Konfigurieren des Zugriffs für Azure KI Services

Beginnen Sie mit dem Projekt, um die KI Services-Ressource zu finden:

  1. Wechseln Sie in KI Studio zu Ihrem Projekt, und wählen Sie im linken Bereich Einstellungen aus.
  2. Wählen Sie Verbundene Ressourcen aus.
  3. Wählen Sie den Namen des KI Services oder Azure OpenAI in der Liste der verbundenen Ressourcen aus, um die Seite mit den Ressourcendetails zu öffnen. Wählen Sie dann den Ressourcennamen erneut auf der Seite Verbindungsdetails aus. Damit wird die Ressource im Azure-Portal geöffnet.

Geben Sie die Zugriffssteuerung im Azure-Portal an:

  1. Wählen Sie links im Azure-Portal Zugriffssteuerung (IAM)>+ Hinzufügen>Rollenzuweisung hinzufügen aus.
  2. Suchen Sie nach der Rolle Cognitive Services OpenAI-Benutzer, und wählen Sie sie aus. Wählen Sie Weiteraus.
  3. Wählen Sie User, group, or service principal (Benutzer, Gruppe oder Dienstprinzipal) aus. Wählen Sie dann Mitglieder auswählen aus.
  4. Suchen Sie im daraufhin geöffneten Bereich Mitglieder auswählen nach dem Namen des Benutzers, für den Sie die Rollenzuweisung hinzufügen möchten. Wählen Sie den Benutzer und dann Auswählen aus.
  5. Fahren Sie mit dem Assistenten fort, und wählen Sie Überprüfen + zuweisen aus, um die Rollenzuweisung hinzuzufügen.

Wechseln Sie jetzt zurück zu KI Studio Einstellungen>Verbundene Ressourcen. Wählen Sie dieses Mal den Namen der Azure KI-Suche in der Liste der verbundenen Ressourcen aus, um die Seite mit den Ressourcendetails zu öffnen. Wählen Sie dann den Ressourcennamen erneut auf der Seite Verbindungsdetails aus. Damit wird die Ressource im Azure-Portal geöffnet.

Führen Sie die folgenden Schritte aus, um die rollenbasierte Zugriffssteuerung für Ihren Azure KI-Suche-Dienst zu aktivieren:

  1. Wählen Sie im Azure-Portal für Ihren Azure KI-Suche-Dienst im linken Bereich die Optionen Einstellungen > Schlüssel aus.

  2. Wählen Sie Beides aus, um sicherzustellen, dass sowohl API-Schlüssel als auch die rollenbasierte Zugriffssteuerung für Ihren Azure KI-Suche-Dienst aktiviert sind.

    Screenshot: Einstellung „API-Zugriffssteuerung“

Warnung

Sie können die rollenbasierte Zugriffssteuerung lokal verwenden, da Sie weiter unten in diesem Tutorial az login ausführen. Bei der Bereitstellung Ihrer App im dritten Teil des Tutorials wird die Bereitstellung allerdings mithilfe von API-Schlüsseln aus Ihrem Azure KI-Suche-Dienst authentifiziert. Die Unterstützung der Microsoft Entra ID-Authentifizierung für die Bereitstellung wird in Kürze verfügbar gemacht. Jetzt müssen Sie sowohl Schlüssel als auch Endpunkte aktivieren.

Weisen Sie als Nächstes Ihrer Benutzeridentität (oder der Identität des Entwicklers, der die Teile zwei und drei abschließen wird) die Rollen Suchindexdatenmitwirkenden und Suchdienstmitwirkenden für den Azure KI-Suche-Dienst zu. Diese Rollen ermöglichen es Ihnen, den Azure KI-Suche-Dienst unter Verwendung der zugehörigen Benutzeridentität aufzurufen.

Weisen Sie weiterhin im Azure-Portal Ihrem Azure KI-Suche-Dienst die Rolle Suchindexdatenmitwirkender zu. (Dies sind die gleichen Schritte, die Sie zuvor für den Azure OpenAI Service ausgeführt haben.)

  1. Wählen Sie links im Azure-Portal Zugriffssteuerung (IAM)>+ Hinzufügen>Rollenzuweisung hinzufügen aus.
  2. Suchen Sie nach der Rolle Mitwirkender an Suchindexdaten, und wählen Sie sie aus. Wählen Sie Weiteraus.
  3. Wählen Sie User, group, or service principal (Benutzer, Gruppe oder Dienstprinzipal) aus. Wählen Sie dann Mitglieder auswählen aus.
  4. Suchen Sie im daraufhin geöffneten Bereich Mitglieder auswählen nach dem Namen des Benutzers, für den Sie die Rollenzuweisung hinzufügen möchten. Wählen Sie den Benutzer und dann Auswählen aus.
  5. Fahren Sie mit dem Assistenten fort, und wählen Sie Überprüfen + zuweisen aus, um die Rollenzuweisung hinzuzufügen.

Wiederholen Sie diese Schritte, um die Rolle Suchdienstmitwirkender auch dem Azure KI-Suche-Dienst zuzuweisen.

Sie können das Projekt jetzt an einen Entwickler übergeben, um die Chat-App zu erstellen. Der Entwickler wird das Prompt Flow SDK verwenden, um die Chat-App für Ihr Einzelhandelsunternehmen namens Contoso Trek zu bewerten, zu erstellen, zu konfigurieren und bereitzustellen.

Bereinigen von Ressourcen

Um unnötige Azure-Kosten zu vermeiden, sollten Sie die in diesem Tutorial erstellten Ressourcen löschen, wenn sie nicht mehr benötigt werden. Zum Verwalten von Ressourcen können Sie das Azure-Portal verwenden.

Löschen Sie sie aber noch nicht, wenn Sie Ihre Chat-App im nächsten Teil dieser Tutorialreihe erstellen möchten.

Nächster Schritt

Teil 2: Erstellen einer benutzerdefinierte Chat-App mit dem Prompt Flow-SDK