Konsep agen

Agen Agent Framework menggabungkan abstraksi agen, model atau koneksi agen jarak jauh, instruksi, alat, middleware, penyedia konteks, dan status sesi di belakang antarmuka eksekusi yang konsisten.

Runtime dan eksekusi

• Agen yang berjalan menjelaskan eksekusi reguler dan streaming, opsi eksekusi, respons, pesan, dan konten.
• Alur agen menjelaskan bagaimana middleware, penyedia konteks, pemanggilan model, dan alat berpartisipasi dalam eksekusi.

Jenis agen

• Agen kustom menjelaskan antarmuka agen umum dan kapan harus mengimplementasikan agen secara langsung.
• Penyedia model menghubungkan agen milik aplikasi ke layanan inferensi.
• Layanan agen terhubung ke agen jarak jauh yang dikelola atau didukung protokol.

Agen klien obrolan

Agen klien obrolan adalah agen milik aplikasi yang didukung oleh klien inferensi model. Mereka mendukung alat fungsi, percakapan multi-giliran, alat yang dihosting penyedia di mana tersedia, output terstruktur, streaming, middleware, dan riwayat percakapan lokal atau yang dikelola layanan.

Setiap klien inferensi yang mengimplementasikan Microsoft.Extensions.AI.IChatClient dapat mendukung ChatClientAgent:

using Microsoft.Agents.AI;

AIAgent agent = new ChatClientAgent(
    chatClient,
    instructions: "You are a helpful assistant.");

Semua implementasi agen berbagi AIAgent abstraksi, sehingga kode aplikasi dan orkestrasi dapat bekerja dengan agen klien obrolan, agen kustom, dan proksi agen jarak jauh melalui satu antarmuka.

Untuk kemampuan penyedia, dukungan riwayat percakapan, dan pemilihan titik akhir SDK, lihat Penyedia model.

Buat standar Agent dari klien apa pun yang mengimplementasikan SupportsChatGetResponse:

from agent_framework import Agent

agent = Agent(
    client=client,
    instructions="You are a helpful assistant.",
)

Antarmuka yang sama Agent berfungsi di seluruh penyedia model yang didukung. Jenis agen langsung seperti FoundryAgent, , A2AAgentGitHubCopilotAgent, dan ClaudeAgent terhubung ke runtime agen terkelola atau jarak jauh sebagai gantinya.

Untuk klien inferensi yang tersedia, lihat Penyedia model.

Paket penyedia model Go membangun jenis standar *agent.Agent melalui konstruktor khusus penyedia. Ini memberi kode aplikasi eksekusi, sesi, alat, middleware, dan antarmuka streaming yang konsisten sementara setiap penyedia memiliki inisialisasi klien.

Untuk konstruktor dan jalur impor, lihat Penyedia model.

Percakapan dan memori

Konsep percakapan mencakup sesi, penyedia konteks, penyimpanan, pemadatan, dan penyedia memori riwayat obrolan bawaan.

Middleware

Konsep middleware mencakup definisi, cakupan, pengurutan, status bersama, konteks run-time, penghentian, kesalahan, dan penimpaan hasil.

Safety

Keamanan agen menjelaskan pola desain untuk membatasi perilaku agen dan mengurangi risiko operasional. Penegakan keamanan dengan FIDES tetap menjadi Kemampuan Agen.

Langkah berikutnya

Pelajari cara menjalankan agen