Агент на основе любого клиента чата

Microsoft Agent Framework поддерживает создание агентов для любой службы инференции, которая предоставляет реализацию Microsoft.Extensions.AI.IChatClient. Это означает, что существует очень широкий спектр служб, которые можно использовать для создания агентов, включая модели с открытым исходным кодом, которые могут выполняться локально.

В этой статье в качестве примера используется Ollama.

Начало работы

Добавьте необходимые пакеты NuGet в проект.

dotnet add package Microsoft.Agents.AI --prerelease

Вам также потребуется добавить пакет для конкретной IChatClient реализации, которую вы хотите использовать. В этом примере используется OllamaSharp.

dotnet add package OllamaSharp

Создайте ChatClientAgent

Чтобы создать агент на IChatClient основе интерфейса, можно использовать ChatClientAgent класс. Класс ChatClientAgent принимает IChatClient в качестве параметра конструктора.

Сначала создайте OllamaApiClient, чтобы получить доступ к службе Ollama.

using System;
using Microsoft.Agents.AI;
using OllamaSharp;

using OllamaApiClient chatClient = new(new Uri("http://localhost:11434"), "phi3");

OllamaApiClient Реализует IChatClient интерфейс, поэтому его можно использовать для созданияChatClientAgent.

AIAgent agent = new ChatClientAgent(
    chatClient,
    instructions: "You are good at telling jokes.",
    name: "Joker");

// Invoke the agent and output the text result.
Console.WriteLine(await agent.RunAsync("Tell me a joke about a pirate."));

Это важно

Чтобы убедиться, что вы получаете максимум от вашего агента, обязательно выберите службу и модель, которая хорошо подходит для выполнения разговорных задач и поддерживает вызов функций.

Использование агента

Агент стандартный AIAgent и поддерживает все стандартные операции агента.

Дополнительные сведения о запуске и взаимодействии с агентами см. в руководствах по началу работы агента.

Microsoft Agent Framework поддерживает создание агентов для любой службы инференции, которая обеспечивает реализацию клиента чата, совместимую с ChatClientProtocol. Это означает, что существует очень широкий спектр служб, которые можно использовать для создания агентов, включая модели с открытым исходным кодом, которые могут выполняться локально.

Начало работы

Добавьте необходимые пакеты Python в проект.

pip install agent-framework --pre

Также может потребоваться добавить пакеты для конкретных реализаций клиентов чата, которые вы хотите использовать:

# For Azure AI
pip install agent-framework-azure-ai --pre

# For custom implementations
# Install any required dependencies for your custom client

Встроенные клиенты чата

Платформа предоставляет несколько встроенных реализаций клиентов чата:

Клиент чата OpenAI

from agent_framework import ChatAgent
from agent_framework.openai import OpenAIChatClient

# Create agent using OpenAI
agent = ChatAgent(
    chat_client=OpenAIChatClient(model_id="gpt-4o"),
    instructions="You are a helpful assistant.",
    name="OpenAI Assistant"
)

Клиент Чата Azure OpenAI

from agent_framework import ChatAgent
from agent_framework.azure import AzureOpenAIChatClient

# Create agent using Azure OpenAI
agent = ChatAgent(
    chat_client=AzureOpenAIChatClient(
        model_id="gpt-4o",
        endpoint="https://your-resource.openai.azure.com/",
        api_key="your-api-key"
    ),
    instructions="You are a helpful assistant.",
    name="Azure OpenAI Assistant"
)

Клиент агента ИИ Azure

from agent_framework import ChatAgent
from agent_framework.azure import AzureAIAgentClient
from azure.identity.aio import AzureCliCredential

# Create agent using Azure AI
async with AzureCliCredential() as credential:
    agent = ChatAgent(
        chat_client=AzureAIAgentClient(async_credential=credential),
        instructions="You are a helpful assistant.",
        name="Azure AI Assistant"
    )

Это важно

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

Использование агента

Агент поддерживает все стандартные операции агента.

Дополнительные сведения о запуске и взаимодействии с агентами см. в руководствах по началу работы агента.

Дальнейшие шаги

Agent2Agent