Przewodnik Quick-Start programu Microsoft Agent Framework

Wymagania wstępne

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

• Pakiet .NET 8.0 SDK lub nowszy
• Zasób usługi Azure OpenAI z wdrożonym modelem (na przykład gpt-4o-mini)
• Zainstalowany i uwierzytelniony Azure CLI (az login)
• Użytkownik ma role Cognitive Services OpenAI User lub Cognitive Services OpenAI Contributor dla zasobu usługi Azure OpenAI.

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:

• Python w wersji 3.10 lub nowszej
• Projekt sztucznej inteligencji platformy Azure z wdrożonym modelem (na przykład gpt-4o-mini)
• Zainstalowany i uwierzytelniony interfejs wiersza polecenia platformy Azure (az login)
• Zainstaluj pakiet Platformy agentów:

pip install -U agent-framework --pre

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.