Aracılığıyla paylaş

Microsoft 365 Aracılar SDK'sı genel bakış

Microsoft 365 Aracıları SDK'sı ile microsoft 365 Copilot, Microsoft Teams, Web ve Özel Uygulamalar gibi istediğiniz kanallara dağıtılabilir aracılar oluşturabilir ve gerekli iletişimi işlemek için iskele oluşturabilirsiniz. Geliştiriciler kendi seçtikleri Yapay Zeka Hizmetlerini kullanabilir ve oluşturdukları aracıları SDK'nın kanal yönetimi özelliklerini kullanarak kullanılabilir hale getirir.

Temsilciler SDK'sının temel özellikleri

Geliştiriciler, herhangi bir sağlayıcıdan veya teknoloji yığınından aracıları kurumsal sistemleriyle tümleştirme esnekliğine ihtiyaç duyar. Aracılar SDK'sı, tercih ettikleri yapay zekayı kullanarak aracılı desenlerin uygulanmasını basitleştirerek belirli gereksinimlerini karşılamak üzere bir veya daha fazla hizmet, model veya aracı seçmelerine olanak tanır.

Ajanslar SDK'sını kullanın:

  1. Durum, depolama ve etkinlikleri ve olayları yönetme becerisine sahip bir aracı "kapsayıcısını" hızla oluşturun. Bu kapsayıcıyı Microsoft 365 Copilot veya Microsoft Teams gibi herhangi bir kanala dağıtın.
  2. Belirli bir teknoloji yığınıyla sınırlandırılmadan ajan desenlerini uygulayın. Aracılar SDK'sı, seçtiğiniz yapay zekayla ilgili olarak belirsizdir.
  3. Aracınızı, Microsoft Teams gibi istemcilerin belirli davranışlarıyla uyumlu olacak şekilde özelleştirin.

Desteklenen diller

Temsilciler SDK'sı aşağıdakileri destekler:

  • .NET 8.0 SDK'sını kullanan C#
  • Node.js sürüm 18 ve üzerini kullanan JavaScript
  • Python 3.9 - 3.11

Bir aracı oluştur

Github'dan C#, JavaScript veya Python'da başlangıç örneğini almak kolaydır

C# dilinde aracı oluşturmak için:

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);
    });
});

Bu, yeni bir aracı oluşturur, ileti türü etkinliğini dinler ve bir iletiyi geri gönderir

Buradan, seçtiğiniz özel yapay zeka hizmetlerini (örneğin, Azure Foundry veya OpenAI Aracıları) ve Orchestration'ı (örneğin, Anlam Çekirdeği) ekleyebilirsiniz.

Önemli terimler

SDK için önemli olan bazı belirli kavramlar şunlardır:

  • Tur: Tur, bir ajan tarafından yapılan bir iş birimidir. Tek bir ileti veya bir dizi ileti olabilir. Geliştiriciler 'turns' ile çalışacak ve bunlar arasındaki verileri yönetecek.
  • Etkinlik: Etkinlik, aracı tarafından yönetilen bir veya daha fazla birim türüdür
  • İletiler: İleti, aracıya gönderilen bir etkinlik türüdür. Tek bir ileti veya bir dizi ileti olabilir.

Get Started

Başlamadan önce bazı önkoşullarla ilgilenmeniz gerekir. Önkoşullar, uygulamanızı geliştirmek için kullandığınız dile bağlıdır.

İndirme ve kurma

Başlamak için gereken dosyaları indirin.

Agents GitHub deposunu yerel olarak kopyalayın. Depo, SDK'yi kullanarak uygulama oluşturmaya başlamanıza yardımcı olacak SDK kaynak kitaplıklarını ve örneklerini içerir. Örneklerin yüklenmesi, SDK için gerekli paketleri yükler.

Sonraki Adımlar

  • Last updated on