Megosztás:

A Microsoft Agent Framework Quick-Start útmutatója

Ez az útmutató segítséget nyújt abban, hogy az Agent Framework és az Azure OpenAI használatával gyorsan munkába állítson egy alapszintű ügynököt.

Előfeltételek

Mielőtt hozzákezdene, győződjön meg arról, hogy a következők vannak:

Megjegyzés:

A Microsoft Agent Framework a .NET összes aktívan támogatott verziójával támogatott. A minta alkalmazásában a .NET 8 SDK-t vagy egy újabb verziót javasoljuk.

Megjegyzés:

Ez a bemutató Azure CLI-hitelesítő adatokat használ a hitelesítéshez. Győződjön meg arról, hogy bejelentkezett az login , és hozzáféréssel rendelkezik az Azure OpenAI-erőforráshoz. További információkért tekintse meg az Azure CLI dokumentációját. Amennyiben rendelkezik API-kulccsal és nem szeretne szerepköralapú hitelesítést használni, akkor is lecserélhető a AzureCliCredential egy ApiKeyCredential-re, és ebben az esetben az login nem szükséges.

Projekt létrehozása

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

Csomagok telepítése

A csomagok közzé lesznek téve a NuGet-galériában | MicrosoftAgentFramework.

Először adja hozzá a következő Microsoft Agent Framework NuGet-csomagokat az alkalmazáshoz a következő parancsokkal:

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

Egyszerű ügynökminta futtatása

Ez a minta bemutatja, hogyan hozhat létre és használhat egyszerű AI ügynököt az Azure OpenAI Chat Completion funkcióval háttérként. Egy egyszerű ügynököt hoz létre AzureOpenAIClient és gpt-4o-mini használatával, valamint egyéni utasításokkal.

Mintakód

Mindenképpen cserélje le https://your-resource.openai.azure.com/ az Azure OpenAI-erőforrás végpontjára.

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

(Nem kötelező) A Nightly Packages telepítése

Ha a legújabb fejlesztéseket vagy javításokat tartalmazó csomagot kell beszereznie, az Agent Framework éjszakai buildjei itt érhetők el https://github.com/orgs/microsoft/packages?repo_name=agent-framework.

Az éjszakai buildek letöltéséhez kövesse az alábbi lépéseket:

  1. A lépések elvégzéséhez szüksége lesz egy GitHub-fiókra.

  2. Hozzon létre egy GitHub személyes hozzáférési jogkivonatot a hatókörrel az read:packagesalábbi utasítások használatával.

  3. Ha a fiókja a Microsoft-szervezet része, akkor engedélyeznie kell a Microsoft szervezetet egyszeri bejelentkezési szervezetként.

    1. Kattintson az imént létrehozott személyes hozzáférési jogkivonat melletti "Egyszeri bejelentkezés konfigurálása" elemre, majd engedélyezze az engedélyezést Microsoft.

  4. A következő paranccsal adja hozzá a Microsoft GitHub Csomagok forrását a NuGet-konfigurációhoz:

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

  5. Vagy manuálisan is létrehozhat egy NuGet.Config fájlt.

    <?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>
    • Ha ezt a fájlt a projektmappába helyezi, győződjön meg arról, hogy a Git (vagy bármely használt forrásvezérlő) figyelmen kívül hagyja.
    • A fájl tárolási helyétnuget.config hivatkozásban talál.

  6. Most már hozzáadhat csomagokat az éjszakai buildből a projekthez.

    Használja például ezt a parancsot dotnet add package Microsoft.Agents.AI --prerelease

  7. A legújabb csomagkiadásra a következő módon hivatkozhat a projektben:

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

További információért lásd https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.

Előfeltételek

Mielőtt hozzákezdene, győződjön meg arról, hogy a következők vannak:

pip install -U agent-framework --pre

Megjegyzés:

A agent-framework telepítése telepíti a agent-framework-core-et és az összes többi hivatalos csomagot. Ha csak az Azure AI csomagot szeretné telepíteni, futtassa a következőt: pip install agent-framework-azure-ai --pre Minden hivatalos csomag, beleértve a agent-framework-azure-ai is, függőséggel rendelkezik a agent-framework-core iránt, így a legtöbb esetben ezt nem kell megadnia. A hivatalos csomagok teljes listája megtalálható az Agent Framework GitHub-adattárban.

Megjegyzés:

Ez a minta Azure CLI-hitelesítő adatokat használ a hitelesítéshez. Győződjön meg arról, hogy be van jelentkezve az login , és hozzáférése van az Azure AI projekthez. További információkért tekintse meg az Azure CLI dokumentációját.

Egyszerű ügynökminta futtatása

Ez a minta bemutatja, hogyan hozhat létre és használhat egyszerű AI-ügynököt háttérrendszerként az Azure AI-vel. Egy egyszerű ügynököt hoz létre ChatAgent és AzureAIAgentClient használatával, valamint egyéni utasításokkal.

Győződjön meg arról, hogy a következő környezeti változókat állítja be:

  • AZURE_AI_PROJECT_ENDPOINT: Az Azure AI-projektvégpont
  • AZURE_AI_MODEL_DEPLOYMENT_NAME: A modell üzembe helyezésének neve

Mintakód

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

További példák

Részletesebb példákért és speciális forgatókönyvekért tekintse meg az Azure AI-példákat.

Következő lépések

Ügynökök létrehozása és futtatása

  • Last updated on