Руководство по созданию агентного веб-приложения в Службе приложений Azure с помощью Microsoft Agent Framework или Службы агента Foundry (.NET)

Инициализируется AgentFrameworkProvider в Services/AgentFrameworkProvider.cs. Код инициализации выполняет следующие действия:

• Создает объект IChatClient из Azure OpenAI с помощью AzureOpenAIClient.
• TaskCrudTool Возвращает экземпляр, который инкапсулирует функциональные возможности приложения CRUD (в Tools/TaskCrudTool.cs). Атрибуты Description методов инструментов помогают агенту определить способ их вызова.
• Создает агент ИИ с инструкциями CreateAIAgent() и инструментами, зарегистрированными с помощью AIFunctionFactory.Create().
• Создает поток для агента, чтобы сохранять состояние беседы при переходах навигации.

// 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);

Каждый раз, когда пользователь отправляет сообщение, компонент Blazor (в components/Pages/AgentFrameworkAgent.razor) вызывается Agent.RunAsync() с помощью входных данных пользователя и потока агента. Поток агента отслеживает историю чата.

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

Поставщик FoundryAgentProvider инициализирован в Services/FoundryAgentProvider.cs. Код инициализации выполняет следующие действия:

• Создает AIProjectClient с использованием конечной точки проекта Foundry.
• Получает существующего агента из Microsoft Foundry по его имени.
• Создает диалог для сеанса работы с браузером.
• ProjectResponsesClient Возвращает агент и беседу.

// 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);

Этот код инициализации не определяет какие-либо функциональные возможности агента, так как обычно создается агент на портале Foundry. В рамках примера сценария он также следует шаблону OpenAPI, показанному в разделе "Добавление приложения службы приложений в качестве инструмента" в Службе агента Foundry (.NET) и делает его функциональные возможности CRUD доступными в качестве конечной точки OpenAPI. Это позволяет добавить его в агент позже в качестве вызываемой функции.

Код OpenAPI определен в Program.cs. Например, API "get tasks" определяет ID операции с помощью WithName(), как требуется средством спецификации OpenAPI в Microsoft Foundry, и WithDescription() помогает агенту определить, как вызвать API.

app.MapOpenApi();

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

Каждый раз, когда пользователь отправляет сообщение, компонент Blazor (в компонентах/Pages/FoundryAgent.razor) вызывает ResponseClient.CreateResponseAsync() с входными данными пользователя. Клиент ответа использует идентификатор беседы для отслеживания журнала чата.

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

1. На портале Foundry убедитесь, что верхний переключатель New Foundry установлен в положение "активный", и затем создайте проект.

2. Разверните модель выбранного варианта (см. краткое руководство по Microsoft Foundry: создание ресурсов).

3. В верхней части игровой площадки модели скопируйте имя модели.

4. Самый простой способ получить конечную точку Azure OpenAI по-прежнему с классического портала. Нажмите переключатель New Foundry, затем выберите Azure OpenAI, а потом скопируйте URL-адрес в Azure OpenAI endpoint на будущее.

   

1. На портале Foundry убедитесь, что верхний переключатель New Foundry установлен в положение "активный", и затем создайте проект.

2. На домашней странице скопируйте конечную точку проекта для последующего использования.

3. Нажмите кнопку "Начать создание> и следуйте запросу.

4. На игровой площадке нового агента создайте средство OpenAPI для вызова вашего веб-приложения, выбрав Инструменты>Добавить>Пользовательское>Средство OpenAPI>Создать. В области установки добавьте действие с помощью средства спецификации OpenAPI. Используйте схему OpenAPI, полученную из развернутого веб-приложения и анонимной проверки подлинности. Подробные инструкции см. в разделе "Использование средства спецификации OpenAPI".

   Ваш код приложения уже настроен, чтобы включать url и operationId сервера, которые необходимы агенту. Дополнительные сведения см. в разделе "Подключение к спецификации OpenAPI".

5. Не забудьте нажать кнопку "Сохранить".

6. Выберите "Попробовать на игровой площадке" и протестируйте агент Foundry с помощью запросов, таких как "Показать мне все задачи" и "Добавьте задачу".

   Если вы получаете допустимый ответ, агент совершает вызовы инструментов к конечной точке OpenAPI в вашем развернутом веб-приложении.

1. В верхнем меню нового портала Foundry выберите "Работа", а затем выберите "Администратор". В строке проекта Foundry вы увидите две ссылки. Один из столбцов Name — ресурс проекта Foundry, а в столбце "Родительский ресурс" — ресурс Foundry.

   

2. Выберите ресурс Foundry в родительском ресурсе и выберите "Управление этим ресурсом" на портале Azure. На портале Azure можно назначить роль для доступа к ресурсу, развернутому в веб-приложении.

3. Добавьте следующую роль для управляемого удостоверения приложения службы приложений:

   Целевой ресурс	Требуемая роль	Требуется для
   Литейный завод	Пользователь когнитивных сервисов OpenAI	Служба завершения чата в Microsoft Agent Framework.

   Инструкции см. в разделе Назначение ролей Azure с помощью портала Azure.

1. В верхнем меню нового портала Foundry выберите "Работа", а затем выберите "Администратор". В строке проекта Foundry вы увидите две ссылки. Один из столбцов Name — ресурс проекта Foundry, а в столбце "Родительский ресурс" — ресурс Foundry.

   

2. Выберите ресурс проекта Foundry в столбце "Имя" , а затем выберите "Управление этим ресурсом" на портале Azure. На портале Azure можно назначить роль для доступа к ресурсу, развернутому в веб-приложении.

3. Добавьте следующую роль для управляемого удостоверения приложения службы приложений:

   Целевой ресурс	Требуемая роль	Требуется для
   Проект Foundry	Пользователь Foundry	Чтение и вызов агента Foundry.

   Инструкции см. в разделе Назначение ролей Azure с помощью портала Azure.