Agent basierend auf jedem IChatClient

Das Microsoft Agent Framework unterstützt das Erstellen von Agents für jeden Rückschlussdienst, der eine Microsoft.Extensions.AI.IChatClient Implementierung bereitstellt. Dies bedeutet, dass es eine sehr breite Palette von Diensten gibt, die zum Erstellen von Agents verwendet werden können, einschließlich Open Source-Modellen, die lokal ausgeführt werden können.

In diesem Dokument verwenden wir Ollama als Beispiel.

Erste Schritte

Fügen Sie dem Projekt die erforderlichen NuGet-Pakete hinzu.

dotnet add package Microsoft.Agents.AI --prerelease

Außerdem müssen Sie das Paket für die spezifische IChatClient Implementierung hinzufügen, die Sie verwenden möchten. In diesem Beispiel verwenden wir OllamaSharp.

dotnet add package OllamaSharp

Erstellen eines ChatClientAgent

Um einen Agent basierend auf der IChatClient Schnittstelle zu erstellen, können Sie die ChatClientAgent Klasse verwenden. Die ChatClientAgent Klasse verwendet IChatClient als Konstruktorparameter.

Erstellen Sie zunächst einen OllamaApiClient, um Zugriff auf den Ollama-Service zu erhalten.

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

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

Die OllamaApiClient implementiert die IChatClient-Schnittstelle, damit Sie sie zur Erstellung einer ChatClientAgent verwenden können.

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

Von Bedeutung

Um sicherzustellen, dass Sie Ihren Agent optimal nutzen können, stellen Sie sicher, dass Sie einen Dienst und ein Modell auswählen, das gut für Unterhaltungsaufgaben geeignet ist und Funktionsaufrufe unterstützt.

Den Agent verwenden

Der Agent ist ein Standard AIAgent und unterstützt alle Standard-Agent-Vorgänge.

Weitere Informationen zum Ausführen und Interagieren mit Agenten finden Sie in den Einführungstutorials für Agenten.

Das Microsoft Agent Framework unterstützt das Erstellen von Agents für jeden Inferenzdienst, der eine mit dem ChatClientProtocol kompatible Chat-Client-Implementierung bereitstellt. Dies bedeutet, dass es eine sehr breite Palette von Diensten gibt, die zum Erstellen von Agents verwendet werden können, einschließlich Open Source-Modellen, die lokal ausgeführt werden können.

Erste Schritte

Fügen Sie ihrem Projekt die erforderlichen Python-Pakete hinzu.

pip install agent-framework --pre

Möglicherweise müssen Sie auch Pakete für bestimmte Chatclientimplementierungen hinzufügen, die Sie verwenden möchten:

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

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

Integrierte Chatclients

Das Framework bietet mehrere integrierte Chatclientimplementierungen:

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

Von Bedeutung

Um sicherzustellen, dass Sie Ihren Agent optimal nutzen können, stellen Sie sicher, dass Sie einen Dienst und ein Modell auswählen, das gut für Unterhaltungsaufgaben geeignet ist und Funktionsaufrufe unterstützt, wenn Sie Tools verwenden möchten.

Den Agent verwenden

Der Agent unterstützt alle Standard-Agent-Vorgänge.

Weitere Informationen zum Ausführen und Interagieren mit Agenten finden Sie in den Einführungstutorials für Agenten.

Nächste Schritte

Agent2Agent