Partager via

Microsoft Agent Framework Guide de démarrage rapide

Ce guide vous aidera à être opérationnel rapidement avec un agent de base à l’aide d’Agent Framework et d’Azure OpenAI.

Prerequisites

Avant de commencer, vérifiez que vous disposez des éléments suivants :

Note

Microsoft Agent Framework est pris en charge avec toutes les versions activement prises en charge de .NET. Pour les besoins de cet exemple, nous vous recommandons le Kit de développement logiciel (SDK) .NET 8 ou une version ultérieure.

Note

Cette démonstration utilise les informations d’identification Azure CLI pour l’authentification. Assurez-vous d'être connecté avec az login et d'avoir accès à la ressource Azure OpenAI. Pour plus d’informations, consultez la documentation Azure CLI. Il est également possible de remplacer l’élément AzureCliCredential par une ApiKeyCredential clé API si vous disposez d’une clé API et que vous ne souhaitez pas utiliser l’authentification basée sur les rôles, auquel cas az login il n’est pas nécessaire.

Création d’un projet

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

Installer des packages

Les packages seront publiés dans la galerie NuGet | MicrosoftAgentFramework.

Tout d’abord, ajoutez les packages NuGet Microsoft Agent Framework suivants à votre application à l’aide des commandes suivantes :

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

Exécution d’un exemple d'application d’agent de base

Cet exemple montre comment créer et utiliser un agent d'IA simple avec l'achèvement du chat Azure OpenAI comme back-end. Il créera un agent de base à l’aide de AzureOpenAIClient et de gpt-4o-mini, avec des instructions personnalisées.

Exemple de code

Veillez à remplacer https://your-resource.openai.azure.com/ par le point de terminaison de votre ressource 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."));

(Facultatif) Installer des versions nocturnes

Si vous devez obtenir un package contenant les dernières améliorations ou correctifs, les builds nocturnes d’Agent Framework sont disponibles à l’adresse https://github.com/orgs/microsoft/packages?repo_name=agent-framework.

Pour télécharger des builds nocturnes, procédez comme suit :

  1. Vous aurez besoin d’un compte GitHub pour effectuer ces étapes.

  2. Créez un jeton d’accès personnel GitHub avec l’étendue read:packages en utilisant ces instructions.

  3. Si votre compte fait partie de l’organisation Microsoft, vous devez autoriser l’organisation Microsoft en tant qu’organisation d’authentification unique.

    1. Cliquez sur « Configurer l’authentification unique » à côté du jeton d'accès personnel que vous venez de créer. Ensuite, autorisez Microsoft.

  4. Utilisez la commande suivante pour ajouter la source Microsoft GitHub Packages à votre configuration 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. Vous pouvez également créer manuellement un NuGet.Config fichier.

    <?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>
    • Si vous placez ce fichier dans votre dossier de projet, veillez à ce que Git (ou le système de contrôle de version que vous utilisez) l'ignore.
    • Pour plus d’informations sur l’emplacement de stockage de ce fichier, consultez nuget.config référence.

  6. Vous pouvez maintenant ajouter des packages à partir de la build nocturne à votre projet.

    Par exemple, utilisez cette commande dotnet add package Microsoft.Agents.AI --prerelease

  7. Et la dernière version du package peut être référencée dans le projet comme suit :

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

Pour plus d’informations, consultez https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.

Prerequisites

Avant de commencer, vérifiez que vous disposez des éléments suivants :

pip install -U agent-framework --pre

Note

L'installation de agent-framework installera agent-framework-core ainsi que tous les autres paquets officiels. Si vous souhaitez installer uniquement le package Azure AI, vous pouvez exécuter : pip install agent-framework-azure-ai --pre tous les packages officiels, y compris agent-framework-azure-ai avoir une dépendance sur agent-framework-core, donc dans la plupart des cas, vous n’avez pas à spécifier cela. Vous trouverez la liste complète des packages officiels dans le référentiel GitHub Agent Framework.

Note

Cet exemple utilise les informations d’identification Azure CLI pour l’authentification. Vérifiez que vous êtes connecté avec az login et que vous avez accès au projet Azure AI. Pour plus d’informations, consultez la documentation Azure CLI.

Exécution d’un exemple d'application d’agent de base

Cet exemple montre comment créer et utiliser un agent IA simple avec Azure AI en tant que back-end. Il créera un agent de base à l’aide de ChatAgent et de AzureAIAgentClient, avec des instructions personnalisées.

Veillez à définir les variables d’environnement suivantes :

  • AZURE_AI_PROJECT_ENDPOINT: point de terminaison de votre projet Azure AI
  • AZURE_AI_MODEL_DEPLOYMENT_NAME: nom de votre déploiement de modèle

Exemple de code

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

Autres exemples

Pour obtenir des exemples plus détaillés et des scénarios avancés, consultez les exemples Azure AI.

Étapes suivantes

Créer et exécuter des agents

  • Last updated on