Agent gebaseerd op een IChatClient

Microsoft Agent Framework biedt ondersteuning voor het maken van agents voor elke deductieservice die een Microsoft.Extensions.AI.IChatClient implementatie biedt. Dit betekent dat er een zeer breed scala aan services is die kunnen worden gebruikt om agents te maken, waaronder opensource-modellen die lokaal kunnen worden uitgevoerd.

In dit artikel wordt Ollama als voorbeeld gebruikt.

Aan de slag komen

Voeg de vereiste NuGet-pakketten toe aan uw project.

dotnet add package Microsoft.Agents.AI --prerelease

U moet ook het pakket toevoegen voor de specifieke IChatClient implementatie die u wilt gebruiken. In dit voorbeeld wordt OllamaSharp gebruikt.

dotnet add package OllamaSharp

Een ChatClientAgent maken

Als u een agent wilt maken op basis van de IChatClient interface, kunt u de ChatClientAgent klasse gebruiken. De ChatClientAgent klasse neemt IChatClient als constructorparameter aan.

Maak eerst een OllamaApiClient aan om toegang te krijgen tot de Ollama-service.

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

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

Het OllamaApiClient implementeert de IChatClient interface, zodat u het kunt gebruiken om een ChatClientAgent te maken.

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

Belangrijk

Om ervoor te zorgen dat u optimaal gebruik kunt maken van uw agent, moet u een service en model kiezen dat geschikt is voor gesprekstaken en functieoproepen ondersteunt.

De agent gebruiken

De agent is een standaard AIAgent en ondersteunt alle standaardagentbewerkingen.

Voor meer informatie over hoe je agents uitvoert en ermee werkt, raadpleeg de Aan de slag met agent-tutorials.

Microsoft Agent Framework ondersteunt het maken van agents voor elke deductieservice die een chatclient-implementatie biedt die compatibel is met de ChatClientProtocol. Dit betekent dat er een zeer breed scala aan services is die kunnen worden gebruikt om agents te maken, waaronder opensource-modellen die lokaal kunnen worden uitgevoerd.

Aan de slag komen

Voeg de vereiste Python-pakketten toe aan uw project.

pip install agent-framework --pre

Mogelijk moet u ook pakketten toevoegen voor specifieke implementaties van chatclients die u wilt gebruiken:

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

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

Ingebouwde chatclients

Het framework biedt verschillende ingebouwde implementaties van chatclients:

OpenAI Chat-client

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 Chat-client

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 AI Agent Client

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

Belangrijk

Om ervoor te zorgen dat u optimaal gebruik kunt maken van uw agent, moet u een service en model kiezen dat geschikt is voor gesprekstaken en ondersteuning biedt voor functieoproepen als u van plan bent om hulpprogramma's te gebruiken.

De agent gebruiken

De agent ondersteunt alle standaardagentbewerkingen.

Voor meer informatie over hoe je agents uitvoert en ermee werkt, raadpleeg de Aan de slag met agent-tutorials.

Volgende stappen

Agent2Agent