Delen via

Handleiding voor Microsoft Agent Framework Quick-Start

Deze handleiding helpt u snel aan de slag te gaan met een basisagent met behulp van Agent Framework en Azure OpenAI.

Vereiste voorwaarden

Zorg ervoor dat u het volgende hebt voordat u begint:

Opmerking

Microsoft Agent Framework wordt ondersteund met alle actief ondersteunde versies van .NET. Voor dit voorbeeld raden we de .NET 8 SDK of een latere versie aan.

Opmerking

In deze demo worden Azure CLI-referenties gebruikt voor verificatie. Zorg ervoor dat u bent aangemeld met az login en dat u toegang hebt tot de Azure OpenAI-resource. Zie de Documentatie van Azure CLI voor meer informatie. Het is ook mogelijk om de AzureCliCredential vervangen door een ApiKeyCredential als u een API-sleutel hebt en geen verificatie op basis van rollen wilt gebruiken, in dat geval az login niet vereist is.

Een project maken

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

Pakketten installeren

Pakketten worden gepubliceerd in NuGet Gallery | MicrosoftAgentFramework.

Voeg eerst de volgende NuGet-pakketten van Microsoft Agent Framework toe aan uw toepassing met behulp van de volgende opdrachten:

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

Een basisagentvoorbeeld uitvoeren

In dit voorbeeld ziet u hoe u een eenvoudige AI-agent maakt en gebruikt met Azure OpenAI Chat Completion als back-end. Er wordt een basisagent gemaakt met AzureOpenAIClient, gpt-4o-mini en aangepaste instructies.

Voorbeeldcode

Zorg ervoor dat u https://your-resource.openai.azure.com/ vervangt door het eindpunt van uw Azure OpenAI-resource.

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

(Optioneel) Nachtpakketten installeren

Als u een pakket met de nieuwste verbeteringen of fixes wilt ophalen, zijn nachtversies van Agent Framework beschikbaar op https://github.com/orgs/microsoft/packages?repo_name=agent-framework.

Om nightly builds te downloaden, volg deze stappen:

  1. U hebt een GitHub-account nodig om deze stappen uit te voeren.

  2. Maak een Persoonlijk GitHub-toegangstoken met het read:packages bereik met behulp van deze instructies.

  3. Als uw account deel uitmaakt van de Microsoft-organisatie, moet u de Microsoft organisatie autoriseren als een organisatie voor eenmalige aanmelding.

    1. Klik op "Configureer SSO" naast het Persoonlijke toegangstoken dat u zojuist hebt gemaakt en autoriseer vervolgens Microsoft.

  4. Gebruik de volgende opdracht om de Microsoft GitHub Packages-bron toe te voegen aan uw NuGet-configuratie:

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

  5. U kunt ook handmatig een NuGet.Config bestand maken.

    <?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>
    • Als u dit bestand in uw projectmap plaatst, moet u Ervoor zorgen dat Git (of welk broncodebeheer u ook gebruikt) dit negeren.
    • Zie nuget.config naslaginformatie voor meer informatie over waar u dit bestand kunt opslaan.

  6. U kunt nu pakketten uit de nachtbuild toevoegen aan uw project.

    Gebruik bijvoorbeeld deze opdracht dotnet add package Microsoft.Agents.AI --prerelease

  7. En naar de nieuwste pakketrelease kan in het project als volgt worden verwezen:

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

Zie https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry voor meer informatie.

Vereiste voorwaarden

Zorg ervoor dat u het volgende hebt voordat u begint:

pip install -U agent-framework --pre

Opmerking

Het installeren van agent-framework zal agent-framework-core en alle andere officiële pakketten installeren. Als u alleen het Azure AI-pakket wilt installeren, kunt u uitvoeren: pip install agent-framework-azure-ai --pre Alle officiële pakketten, inclusief agent-framework-azure-ai, hebben een afhankelijkheid van agent-framework-core, dus in de meeste gevallen hoeft u dat niet op te geven omdat het al verondersteld wordt. De volledige lijst met officiële pakketten vindt u in de GitHub-opslagplaats van Agent Framework.

Opmerking

In dit voorbeeld worden Azure CLI-referenties gebruikt voor verificatie. Zorg ervoor dat u bent aangemeld bij az login en toegang hebt tot het Azure AI-project. Zie de Documentatie van Azure CLI voor meer informatie.

Een basisagentvoorbeeld uitvoeren

In dit voorbeeld ziet u hoe u een eenvoudige AI-agent maakt en gebruikt met Azure AI als back-end. Er wordt een basisagent gemaakt met ChatAgent, AzureAIAgentClient en aangepaste instructies.

Zorg ervoor dat u de volgende omgevingsvariabelen instelt:

  • AZURE_AI_PROJECT_ENDPOINT: Uw Azure AI-projecteindpunt
  • AZURE_AI_MODEL_DEPLOYMENT_NAME: De naam van uw modelimplementatie

Voorbeeldcode

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

Meer voorbeelden

Zie de Azure AI-voorbeelden voor meer gedetailleerde voorbeelden en geavanceerde scenario's.

Volgende stappen

Agents maken en uitvoeren

  • Last updated on