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

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:

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

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto, falls Sie keines besitzen.

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.

   

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.

   

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

   

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

   

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.

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.

Konfigurieren des Zugriffs für Azure KI--Suche

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.

   

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