Руководство по быстрому запуску Microsoft Agent Framework

Предпосылки

Прежде чем начать, убедитесь, что у вас есть следующее:

• Пакет SDK для .NET 8.0 или более поздней версии
• Ресурс Azure OpenAI с развернутой моделью (например, gpt-4o-mini)
• Установленный и прошедший проверку подлинности Azure CLI (az login)
• У пользователя есть роли Cognitive Services OpenAI User или Cognitive Services OpenAI Contributor для ресурса Azure OpenAI.

Создание проекта

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

Установка пакетов

Пакеты будут опубликованы на галерее NuGet | MicrosoftAgentFramework.

Сначала добавьте в приложение следующие пакеты NuGet Microsoft Agent Framework, используя следующие команды:

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

Запуск примера базового агента

В этом примере показано, как создать и использовать простой агент ИИ с использованием завершения чата Azure OpenAI в качестве бэкенда. Он создаст базового агента, используя AzureOpenAIClient с gpt-4o-mini и пользовательскими инструкциями.

Пример кода

Обязательно замените https://your-resource.openai.azure.com/ на конечную точку вашего ресурса 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."));

(Необязательно) Установите ночные пакеты

Если вам нужно получить пакет, включающий последние улучшения или исправления, ночные сборки Agent Framework доступны по адресу https://github.com/orgs/microsoft/packages?repo_name=agent-framework.

Чтобы скачать ночные сборки, выполните следующие действия.

1. Для выполнения этих действий потребуется учетная запись GitHub.

2. Создайте личный маркер доступа GitHub с областью read:packages , используя эти инструкции.

3. Если ваша учетная запись является частью организации Майкрософт, необходимо авторизовать Microsoft организацию как организацию единого входа.

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

4. Чтобы добавить источник пакетов Microsoft GitHub в конфигурацию 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. Вы также можете создать NuGet.Config файл вручную.

   <?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>
   

   • Если вы поместите этот файл в папку проекта, не забудьте сделать так, чтобы Git (или любая используемая вами система контроля версий) игнорировал его.
   • Дополнительные сведения о том, где хранить этот файл, см. в справочнике nuget.config.

6. Теперь вы можете добавить пакеты из ночной сборки в проект.

   Например, используйте эту команду. dotnet add package Microsoft.Agents.AI --prerelease

7. Последняя версия пакета может быть указана в проекте следующим образом:

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

Дополнительные сведения см. в разделе https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.

Предпосылки

Прежде чем начать, убедитесь, что у вас есть следующее:

• Python 3.10 или более поздней версии
• Проект ИИ Azure с развернутой моделью (например, gpt-4o-mini)
• Установлен и аутентифицирован Azure CLI (az login)

Запуск примера базового агента

В этом примере показано, как создать и использовать простой агент ИИ с Azure в качестве серверной части. Он создаст базового агента, используя ChatAgent с AzureAIAgentClient и пользовательскими инструкциями.

Обязательно задайте следующие переменные среды:

• AZURE_AI_PROJECT_ENDPOINT: конечная точка проекта Azure AI
• AZURE_AI_MODEL_DEPLOYMENT_NAME: имя развертывания модели

Пример кода

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

Дополнительные примеры

Более подробные примеры и расширенные сценарии см. в примерах агента ИИ Azure.