Agent oparty na dowolnym IChatClient

Program Microsoft Agent Framework obsługuje tworzenie agentów dla dowolnej usługi wnioskowania, która zapewnia implementację Microsoft.Extensions.AI.IChatClient . Oznacza to, że istnieje bardzo szeroki zakres usług, które mogą służyć do tworzenia agentów, w tym modeli typu open source, które mogą być uruchamiane lokalnie.

W tym dokumencie użyjemy narzędzia Ollama jako przykładu.

Wprowadzenie

Dodaj wymagane pakiety NuGet do projektu.

dotnet add package Microsoft.Agents.AI --prerelease

Należy również dodać pakiet dla określonej IChatClient implementacji, której chcesz użyć. W tym przykładzie użyjemy OllamaSharp.

dotnet add package OllamaSharp

Tworzenie agenta ChatClientAgent

Aby utworzyć agenta na podstawie interfejsu IChatClient , możesz użyć ChatClientAgent klasy . Klasa ChatClientAgent przyjmuje IChatClient jako parametr konstruktora.

Najpierw utwórz element OllamaApiClient , aby uzyskać dostęp do usługi Ollama.

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

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

Element OllamaApiClient implementuje IChatClient interfejs, aby można było go użyć do utworzenia elementu 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."));

Korzystanie z agenta

Agent jest standardowy AIAgent i obsługuje wszystkie standardowe operacje agenta.

Aby uzyskać więcej informacji na temat uruchamiania agentów i interakcji z nimi, zobacz samouczki wprowadzające Agenta.

Program Microsoft Agent Framework obsługuje tworzenie agentów dla dowolnej usługi wnioskowania, która zapewnia implementację klienta czatu zgodną z programem ChatClientProtocol. Oznacza to, że istnieje bardzo szeroki zakres usług, które mogą służyć do tworzenia agentów, w tym modeli typu open source, które mogą być uruchamiane lokalnie.

Wprowadzenie

Dodaj wymagane pakiety języka Python do projektu.

pip install agent-framework --pre

Może być również konieczne dodanie pakietów dla określonych implementacji klienta czatu, których chcesz użyć:

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

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

Wbudowani klienci rozmów

Platforma udostępnia kilka wbudowanych implementacji klienta czatu:

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 czatu usługi 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 usługi 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"
    )

Korzystanie z agenta

Agent obsługuje wszystkie standardowe operacje agenta.

Aby uzyskać więcej informacji na temat uruchamiania agentów i interakcji z nimi, zobacz samouczki wprowadzające Agenta.