Bagikan melalui


Gambaran umum Microsoft 365 Agents SDK

Dengan Microsoft 365 Agents SDK, Anda dapat membuat agen yang dapat disebarkan ke saluran pilihan Anda, seperti Microsoft 365 Copilot, Microsoft Teams, Web & Custom Apps dan banyak lagi, dengan perancah untuk menangani komunikasi yang diperlukan. Pengembang dapat menggunakan Layanan AI pilihan mereka, dan membuat agen yang mereka bangun tersedia menggunakan kemampuan manajemen saluran SDK.

Fitur utama SDK Agen

Pengembang membutuhkan fleksibilitas untuk mengintegrasikan agen dari penyedia atau tumpukan teknologi apa pun ke dalam sistem perusahaan mereka. Agen SDK menyederhanakan implementasi pola agenik menggunakan AI pilihan mereka, memungkinkan mereka untuk memilih satu atau beberapa layanan, model, atau agen untuk memenuhi persyaratan spesifik mereka.

Gunakan SDK Agen untuk:

  1. Bangun 'kontainer' agen dengan status, penyimpanan, dan kemampuan untuk mengelola aktivitas dan peristiwa dengan cepat. Sebarkan kontainer ini di semua saluran, seperti Microsoft 365 Copilot atau Microsoft Teams.
  2. Menerapkan pola agenik tanpa dibatasi untuk tumpukan teknologi tertentu. Agen SDK bersifat agnostik mengenai AI yang Anda pilih.
  3. Sesuaikan agen Anda agar selaras dengan perilaku klien tertentu, seperti Microsoft Teams.

Bahasa yang didukung

SDK Agen mendukung:

  • C# menggunakan .NET 8.0 SDK
  • JavaScript menggunakan Node.js versi 18 ke atas
  • Python 3.9 hingga 3.11

Membuat agen

Sangat mudah untuk mendapatkan sampel starter di C#, JavaScript, atau Python dari Github

Untuk membuat agen di C#:

builder.AddAgent( sp =>
{
    var agent = new AgentApplication(sp.GetRequiredService<AgentApplicationOptions>());
    agent.OnActivity(ActivityTypes.Message, async (turnContext, turnState, cancellationToken) =>
    {
        var text = turnContext.Activity.Text;
        await turnContext.SendActivityAsync(MessageFactory.Text($"Echo: {text}"), cancellationToken);
    });
});

Ini membuat agen baru, mendengarkan aktivitas jenis pesan dan mengirim pesan kembali

Dari sini, Anda dapat menambahkan Layanan AI kustom pilihan Anda (misalnya, Azure Foundry atau Agen OpenAI) dan Orkestrasi (misalnya, Kernel Semantik).

Istilah penting

Beberapa konsep spesifik yang penting untuk SDK adalah:

  • Giliran: Giliran adalah unit pekerjaan yang dilakukan oleh agen. Ini bisa menjadi satu pesan atau serangkaian pesan. Pengembang akan bekerja dengan 'giliran' dan mengelola data di antara mereka
  • Aktivitas: Aktivitas adalah satu atau beberapa jenis unit yang dikelola oleh agen
  • Pesan: Pesan adalah jenis aktivitas yang dikirim ke agen. Ini bisa menjadi satu pesan atau serangkaian pesan.

Mulai

Sebelum memulai, Anda perlu mengurus beberapa prasyarat. Prasyarat bergantung pada bahasa yang Anda gunakan untuk mengembangkan aplikasi Anda.

Unduh dan instal

Unduh file yang diperlukan untuk memulai.

Mengkloning repositori GitHub Agen secara lokal. Repositori berisi pustaka sumber SDK dan sampel untuk membantu Anda mulai membangun aplikasi menggunakan SDK. Menginstal sampel menginstal paket yang diperlukan untuk SDK.

Langkah selanjutnya