Condividi tramite

Guida Quick-Start di Microsoft Agent Framework

Questa guida consente di iniziare rapidamente a usare un agente di base usando Agent Framework e Azure OpenAI.

Prerequisiti

Prima di iniziare, assicurarsi di disporre degli elementi seguenti:

Annotazioni

Microsoft Agent Framework è supportato con tutte le versioni supportate attivamente di .NET. Ai fini di questo esempio, è consigliabile usare .NET 8 SDK o una versione successiva.

Annotazioni

Questa demo usa le credenziali dell'interfaccia della riga di comando di Azure per l'autenticazione. Assicurati di aver eseguito l'accesso az login e di avere accesso alla risorsa Azure OpenAI. Per altre informazioni, vedere la documentazione dell'interfaccia della riga di comando di Azure. È anche possibile sostituire AzureCliCredential con con se ApiKeyCredential si dispone di una chiave API e non si vuole usare l'autenticazione basata su ruoli, nel qual caso az login non è necessario.

Creare un progetto

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

Installare pacchetti

I pacchetti verranno pubblicati in NuGet Gallery | MicrosoftAgentFramework.

Aggiungere prima di tutto i pacchetti NuGet di Microsoft Agent Framework seguenti all'applicazione usando i comandi seguenti:

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

Esecuzione di un esempio di agente di base

Questo esempio illustra come creare e usare un semplice agente di intelligenza artificiale con Completamento chat OpenAI di Azure come back-end. Creerà un agente di base usando AzureOpenAIClient e gpt-4o-mini istruzioni personalizzate.

Codice di esempio

Assicurarsi di sostituire https://your-resource.openai.azure.com/ con l'endpoint della risorsa OpenAI di Azure.

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

(Facoltativo) Installare pacchetti notturni

Se è necessario ottenere un pacchetto contenente i miglioramenti o le correzioni più recenti, le build notturne di Agent Framework sono disponibili all'indirizzo https://github.com/orgs/microsoft/packages?repo_name=agent-framework.

Per scaricare le build notturne, seguire questa procedura:

  1. Per completare questi passaggi, è necessario un account GitHub.

  2. Creare un token di accesso personale GitHub con l'ambito read:packages usando queste istruzioni.

  3. Se l'account fa parte dell'organizzazione Microsoft, è necessario autorizzare l'organizzazione come ente per l'accesso Single Sign-On Microsoft.

    1. Fare clic su "Configura SSO" accanto al token di accesso personale appena creato e quindi autorizzare Microsoft.

  4. Usare il comando seguente per aggiungere l'origine Microsoft GitHub Packages alla configurazione di 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. In alternativa, è possibile creare manualmente un NuGet.Config file.

    <?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>
    • Se inserisci questo file nella cartella del tuo progetto, assicurati di configurare Git (o qualsiasi sistema di controllo del codice sorgente che utilizzi) per ignorarlo.
    • Per altre informazioni sulla posizione in cui archiviare questo file, vedere nuget.config riferimento.

  6. È ora possibile aggiungere pacchetti dalla compilazione notturna al progetto.

    Ad esempio, usare questo comando dotnet add package Microsoft.Agents.AI --prerelease

  7. È anche possibile fare riferimento alla versione più recente del pacchetto nel progetto come segue:

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

Per altre informazioni, vedere https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.

Prerequisiti

Prima di iniziare, assicurarsi di disporre degli elementi seguenti:

pip install -U agent-framework --pre

Annotazioni

L'installazione agent-framework installerà agent-framework-core e tutti gli altri pacchetti ufficiali. Se desideri installare solo il pacchetto Azure AI, è possibile eseguire: pip install agent-framework-azure-ai --pre Tutti i pacchetti ufficiali, incluso agent-framework-azure-ai, hanno una dipendenza da agent-framework-core, quindi nella maggior parte dei casi non è necessario specificarlo. L'elenco completo dei pacchetti ufficiali è disponibile nel repository GitHub di Agent Framework.

Annotazioni

Questo esempio usa le credenziali dell'interfaccia della riga di comando di Azure per l'autenticazione. Assicurarsi di aver eseguito l'accesso con az login e di avere accesso al progetto di intelligenza artificiale di Azure. Per altre informazioni, vedere la documentazione dell'interfaccia della riga di comando di Azure.

Esecuzione di un esempio di agente di base

Questo esempio illustra come creare e usare un semplice agente di intelligenza artificiale con Intelligenza artificiale di Azure come back-end. Creerà un agente di base usando ChatAgent e AzureAIAgentClient istruzioni personalizzate.

Assicurarsi di impostare le variabili di ambiente seguenti:

  • AZURE_AI_PROJECT_ENDPOINT: l'endpoint del progetto di Intelligenza artificiale di Azure
  • AZURE_AI_MODEL_DEPLOYMENT_NAME: nome della distribuzione del modello

Codice di esempio

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

Altri esempi

Per esempi più dettagliati e scenari avanzati, vedere Esempi di intelligenza artificiale di Azure.

Passaggi successivi

Creare ed eseguire agenti

  • Last updated on