Agente que utiliza IChatClient

Microsoft Agent Framework admite la creación de agentes para cualquier servicio de inferencia que proporcione una Microsoft.Extensions.AI.IChatClient implementación. Esto significa que hay una amplia gama de servicios que se pueden usar para crear agentes, incluidos los modelos de código abierto que se pueden ejecutar localmente.

En este documento, usaremos Ollama como ejemplo.

Introducción

Agregue los paquetes NuGet necesarios al proyecto.

dotnet add package Microsoft.Agents.AI --prerelease

También deberá agregar el paquete para la implementación específica IChatClient que desea usar. En este ejemplo, usaremos OllamaSharp.

dotnet add package OllamaSharp

Crear un ChatClientAgent

Para crear un agente basado en la IChatClient interfaz, puede usar la ChatClientAgent clase . La ChatClientAgent clase toma IChatClient como parámetro de constructor.

En primer lugar, cree un OllamaApiClient para acceder al servicio Ollama.

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

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

OllamaApiClient implementa la IChatClient interfaz , por lo que puede usarla para crear un 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."));

Uso del agente

El agente es un estándar AIAgent y admite todas las operaciones estándar.

Consulte los tutoriales de introducción del agente para obtener más información sobre cómo ejecutar e interactuar con agentes.

Microsoft Agent Framework admite la creación de agentes para cualquier servicio de inferencia que proporcione una implementación de cliente de chat compatible con ChatClientProtocol. Esto significa que hay una amplia gama de servicios que se pueden usar para crear agentes, incluidos los modelos de código abierto que se pueden ejecutar localmente.

Introducción

Agregue los paquetes de Python necesarios al proyecto.

pip install agent-framework --pre

También puede que tenga que agregar paquetes para implementaciones de cliente de chat específicas que quiera 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 integrados

El marco proporciona varias implementaciones de cliente de chat integradas:

Cliente de chat de 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 de 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 del agente de Azure AI

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

Uso del agente

El agente admite todas las operaciones de agente estándar.

Consulte los tutoriales de introducción del agente para obtener más información sobre cómo ejecutar e interactuar con agentes.