Udostępnij przez

Przewodnik Quick-Start programu Microsoft Agent Framework

Ten przewodnik pomoże Ci szybko uruchomić się za pomocą podstawowego agenta przy użyciu platformy Agent Framework i usługi Azure OpenAI.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz następujące elementy:

Uwaga / Notatka

Program Microsoft Agent Framework jest obsługiwany ze wszystkimi aktywnie obsługiwanymi wersjami platformy .NET. Na potrzeby tego przykładu zalecamy zestaw .NET 8 SDK lub nowszą wersję.

Uwaga / Notatka

W tym pokazie używane są poświadczenia interfejsu wiersza polecenia platformy Azure do uwierzytelniania. Upewnij się, że jesteś zalogowany/a przy użyciu swojego konta az login i masz dostęp do zasobów Azure OpenAI. Aby uzyskać więcej informacji, zobacz dokumentację interfejsu wiersza polecenia platformy Azure. Można również zastąpić element AzureCliCredential elementem ApiKeyCredential jeśli masz klucz API i nie chcesz używać uwierzytelniania opartego na rolach, w takim przypadku az login nie jest wymagane.

Tworzenie projektu

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

Instalowanie pakietów

Pakiety zostaną opublikowane w galerii NuGet | MicrosoftAgentFramework.

Najpierw dodaj następujące pakiety NuGet programu Microsoft Agent Framework do aplikacji przy użyciu następujących poleceń:

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

Uruchamianie przykładowego agenta bazowego

W tym przykładzie pokazano, jak utworzyć i użyć prostego agenta sztucznej inteligencji z Azure OpenAI Chat Completion jako backendem. Spowoduje to utworzenie podstawowego agenta przy użyciu AzureOpenAIClient z gpt-4o-mini i instrukcjami niestandardowymi.

Przykładowy kod

Pamiętaj, aby zastąpić element https://your-resource.openai.azure.com/ punktem końcowym zasobu Azure OpenAI.

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."));

(Opcjonalnie) Instalowanie nocnych pakietów

Jeśli musisz uzyskać pakiet zawierający najnowsze ulepszenia lub poprawki, nocne kompilacje programu Agent Framework są dostępne pod adresem https://github.com/orgs/microsoft/packages?repo_name=agent-framework.

Aby pobrać nocne kompilacje, wykonaj następujące kroki:

  1. Do wykonania tych kroków będzie potrzebne konto usługi GitHub.

  2. Utwórz osobisty token dostępu usługi GitHub z zakresem read:packages , korzystając z tych instrukcji.

  3. Jeśli Twoje konto jest częścią organizacji firmy Microsoft, musisz autoryzować Microsoft organizację jako organizację logowania jednokrotnego.

    1. Kliknij „Skonfiguruj SSO” obok właśnie utworzonego Personal Access Token, a następnie autoryzuj Microsoft.

  4. Użyj następującego polecenia, aby dodać źródło pakietów Microsoft GitHub do konfiguracji nuGet:

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

  5. Możesz też ręcznie utworzyć NuGet.Config plik.

    <?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>
    • Jeśli umieścisz ten plik w folderze projektu, upewnij się, że usługa Git (lub dowolna używana kontrola źródła) go ignoruje.
    • Aby uzyskać więcej informacji na temat miejsca przechowywania tego pliku, zobacz odniesienie do nuget.config.

  6. Teraz możesz dodawać pakiety z nocnej kompilacji do projektu.

    Na przykład użyj tego polecenia dotnet add package Microsoft.Agents.AI --prerelease

  7. Najnowszą wersję pakietu można zastosować w projekcie w następujący sposób:

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

Aby uzyskać więcej informacji, zobacz https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz następujące elementy:

pip install -U agent-framework --pre

Uwaga / Notatka

Instalacja agent-framework zainstaluje agent-framework-core oraz wszystkie inne oficjalne pakiety. Jeśli chcesz zainstalować tylko pakiet Azure AI, możesz uruchomić komendę: pip install agent-framework-azure-ai --pre Wszystkie oficjalne pakiety, w tym agent-framework-azure-ai, mają zależność od agent-framework-core, więc w większości przypadków nie trzeba tego określać. Pełną listę oficjalnych pakietów można znaleźć w repozytorium GitHub Platformy agentów.

Uwaga / Notatka

W tym przykładzie do uwierzytelniania są używane poświadczenia Azure CLI. Upewnij się, że jesteś zalogowany przy użyciu az login i masz dostęp do projektu Azure AI. Aby uzyskać więcej informacji, zobacz dokumentację interfejsu wiersza polecenia platformy Azure.

Uruchamianie przykładowego agenta bazowego

W tym przykładzie pokazano, jak utworzyć i użyć prostego agenta sztucznej inteligencji z usługą Azure AI jako zaplecza. Spowoduje to utworzenie podstawowego agenta przy użyciu ChatAgent z AzureAIAgentClient i instrukcjami niestandardowymi.

Upewnij się, że ustawiono następujące zmienne środowiskowe:

  • AZURE_AI_PROJECT_ENDPOINT: Punkt końcowy projektu sztucznej inteligencji platformy Azure
  • AZURE_AI_MODEL_DEPLOYMENT_NAME: nazwa wdrożenia modelu

Przykładowy kod

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())

Więcej przykładów

Aby uzyskać bardziej szczegółowe przykłady i zaawansowane scenariusze, zobacz Przykłady usługi Azure AI.

Dalsze kroki

Tworzenie i uruchamianie agentów

  • Last updated on