Übung: Verwenden integrierter Plug-Ins

10 Minuten

Für diese Übung fügen Sie Ihrem Semantic Kernel-Projekt ein vorhandenes Plug-In hinzu und erfahren, wie Sie Ihr erstes Plug-In zum Ausführen einer Aufgabe verwenden. Legen wir los.

Vorbereiten Ihrer Entwicklungsumgebung

Für diese Übungen steht Ihnen ein Einstiegsprojekt zur Verfügung, das Sie verwenden können. Führen Sie die folgenden Schritte aus, um das Einstiegsprojekt einzurichten:

Wichtig

Visual Studio Code und .NET Framework 8.0 müssen installiert sein, um diese Schritte auszuführen. Möglicherweise müssen Sie auch die Visual Studio Code-Erweiterung mit dem C#-Dev Kit installieren.

Öffnen Sie Visual Studio Code.
Wählen Sie im Visual Studio Code-Abschnitt Start die Option Git-Repository klonen aus.
Geben Sie auf der URL-Leiste https://github.com/MicrosoftLearning/MSLearn-Develop-AI-Agents-with-Azure-OpenAI-and-Semantic-Kernel-SDK.git ein.
Erstellen Sie im Datei-Explorer einen neuen Ordner an einem Speicherort, der einfach zu finden und zu merken ist, z. B. einen Ordner auf Ihrem Desktop.
Wählen Sie die Schaltfläche Als Repositoryziel auswählen aus.

Sie müssen bei GitHub angemeldet sein, um das Projekt erfolgreich zu klonen.
Öffnen Sie das Projekt in Visual Studio Code.
Klicken Sie im Explorer mit der rechten Maustaste auf den Ordner M02-create-plugins-for-semantic-kernel/M02-Project, und dann auf In integriertem Terminal öffnen.
Klappen Sie den Ordner M02-create-plugins-for-semantic-kernel/M02-Project auf.

Es sollte eine Datei „Program.cs“ angezeigt werden.
Öffnen Sie die Datei Program.cs und aktualisieren Sie die folgenden Variablen mit ihrem Azure OpenAI Services-Bereitstellungsnamen, API-Schlüssel, Endpunkt.
```
string yourDeploymentName = "";
string yourEndpoint = "";
string yourKey = "";
```

Jetzt können Sie mit der Übung beginnen. Viel Glück!

Absicht des Benutzers abrufen

Fügen Sie im integrierten Terminal die Semantic Kernel-Plug-Ins hinzu. Kernpaket für Ihr Projekt durch Ausführen des folgenden Befehls: dotnet add package Microsoft.SemanticKernel.Plugins.Core --version 1.2.0-alpha

Hinweis

Derzeit ist das Paket eine Vorabversion. Möglicherweise sollten Sie nach der neuesten Version https://www.nuget.org/packages/Microsoft.SemanticKernel.Plugins.Core/1.2.0-alpha suchen.
Fügen Sie den folgenden Code in Ihre Datei Program.cs ein:
```
builder.Plugins.AddFromType<ConversationSummaryPlugin>();
var kernel = builder.Build();

string input = @"I'm a vegan in search of new recipes. I love spicy food! 
Can you give me a list of breakfast recipes that are vegan friendly?";

var result = await kernel.InvokeAsync(
    "ConversationSummaryPlugin", 
    "GetConversationActionItems", 
    new() {{ "input", input }});

Console.WriteLine(result);
```
In diesem Code importieren Sie ConversationSummaryPlugin aus dem Core.Plugins Paket. Sie erstellen einen neuen Kernel-Generator und fügen das Plug-In zum Generator hinzu. ConversationSummaryPlugin unterstützt mehrere Aktionen: GetConversationActionItems, SummarizeConversation, und GetConversationTopics.

Sie erstellen eine Zeichenfolge mit einer Beispielunterhaltung, rufen dann das Plug-In mit dem Funktionsnamen auf und übergeben die Unterhaltungszeichenfolge. Das Plug-In gibt eine Zusammenfassung der Unterhaltung zurück.

Hinweis

Da sich das Plug-In noch in der Vorschau befindet, müssen Sie möglicherweise die Warnung unterdrücken, indem Sie oben in der Datei #pragma warning disable SKEXP0050 verwenden.
Führen Sie den Code aus, indem Sie dotnet run in den Terminal eingeben.

Die Antwort sollte in etwa wie die folgende Ausgabe aussehen:
```
{
    "actionItems": [
        {
            "owner": "",
            "actionItem": "Provide a list of vegan-friendly spicy breakfast recipes",
            "dueDate": "",
            "status": "Open",
            "notes": ""
        }
    ]
}
```
Beachten Sie, dass das Plug-In in der Lage war, eine vereinfachte Absicht aus der Eingabezeichenfolge zu identifizieren.

Dieses Beispiel ist nur der Anfang, was Sie mit dem Semantic Kernel SDK tun können. In der nächsten Lektion erfahren Sie weitere Möglichkeiten zum Anpassen von Plug-Ins und Ausführen von Funktionen.

Wichtig

Achten Sie darauf, keinen Code zu löschen, den Sie geschrieben haben, sie benötigen ihn für die nächsten Übungen.

Übung: Verwenden integrierter Plug-Ins

Vorbereiten Ihrer Entwicklungsumgebung

Absicht des Benutzers abrufen

Feedback