Tutoriel : Créer une application web agentique dans Azure App Service avec Microsoft Agent Framework ou Foundry Agent Service (.NET)

Le AgentFrameworkProvider est initialisé dans Services/AgentFrameworkProvider.cs. Le code d’initialisation effectue les opérations suivantes :

• Crée un IChatClient à partir d’Azure OpenAI à l’aide du AzureOpenAIClient.
• Obtient l’instance TaskCrudTool qui encapsule les fonctionnalités de l’application CRUD (dans Tools/TaskCrudTool.cs). Les attributs Description des méthodes de l'outil aident l’agent à déterminer comment les appeler.
• Crée un agent IA avec CreateAIAgent() avec des instructions et des outils enregistrés via AIFunctionFactory.Create().
• Crée un thread pour que l'agent puisse persister la conversation lors de la navigation.

// Create IChatClient
IChatClient chatClient = new AzureOpenAIClient(
        new Uri(endpoint),
        new DefaultAzureCredential())
    .GetChatClient(deployment)
    .AsIChatClient();

// Get TaskCrudTool instance from service provider
var taskCrudTool = sp.GetRequiredService<TaskCrudTool>();

// Create agent with tools
var agent = chatClient.CreateAIAgent(
    instructions: @"You are an agent that manages tasks using CRUD operations. 
        Use the provided functions to create, read, update, and delete tasks. 
        Always call the appropriate function for any task management request.
        Don't try to handle any requests that are not related to task management.
        When handling requests, if you're missing any information, don't make it up but prompt the user for it instead.",
    tools:
    [
        AIFunctionFactory.Create(taskCrudTool.CreateTaskAsync),
        AIFunctionFactory.Create(taskCrudTool.ReadTasksAsync),
        AIFunctionFactory.Create(taskCrudTool.UpdateTaskAsync),
        AIFunctionFactory.Create(taskCrudTool.DeleteTaskAsync)
    ]);

// Create thread for this scoped instance (persists across navigation)
var thread = agent.GetNewThread();

return (agent, thread);

Chaque fois que l’utilisateur envoie un message, le composant Blazor (dans Components/Pages/AgentFrameworkAgent.razor) appelle Agent.RunAsync() avec le message de l'utilisateur et le thread de l’agent. Le thread de l’agent effectue le suivi de l’historique des conversations.

var response = await this.Agent.RunAsync(sentInput, this.agentThread);

Le FoundryAgentProvider fournisseur est initialisé dans Services/FoundryAgentProvider.cs. Le code d’initialisation effectue les opérations suivantes :

• Crée un AIProjectClient à l’aide de l’endpoint de projet Foundry.
• Obtient un agent existant à partir de Microsoft Foundry par nom.
• Crée une conversation pour la session du navigateur.
• Obtient un ProjectResponsesClient pour l’agent et la conversation.

// Create project client
var projectClient = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential());

// Get an existing agent from Microsoft Foundry
var agent = projectClient.Agents.GetAgent(agentName);

// Get conversations client for retrieving history
var conversationsClient = projectClient.OpenAI.Conversations;

// Create conversation for this browser session
var conversation = conversationsClient.CreateProjectConversation().Value;

// Get response client for this agent and conversation
var responseClient = projectClient.OpenAI.GetProjectResponsesClientForAgent(agentName, conversation.Id);

return (responseClient, conversation, conversationsClient);

Ce code d’initialisation ne définit aucune fonctionnalité pour l’agent, car vous générez généralement l’agent dans le portail Foundry. Dans le cadre de l’exemple de scénario, il suit également le modèle OpenAPI présenté dans Ajouter une application App Service en tant qu’outil dans Foundry Agent Service (.NET) et rend ses fonctionnalités CRUD disponibles en tant que point de terminaison OpenAPI. Cela vous permet de l’ajouter à l’agent ultérieurement en tant qu’outil que vous pouvez appeler.

Le code OpenAPI est défini dans Program.cs. Par exemple, l’API « get tasks » définit l’ID d’opération avec WithName(), comme requis par l’outil de spécification OpenAPI dans Microsoft Foundry, et WithDescription() aide l’agent à déterminer comment appeler l’API :

app.MapOpenApi();

app.MapGet("/api/tasks", async (TaskService taskService) =>
{
    return Results.Ok(await taskService.GetAllTasksAsync());
})
.WithDescription("Gets all tasks.")
.WithName("GetAllTasks");

Chaque fois que l’utilisateur envoie un message, le composant Blazor (dans Components/Pages/FoundryAgent.razor) appelle ResponseClient.CreateResponseAsync() avec l’entrée de l’utilisateur. Le client de réponse utilise l’ID de conversation pour suivre l’historique des conversations.

#pragma warning disable OPENAI001
var response = await FoundryProvider.ResponseClient.CreateResponseAsync(sentInput);
#pragma warning restore OPENAI001

1. Dans le portail Foundry, vérifiez que le bouton radio "New Foundry" en haut est activé et créez un projet.

2. Déployez un modèle de votre choix (consultez Démarrage rapide Microsoft Foundry : Créer des ressources).

3. Depuis le haut du model playground, copiez le nom du modèle.

4. Le moyen le plus simple d’obtenir le point de terminaison Azure OpenAI est toujours à partir du portail Classic. Sélectionnez le bouton radio New Foundry, puis Azure OpenAI, et copiez l’URL dans le point d'accès Azure OpenAI pour plus tard.

   

1. Dans le portail Foundry, vérifiez que le bouton radio "New Foundry" en haut est activé et créez un projet.

2. Dans la page d’accueil, copiez le point de terminaison Project pour plus tard.

3. Sélectionnez Démarrer la création>Créer un agent et suivez l’invite.

4. Dans le nouvel espace de l'agent, créez un outil OpenAPI pour appeler votre application web en sélectionnant Outils>Ajouter>Personnalisé>Outil OpenAPI>Créer. Dans le volet Installation , ajoutez une action avec l’outil de spécification OpenAPI. Utilisez le schéma OpenAPI que vous obtenez à partir de l’application web déployée et de l’authentification anonyme . Pour obtenir des instructions détaillées, consultez Comment utiliser l’outil de spécification OpenAPI.

   Votre code d’application est déjà configuré pour inclure le url et le operationId du serveur, ce qui est nécessaire pour l’agent. Pour plus d’informations, voir Se connecter à la spécification OpenAPI.

5. Veillez à sélectionner Enregistrer.

6. Sélectionnez Essayer dans le terrain de jeu et tester votre agent Foundry avec des invites telles que « Afficher toutes les tâches » et « Veuillez ajouter une tâche ».

   Si vous obtenez une réponse valide, l’agent effectue des appels d’outil au point de terminaison OpenAPI sur votre application web déployée.

1. Dans le menu supérieur du nouveau portail Foundry, sélectionnez Utiliser, puis sélectionnez Administrateur. Dans la ligne de votre projet Foundry, vous devez voir deux liens. La colonne Name est la ressource de projet Foundry, et celle de la colonne de ressource Parent est la ressource Foundry.

   

2. Sélectionnez la ressource Foundry dans la ressource parente , puis sélectionnez Gérer cette ressource dans le portail Azure. À partir du portail Azure, vous pouvez attribuer un accès en fonction du rôle pour la ressource à l’application web déployée.

3. Ajoutez le rôle suivant pour l’identité managée de l’application App Service :

   Ressource cible	Rôle requis	Nécessaire pour
   Fonderie	Utilisateur OpenAI de Cognitive Services	Service d’achèvement de conversation dans Microsoft Agent Framework.

   Pour obtenir des instructions, consultez Attribuer des rôles Azure à l’aide du portail Azure.

1. Dans le menu supérieur du nouveau portail Foundry, sélectionnez Utiliser, puis sélectionnez Administrateur. Dans la ligne de votre projet Foundry, vous devez voir deux liens. La colonne Name est la ressource de projet Foundry, et celle de la colonne de ressource Parent est la ressource Foundry.

   

2. Sélectionnez la ressource de projet Foundry dans la colonne Nom , puis sélectionnez Gérer cette ressource dans le portail Azure. À partir du portail Azure, vous pouvez attribuer un accès en fonction du rôle pour la ressource à l’application web déployée.

3. Ajoutez le rôle suivant pour l’identité managée de l’application App Service :

   Ressource cible	Rôle requis	Nécessaire pour
   Projet de fonderie	Utilisateur Azure AI	Lecture et appel de l’agent Foundry.

   Pour obtenir des instructions, consultez Attribuer des rôles Azure à l’aide du portail Azure.