Agente baseado em qualquer "IChatClient"

O Microsoft Agent Framework dá suporte à criação de agentes para qualquer serviço de inferência que forneça uma Microsoft.Extensions.AI.IChatClient implementação. Isso significa que há uma ampla gama de serviços que podem ser usados para criar agentes, incluindo modelos de software livre que podem ser executados localmente.

Neste documento, usaremos o Ollama como exemplo.

Introdução

Adicione os pacotes NuGet necessários ao seu projeto.

dotnet add package Microsoft.Agents.AI --prerelease

Você também precisará adicionar o pacote para a implementação específica IChatClient que deseja usar. Neste exemplo, usaremos o OllamaSharp.

dotnet add package OllamaSharp

Criando um ChatClientAgent

Para criar um agente com base na IChatClient interface, você pode usar a ChatClientAgent classe. A ChatClientAgent classe usa IChatClient como um parâmetro de construtor.

Primeiro, crie um OllamaApiClient para acessar o serviço Ollama.

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

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

A OllamaApiClient implementa a IChatClient interface, para que você possa usá-la para criar uma 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."));

Usando o agente

O agente é um padrão AIAgent e dá suporte a todas as operações de agente padrão.

Consulte os tutoriais de introdução do Agente para obter mais informações sobre como executar e interagir com agentes.

O Microsoft Agent Framework dá suporte à criação de agentes para qualquer serviço de inferência que forneça uma implementação de cliente de chat compatível com o ChatClientProtocol. Isso significa que há uma ampla gama de serviços que podem ser usados para criar agentes, incluindo modelos de software livre que podem ser executados localmente.

Introdução

Adicione os pacotes do Python necessários ao seu projeto.

pip install agent-framework --pre

Talvez você também precise adicionar pacotes para implementações específicas do cliente de chat que deseja usar:

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

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

Clientes de chat internos

A estrutura fornece várias implementações internas do cliente de chat:

Cliente de chat do 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"
)

Cliente de chat do 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"
)

Cliente do Agente de IA do 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"
    )

Usando o agente

O agente dá suporte a todas as operações de agente padrão.

Consulte os tutoriais de introdução do Agente para obter mais informações sobre como executar e interagir com agentes.