Ügynök bármely csevegő-kliens alapján

A Microsoft Agent Framework támogatja az ügynökök létrehozását bármely következtetési szolgáltatáshoz, amely egy Microsoft.Extensions.AI.IChatClient implementációt biztosít. Ez azt jelenti, hogy a szolgáltatások széles köre használható ügynökök létrehozására, beleértve a helyileg futtatható nyílt forráskódú modelleket is.

Ez a cikk az Ollama-t használja példaként.

Első lépések

Adja hozzá a szükséges NuGet-csomagokat a projekthez.

dotnet add package Microsoft.Agents.AI --prerelease

A használni kívánt IChatClient implementációhoz hozzá kell adnia a csomagot is. Ez a példa az OllamaSharpet használja.

dotnet add package OllamaSharp

ChatClientAgent létrehozása

Ha az IChatClient interfész alapján szeretne ügynököt létrehozni, használhatja az osztályt ChatClientAgent . Az ChatClientAgent osztály konstruktorparaméterként szolgál IChatClient .

Először hozzon létre egy lehetőséget OllamaApiClient az Ollama szolgáltatás eléréséhez.

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

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

A OllamaApiClient megvalósítja a IChatClient interfészt, így használhatja ChatClientAgent létrehozására.

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

Fontos

Annak érdekében, hogy a legtöbbet hozhassa ki az ügynökéből, mindenképpen válasszon ki egy olyan szolgáltatást és modellt, amely alkalmas beszélgetési feladatokhoz, és támogatja a függvényhívást.

Az ügynök használata

Az ügynök egy szabványos AIAgent, és támogatja az összes szabványos ügynökműveletet.

Az ügynökök futtatásával és használatával kapcsolatos további információkért tekintse meg az ügynök első lépéseket ismertető oktatóanyagait.

A Microsoft Agent Framework támogatja az ügynökök létrehozását minden olyan következtetési szolgáltatáshoz, amely a csevegőügyfél implementációjával ChatClientProtocolkompatibilis. Ez azt jelenti, hogy a szolgáltatások széles köre használható ügynökök létrehozására, beleértve a helyileg futtatható nyílt forráskódú modelleket is.

Első lépések

Adja hozzá a szükséges Python-csomagokat a projekthez.

pip install agent-framework --pre

Előfordulhat, hogy csomagokat is fel kell vennie a használni kívánt csevegőügyfél-implementációkhoz:

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

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

Beépített chat kliensek

A keretrendszer számos beépített csevegőügyfél-implementációt biztosít:

OpenAI csevegőügyfél

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-csevegőügyfél

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 Ügynök Kliens

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

Fontos

Annak érdekében, hogy a lehető legtöbbet tudja kihozni az ügynökéből, mindenképpen válasszon ki egy olyan szolgáltatást és modellt, amely megfelelő a beszélgetési feladatokhoz, és támogatja a függvényhívást, ha eszközöket szeretne használni.

Az ügynök használata

Az ügynök minden szabványos ügynökműveletet támogat.

Az ügynökök futtatásával és használatával kapcsolatos további információkért tekintse meg az ügynök első lépéseket ismertető oktatóanyagait.

Következő lépések

Agent2Agent