Aracılığıyla paylaş

Herhangi bir Sohbet İstemcisi'ne dayalı aracı

Microsoft Agent Framework, herhangi bir Microsoft.Extensions.AI.IChatClient uygulaması sunan anlam çıkarma hizmeti için aracı oluşturmayı destekler. Bu, yerel olarak çalıştırılabilir açık kaynak modelleri de dahil olmak üzere aracı oluşturmak için kullanılabilecek çok geniş bir hizmet yelpazesi olduğu anlamına gelir.

Bu makalede örnek olarak Ollama kullanılır.

Başlangıç Yapmak

Projenize gerekli NuGet paketlerini ekleyin.

dotnet add package Microsoft.Agents.AI --prerelease

Ayrıca, kullanmak istediğiniz belirli IChatClient bir uygulama için paketi eklemeniz gerekir. Bu örnekte OllamaSharp kullanılır.

dotnet add package OllamaSharp

Bir ChatClientAgent oluşturma

Bir arabirim çerçevesinde bir aracı oluşturmak için IChatClient sınıfını kullanabilirsiniz. ChatClientAgent sınıfı oluşturucu parametresi olarak alırIChatClient.

İlk olarak Ollama hizmetine erişmek için bir OllamaApiClient oluşturun.

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

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

OllamaApiClient arabirimi uygular, böylece bir IChatClient oluşturmak için ChatClientAgent kullanabilirsiniz.

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

Önemli

Ajanınızdan en iyi şekilde yararlanmak için, sohbet görevleri için uygun ve fonksiyon çağırmayı destekleyen bir hizmet ve model seçtiğinizden emin olun.

Ajanı Kullanma

Aracı standart bir AIAgent'dir ve tüm standart aracı işlemleri destekler.

Aracıları çalıştırma ve aracılarla etkileşim kurma hakkında daha fazla bilgi için bkz. Aracı kullanmaya başlama öğreticileri.

Microsoft Agent Framework, ile ChatClientProtocoluyumlu bir sohbet istemcisi uygulaması sağlayan herhangi bir çıkarım hizmeti için aracı oluşturmayı destekler. Bu, yerel olarak çalıştırılabilir açık kaynak modelleri de dahil olmak üzere aracı oluşturmak için kullanılabilecek çok geniş bir hizmet yelpazesi olduğu anlamına gelir.

Başlangıç Yapmak

Projenize gerekli Python paketlerini ekleyin.

pip install agent-framework --pre

Ayrıca, kullanmak istediğiniz belirli sohbet istemcisi uygulamaları için paketler eklemeniz gerekebilir:

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

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

Yerleşik Sohbet İstemcileri

Çerçeve birkaç yerleşik sohbet istemcisi uygulaması sağlar:

OpenAI Sohbet İstemcisi

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 Sohbet İstemcisi

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 Aracı İstemcisi

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

Önemli

Aracınızdan en iyi şekilde yararlandığınızdan emin olmak için, araçları kullanmayı planlıyorsanız konuşma görevleri için uygun ve işlev çağrısını destekleyen bir hizmet ve model seçtiğinizden emin olun.

Ajanı Kullanma

Aracı, tüm standart temsilci işlemlerini destekler.

Aracıları çalıştırma ve aracılarla etkileşim kurma hakkında daha fazla bilgi için bkz. Aracı kullanmaya başlama öğreticileri.

Sonraki Adımlar

Agent2Agent

  • Last updated on