Freigeben über

Microsoft Agent Framework Quick-Start Handbuch

Dieser Leitfaden hilft Ihnen, schnell mit einem einfachen Agent mit Agent Framework und Azure OpenAI auf dem Laufenden zu sein.

Voraussetzungen

Bevor Sie beginnen, stellen Sie folgendes sicher:

Hinweis

Microsoft Agent Framework wird mit allen aktiv unterstützten Versionen von .NET unterstützt. Für die Zwecke dieses Beispiels empfehlen wir das .NET 8 SDK oder eine höhere Version.

Hinweis

Diese Demo verwendet Azure CLI-Anmeldeinformationen für die Authentifizierung. Stellen Sie sicher, dass Sie mit az login angemeldet sind und Zugriff auf die Azure OpenAI-Ressource haben. Weitere Informationen finden Sie in der Azure CLI-Dokumentation. Es ist auch möglich, AzureCliCredential durch einen ApiKeyCredential API-Schlüssel zu ersetzen, wenn Sie einen haben und keine rollenbasierte Authentifizierung verwenden möchten, sodass az login nicht erforderlich ist.

Erstellen eines Projekts

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

Installieren von Paketen

Pakete werden im NuGet-Katalog veröffentlicht | MicrosoftAgentFramework.

Fügen Sie zunächst die folgenden NuGet-Pakete von Microsoft Agent Framework in Ihre Anwendung ein, indem Sie die folgenden Befehle verwenden:

dotnet add package Azure.AI.OpenAI --prerelease
dotnet add package Azure.Identity
dotnet add package Microsoft.Agents.AI.OpenAI --prerelease

Ausführen eines Standard-Agent-Beispiels

In diesem Beispiel wird veranschaulicht, wie Sie einen einfachen KI-Agent mit Azure OpenAI Chat Completion als Back-End erstellen und verwenden. Er erstellt einen einfachen Agent mit AzureOpenAIClientgpt-4o-mini und benutzerdefinierten Anweisungen.

Beispielcode

Stellen Sie sicher, dass Sie https://your-resource.openai.azure.com/ durch den Endpunkt Ihrer Azure OpenAI-Ressource ersetzen.

using System;
using Azure.AI.OpenAI;
using Azure.Identity;
using Microsoft.Agents.AI;
using OpenAI;

AIAgent agent = new AzureOpenAIClient(
  new Uri("https://your-resource.openai.azure.com/"),
  new AzureCliCredential())
    .GetChatClient("gpt-4o-mini")
    .CreateAIAgent(instructions: "You are good at telling jokes.");

Console.WriteLine(await agent.RunAsync("Tell me a joke about a pirate."));

Nightly Packages installieren (Optional)

Wenn Sie ein Paket mit den neuesten Verbesserungen oder Korrekturen erhalten müssen, stehen Nightly Builds von Agent Framework zur https://github.com/orgs/microsoft/packages?repo_name=agent-frameworkVerfügung.

Führen Sie die folgenden Schritte aus, um Nightly-Builds herunterzuladen:

  1. Sie benötigen ein GitHub-Konto, um diese Schritte auszuführen.

  2. Erstellen Sie ein GitHub Personal Access Token mit dem read:packages Bereich mithilfe dieser Anweisungen.

  3. Wenn Ihr Konto Teil der Microsoft-Organisation ist, müssen Sie die Microsoft Organisation als einmaliges Anmelden autorisieren.

    1. Klicken Sie auf "SSO konfigurieren" neben dem soeben erstellten persönlichen Zugriffstoken und autorisieren Sie anschließend Microsoft.

  4. Verwenden Sie den folgenden Befehl, um der NuGet-Konfiguration die Quelle für Microsoft GitHub-Pakete hinzuzufügen:

    dotnet nuget add source --username GITHUBUSERNAME --password GITHUBPERSONALACCESSTOKEN --store-password-in-clear-text --name GitHubMicrosoft "https://nuget.pkg.github.com/microsoft/index.json"

  5. Oder Sie können eine NuGet.Config Datei manuell erstellen.

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
    <add key="github" value="https://nuget.pkg.github.com/microsoft/index.json" />
  </packageSources>

  <packageSourceMapping>
    <packageSource key="nuget.org">
      <package pattern="*" />
    </packageSource>
    <packageSource key="github">
      <package pattern="*nightly"/>
      <package pattern="Microsoft.Agents.AI" />
    </packageSource>
  </packageSourceMapping>

  <packageSourceCredentials>
    <github>
        <add key="Username" value="<Your GitHub Id>" />
        <add key="ClearTextPassword" value="<Your Personal Access Token>" />
      </github>
  </packageSourceCredentials>
</configuration>
    • Legen Sie diese Datei in Ihrem Projektordner ab und achten Sie darauf, dass sie von Git (oder dem von Ihnen verwendeten Versionskontrollsystem) ignoriert wird.
    • Weitere Informationen zum Speichern dieser Datei finden Sie unter nuget.config Referenz.

  6. Sie können jetzt Pakete aus dem nightly Build zu Ihrem Projekt hinzufügen.

    Verwenden Sie z. B. diesen Befehl. dotnet add package Microsoft.Agents.AI --prerelease

  7. Auf die neueste Paketversion kann im Projekt wie folgt verwiesen werden:

    <PackageReference Include="Microsoft.Agents.AI" Version="*-*" />

Weitere Informationen finden Sie unter https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.

Voraussetzungen

Bevor Sie beginnen, stellen Sie folgendes sicher:

pip install -U agent-framework --pre

Hinweis

Die Installation von agent-framework umfasst agent-framework-core sowie alle anderen offiziellen Pakete. Wenn Sie nur das Azure AI-Paket installieren möchten, können Sie folgendes ausführen: pip install agent-framework-azure-ai --pre Alle offiziellen Pakete, einschließlich agent-framework-azure-ai, haben eine Abhängigkeit von agent-framework-core, daher müssten Sie das in den meisten Fällen nicht angeben. Die vollständige Liste der offiziellen Pakete finden Sie im GitHub-Repository des Agent-Frameworks.

Hinweis

In diesem Beispiel werden Azure CLI-Anmeldeinformationen für die Authentifizierung verwendet. Stellen Sie sicher, dass Sie mit az login angemeldet sind und Zugriff auf das Azure AI-Projekt haben. Weitere Informationen finden Sie in der Azure CLI-Dokumentation.

Ausführen eines Standard-Agent-Beispiels

In diesem Beispiel wird veranschaulicht, wie Sie einen einfachen KI-Agent mit Azure AI als Back-End erstellen und verwenden. Er erstellt einen einfachen Agent mit ChatAgentAzureAIAgentClient und benutzerdefinierten Anweisungen.

Stellen Sie sicher, dass Sie die folgenden Umgebungsvariablen festlegen:

  • AZURE_AI_PROJECT_ENDPOINT: Ihr Azure AI-Projektendpunkt
  • AZURE_AI_MODEL_DEPLOYMENT_NAME: Der Name der Modellbereitstellung

Beispielcode

import asyncio
from agent_framework.azure import AzureAIClient
from azure.identity.aio import AzureCliCredential

async def main():
    async with (
        AzureCliCredential() as credential,
        AzureAIClient(async_credential=credential).create_agent(
            instructions="You are good at telling jokes."
        ) as agent,
    ):
        result = await agent.run("Tell me a joke about a pirate.")
        print(result.text)

if __name__ == "__main__":
    asyncio.run(main())

Weitere Beispiele

Ausführlichere Beispiele und erweiterte Szenarien finden Sie in den Azure AI-Beispielen.

Nächste Schritte

Erstellen und Ausführen von Agents

  • Last updated on