Agent založený na jakémkoli chatovacím klientovi

Rozhraní Microsoft Agent Framework podporuje vytváření agentů pro jakoukoli službu odvozování, která poskytuje implementaci Microsoft.Extensions.AI.IChatClient . To znamená, že existuje celá řada služeb, které je možné použít k vytváření agentů, včetně opensourcových modelů, které je možné spouštět místně.

Tento článek jako příklad používá Ollama.

Začínáme

Přidejte do projektu požadované balíčky NuGet.

dotnet add package Microsoft.Agents.AI --prerelease

Budete také muset přidat balíček pro konkrétní IChatClient implementaci, kterou chcete použít. Tento příklad používá OllamaSharp.

dotnet add package OllamaSharp

Vytvoření agenta ChatClientAgent

K vytvoření agenta IChatClient na základě rozhraní můžete použít ChatClientAgent třídu. Třída ChatClientAgent přebírá IChatClient jako parametr konstruktoru.

Nejprve vytvořte OllamaApiClient pro přístup ke službě Ollama.

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

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

Implementuje OllamaApiClientIChatClient rozhraní, takže ho můžete použít k vytvoření 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."));

Důležité

Abyste měli jistotu, že agenta na maximum využíváte, nezapomeňte zvolit službu a model, který je vhodný pro konverzační úlohy a podporuje volání funkcí.

Použití agenta

Agent je standardní AIAgent a podporuje všechny standardní operace agentů.

Další informace o tom, jak spouštět agenty a pracovat s nimi, najdete v úvodních kurzech agenta.

Rozhraní Microsoft Agent Framework podporuje vytváření agentů pro jakoukoli službu odvozování, která poskytuje implementaci chatovacího klienta kompatibilní s rozhraním ChatClientProtocol. To znamená, že existuje celá řada služeb, které je možné použít k vytváření agentů, včetně opensourcových modelů, které je možné spouštět místně.

Začínáme

Přidejte do projektu požadované balíčky Pythonu.

pip install agent-framework --pre

Možná budete také muset přidat balíčky pro konkrétní implementace chatovacího klienta, které chcete použít:

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

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

Integrovaní klienti chatu

Architektura poskytuje několik integrovaných implementací chatovacího klienta:

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

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

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

Důležité

Abyste měli jistotu, že z agenta využijete maximum, nezapomeňte zvolit službu a model, který je vhodný pro konverzační úlohy a podporuje volání funkcí, pokud plánujete používat nástroje.

Použití agenta

Agent podporuje všechny standardní operace agenta.

Další informace o tom, jak spouštět agenty a pracovat s nimi, najdete v úvodních kurzech agenta.

Další kroky

Agent2Agent