Sdílet prostřednictvím

Průvodce Quick-Start rozhraní Microsoft Agent Framework

Tato příručka vám pomůže rychle začít pracovat se základním agentem pomocí agenta Framework a Azure OpenAI.

Požadavky

Než začnete, ujistěte se, že máte následující:

Poznámka:

Rozhraní Microsoft Agent Framework je podporováno ve všech aktivně podporovaných verzích rozhraní .NET. Pro účely této ukázky doporučujeme sadu .NET 8 SDK nebo novější verzi.

Poznámka:

Tato ukázka používá k ověřování přihlašovací údaje Azure CLI. Ujistěte se, že jste přihlášeni s účtem az login a máte přístup k prostředku Azure OpenAI. Další informace najdete v dokumentaci k Azure CLI. Je také možné nahradit AzureCliCredential kódem ApiKeyCredential , pokud máte klíč rozhraní API a nechcete používat ověřování na základě rolí, v takovém případě az login se nevyžaduje.

Vytvoření projektu

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

Instalace balíčků

Balíčky budou publikovány do galerie NuGet | MicrosoftAgentFramework.

Nejprve do aplikace přidejte následující balíčky NuGet architektury Microsoft Agent Framework pomocí následujících příkazů:

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

Spuštění základního příkladu agenta

Tato ukázka předvádí, jak vytvořit a použít jednoduchého agenta AI využívajícího Azure OpenAI Chat Completion jako backend. Vytvoří základního agenta pomocí AzureOpenAIClientgpt-4o-mini a vlastních pokynů.

Ukázkový kód

Nezapomeňte nahradit https://your-resource.openai.azure.com/ koncovým bodem vašeho prostředku 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."));

(Volitelné) Instalace nočních balíčků

Pokud potřebujete získat balíček obsahující nejnovější vylepšení nebo opravy, jsou noční buildy rozhraní Agent Framework k dispozici na https://github.com/orgs/microsoft/packages?repo_name=agent-frameworkadrese .

Pokud chcete stáhnout noční buildy, postupujte takto:

  1. K provedení těchto kroků budete potřebovat účet GitHubu.

  2. Pomocí těchto read:packages vytvořte osobní přístupový token GitHubu s oborem.

  3. Pokud je váš účet součástí organizace Microsoft, musíte organizaci autorizovat Microsoft jako organizaci jednotného přihlašování.

    1. Klikněte na „Konfigurovat SSO“ vedle právě vytvořeného osobního přístupového tokenu a poté autorizujte Microsoft.

  4. Pomocí následujícího příkazu přidejte zdroj Microsoft GitHub Packages do konfigurace 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. Nebo můžete NuGet.Config soubor vytvořit ručně.

    <?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>
    • Pokud tento soubor umístíte do složky projektu, ujistěte se, že Git (nebo jakýkoliv jiný systém správy verzí, který používáte) tento soubor ignoruje.
    • Další informace o tom, kam chcete tento soubor uložit, najdete vnuget.config referenčních informacích.

  6. Nyní můžete přidávat balíčky z nočního sestavení do projektu.

    Použijte například tento příkaz. dotnet add package Microsoft.Agents.AI --prerelease

  7. Na nejnovější verzi balíčku se dá odkazovat v projektu takto:

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

Další informace najdete v tématu https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.

Požadavky

Než začnete, ujistěte se, že máte následující:

Poznámka:

Tato ukázka používá k ověřování přihlašovací údaje Azure CLI. Ujistěte se, že jste přihlášeni pomocí az login a máte přístup k projektu Azure AI. Další informace najdete v dokumentaci k Azure CLI.

Spuštění základního příkladu agenta

Tato ukázka ukazuje, jak vytvořit a použít jednoduchého agenta AI s Azure AI jako back-endem. Vytvoří základního agenta pomocí ChatAgentAzureAIAgentClient a vlastních pokynů.

Nezapomeňte nastavit následující proměnné prostředí:

  • AZURE_AI_PROJECT_ENDPOINT: Koncový bod projektu Azure AI
  • AZURE_AI_MODEL_DEPLOYMENT_NAME: Název nasazení modelu

Ukázkový kód

import asyncio
from agent_framework import ChatAgent
from agent_framework.azure import AzureAIAgentClient
from azure.identity.aio import AzureCliCredential

async def main():
    async with (
        AzureCliCredential() as credential,
        ChatAgent(
            chat_client=AzureAIAgentClient(async_credential=credential),
            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())

Další příklady

Podrobnější příklady a pokročilé scénáře najdete v příkladech agenta Azure AI.

Další kroky

Vytváření a spouštění agentů

  • Last updated on