Agen berdasarkan Klien Chat apa saja

Microsoft Agent Framework mendukung pembuatan agen untuk layanan inferensi apa pun yang menyediakan Microsoft.Extensions.AI.IChatClient implementasi. Ini berarti bahwa ada berbagai layanan yang sangat luas yang dapat digunakan untuk membuat agen, termasuk model sumber terbuka yang dapat dijalankan secara lokal.

Artikel ini menggunakan Ollama sebagai contoh.

Memulai Langkah Awal

Tambahkan paket NuGet yang diperlukan ke proyek Anda.

dotnet add package Microsoft.Agents.AI --prerelease

Anda juga perlu menambahkan paket untuk implementasi spesifik IChatClient yang ingin Anda gunakan. Contoh ini menggunakan OllamaSharp.

dotnet add package OllamaSharp

Membuat ChatClientAgent

Untuk membuat agen berdasarkan IChatClient antarmuka, Anda dapat menggunakan ChatClientAgent kelas . Kelas ChatClientAgent mengambil IChatClient sebagai parameter konstruktor.

Pertama, buat OllamaApiClient untuk mengakses layanan Ollama.

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

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

Objek OllamaApiClient mengimplementasikan antarmuka IChatClient, sehingga Anda dapat menggunakannya untuk membuat 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."));

Penting

Untuk memastikan bahwa Anda mendapatkan hasil maksimal dari agen Anda, pastikan untuk memilih layanan dan model yang sangat cocok untuk tugas percakapan dan mendukung panggilan fungsi.

Menggunakan Agen

Agen adalah standar AIAgent dan mendukung semua operasi agen standar.

Untuk informasi selengkapnya tentang cara menjalankan dan berinteraksi dengan agen, lihat tutorial Memulai Agen.

Microsoft Agent Framework mendukung pembuatan agen untuk layanan inferensi apa pun yang menyediakan implementasi klien obrolan yang kompatibel dengan ChatClientProtocol. Ini berarti bahwa ada berbagai layanan yang sangat luas yang dapat digunakan untuk membuat agen, termasuk model sumber terbuka yang dapat dijalankan secara lokal.

Memulai Langkah Awal

Tambahkan paket Python yang diperlukan ke proyek Anda.

pip install agent-framework --pre

Anda mungkin juga perlu menambahkan paket untuk implementasi klien obrolan tertentu yang ingin Anda gunakan:

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

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

Aplikasi Obrolan Bawaan

Kerangka kerja ini menyediakan beberapa implementasi klien obrolan bawaan:

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

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

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

Penting

Untuk memastikan bahwa Anda mendapatkan hasil maksimal dari agen Anda, pastikan untuk memilih layanan dan model yang sangat cocok untuk tugas percakapan dan mendukung panggilan fungsi jika Anda berencana untuk menggunakan alat.

Menggunakan Agen

Semua operasi agen standar didukung oleh agen ini.

Untuk informasi selengkapnya tentang cara menjalankan dan berinteraksi dengan agen, lihat tutorial Memulai Agen.

Langkah selanjutnya

Agent2Agent