Agent basé sur n’importe quel IChatClient

Microsoft Agent Framework prend en charge la création d’agents pour tout service d’inférence qui fournit une Microsoft.Extensions.AI.IChatClient implémentation. Cela signifie qu’il existe un large éventail de services qui peuvent être utilisés pour créer des agents, y compris des modèles open source qui peuvent être exécutés localement.

Dans ce document, nous allons utiliser Ollama comme exemple.

Getting Started

Ajoutez les packages NuGet requis à votre projet.

dotnet add package Microsoft.Agents.AI --prerelease

Vous devez également ajouter le package pour l’implémentation spécifique IChatClient que vous souhaitez utiliser. Dans cet exemple, nous allons utiliser OllamaSharp.

dotnet add package OllamaSharp

Création d’un ChatClientAgent

Pour créer un agent basé sur l’interface IChatClient , vous pouvez utiliser la ChatClientAgent classe. La ChatClientAgent classe prend IChatClient comme paramètre de constructeur.

Tout d’abord, créez un OllamaApiClient pour accéder au service Ollama.

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

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

OllamaApiClient implémente l'interface IChatClient, donc vous pouvez l'utiliser pour créer 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."));

Important

Pour vous assurer de tirer le meilleur parti de votre agent, veillez à choisir un service et un modèle adapté aux tâches conversationnelles et prend en charge l’appel de fonction.

Utilisation de l’agent

L’agent est standard AIAgent et prend en charge toutes les opérations d’agent standard.

Pour plus d’informations sur l’exécution et l’interaction avec les agents, consultez les didacticiels de prise en main de l’agent .

Microsoft Agent Framework prend en charge la création d’agents pour n’importe quel service d’inférence qui fournit une implémentation cliente de conversation compatible avec le ChatClientProtocol. Cela signifie qu’il existe un large éventail de services qui peuvent être utilisés pour créer des agents, y compris des modèles open source qui peuvent être exécutés localement.

Getting Started

Ajoutez les packages Python requis à votre projet.

pip install agent-framework --pre

Vous devrez peut-être également ajouter des packages pour des implémentations de client de conversation spécifiques que vous souhaitez utiliser :

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

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

Clients de conversation intégrés

L’infrastructure fournit plusieurs implémentations de client de conversation intégrées :

Client de conversation 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"
)

Client de conversation 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"
)

Client de l’agent 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"
    )

Important

Pour vous assurer de tirer le meilleur parti de votre agent, veillez à choisir un service et un modèle adapté aux tâches conversationnelles et prend en charge l’appel de fonction si vous envisagez d’utiliser des outils.

Utilisation de l’agent

L’agent prend en charge toutes les opérations d’agent standard.

Pour plus d’informations sur l’exécution et l’interaction avec les agents, consultez les didacticiels de prise en main de l’agent .

Étapes suivantes

Agent2Agent