Agent 365 geliştirmeye başlayın

Agent 365, çeşitli aracı uygulamalarıyla çalışır. Bir aracı, kullanıcılara isteğe bağlı olarak yardımcı olabilir, arka planda özerk olarak çalışabilir veya Microsoft 365'te kendi kullanıcı kimliğiyle çalışabilir. Aracınızı en iyi hangi desenin tanımladığını anlamak önemlidir, çünkü bu, aracının kimlik modelini, Microsoft 365 kaynaklarına hangi erişime sahip olduğunu ve hangi yaşam döngüsü adımlarının geçerli olduğunu belirler.

Aracı türleri

Başlamadan önce kendinize sorun: Ne tür bir aracı geliştiriyorum?

Sahip oldukları erişim türüne bağlı olarak iki tür aracı vardır:

Aracı türü Genel bakış
Aracılar Delegeli erişimle bir kullanıcı adına çalışın veya kapsamlı izinlere sahip bir uygulama olarak çalışın. Microsoft Entra uygulamaları veya aracı kimlik şemaları olarak kaydedilmiş.
AI ekip arkadaşı Microsoft 365'te posta kutusu, Teams varlığı ve dizin girişi dahil olmak üzere kendi kullanıcı kimliğiyle çalışır. Bu tür aracı yalnızca Frontier önizleme programına katılan kiracılar tarafından kullanılabilir.

Aracılar

Bir aracı, bir kullanıcı adına çalışır. İsteklere yanıt verir, arka planda görevleri çalıştırır, API'lere bağlanır, verileri işler ve eylemleri sürükler.

Aracılar her şekilde gelir. Bazıları konuşmaya yönelik - bir kullanıcı bir şey sorar ve aracı yanıt verir. Bazıları arka planda sessizce çalışır - bir zamanlama, olay veya gelen ileti tarafından tetiklenir - hiç kimsenin aktif olarak yer almadığı. Bazıları her ikisini de yapar.

Örnek senaryolar:

  • Bir kullanıcı, okunmamış e-postalarını özetlemesini ve yanıtları hazırlamasını isteyerek bir aracıya talimatta bulunur. Aracı işi gerçekleştirerek, yalnızca kullanıcının erişebileceği kaynakları kullanır ve sonucu geri sunar.
  • Bir müşteri hizmetleri aracısı, destek mühendisine canlı destek oturumu sırasında iç bilgi tabanlarını sorgulamak ve yanıtlar oluşturmak konusunda yardımcı olur.
  • Bir uyum izleme aracısı her gece çalışır, aracıya erişim izni verilen SharePoint sitelerinde kural ihlalleri olup olmadığını tarar ve kimse bunu gözetlemeden denetim raporları dosyalamaktadır.
  • Bir siparişi işleme aracısı, sıradan yeni satış siparişlerini alır, bir CRM'yi güncelleştirmektedir ve bunu başlatan kimse olmadan onay e-postalarını gönderir.

Kimlik tabanı:

Geleneksel olarak, aracıları Microsoft Entra uygulamaları olarak kaydedersiniz. Bu yaklaşım çalışmaya devam etmektedir. Bundan sonra, Microsoft Entra Aracı Kimliği üzerinden aracılar oluşturabilirsiniz; aracı kimlik şeması - bir aracının yeteneklerinin, izin verilen araç erişiminin ve uyum kısıtlamalarının BT tarafından onaylanan, yönetişim tarafından zorlanan tanımı. Bir şema üzerinde kurulum yeni aracılar için önerilen yoldur. Bu, yönetilen Work IQ araç erişiminin, Microsoft Purview veri korumasının, Microsoft Defender tehdit izlemenin ve Entra ID yönetişiminin kilidini açar; aracınızı ilk günden itibaren tam olarak yönetilen bir kurumsal kimlik haline getirir. Aracınızın kullanıcıları bir üçüncü taraf kimlik sağlayıcısı aracılığıyla oturum açarsa bkz. Microsoft Entra Aracı Kimliği'yi üçüncü taraf kimlik sağlayıcılarıyla tümleştirme.

AI ekip arkadaşı

Önemli

Bu tür bir aracının erken erişimine sahip olmak için Frontier önizleme programının parçası olmanız gerekir. Frontier sizi doğrudan Microsoft'un en son AI inovasyonlarıyla bağlantı kurar. Frontier önizlemeleri, müşteri anlaşmalarınızın mevcut önizleme şartlarına tabidir. Bu özellikler hâlâ geliştirme aşamasında olduğundan, bunların kullanılabilirliği ve yetenekleri zaman içinde değişebilir.

Bir AI takım arkadaşı, kendi aracı kimliğini kullanarak Microsoft 365'te çalışır. Bunu, kendi posta kutusu aracılığıyla e-posta gönderme ve alma, Teams 1:1 ve grup görüşmelerine katılma ve atanan bir yönetici ilişkisine sahip dizin ve kuruluş meta verilerinde görünme gibi yeteneklere sahip olacak şekilde sağlayabilirsiniz. Kullanıcılar bunu @mentions, e-posta, takvim davetleri ve Teams sohbeti gibi tanıdık Microsoft 365 giriş noktaları aracılığıyla kullanabilir.

Bu aracıları, BT tarafından onaylanan, yönetişim tarafından zorlanan aracının yeteneklerinin, izin verilen araç erişiminin ve uyum kısıtlamalarının tanımı olan aracı kimlik şemasından oluşturun. Her aracı örneği, kimlik modelini, izinleri ve ilkeleri ana aracı kimliği şablonundan devralır.

Aracının ne yaptığı (konuşmacı, arka planda veya her ikisi) nasıl tasarladığınıza bağlıdır. Bazı aracılar oldukça etkileşimlidir ve iletilere yanıt vererek gerçek zamanlı olarak çalışmayı destekler. Diğerleri, doğrudan kullanıcı katılımı olmaksızın e-postalar veya olaylara göre arka planda görevleri işler. Aracı kendi kullanıcı kimliğiyle çalışır ve eylemleri o kimlik aracılığıyla yönetilir ve denetlenebilir.

Zaten bir aracınız varsa baştan başlamanız gerekmez. Mevcut aracıları, bu kılavuzda daha sonra açıklanan kimlik ve şablon yapılandırmasını ekleyerek kendi kimliğiyle çalışacak şekilde genişletebilirsiniz.

Örnek senaryolar:

  • Yeni bir çalışanın Teams onboarding kanalına bir İK onboarding AI takım arkadaşı ekleyin. Kendi posta kutusundan hoş geldiniz e-postaları gönderir, kendi takviminde yönelim toplantıları zamanlar ve o aracı örneği için yapılandırılan yetenekler kullanarak soruların yanıtını verir.
  • Bir tedarik aracısına dizin meta verilerinde yönetici ilişkisi atayın. Çalışanlar satın alma taleplerini posta kutusuna gönderir. Aracı isteği işler, kendi yönetilen Work IQ araç erişimini kullanarak ERP ve finans sistemlerini sorgular ve kendi kimliğinden onay veya yükseltme ile yanıt verir.
  • Bir araştırma aracısını proje ekibinin SharePoint sitesine ve Teams kanalına ekleyin. Toplantılar sırasında ilgili belgeleri ortaya çıkarabilir, konuşma başlıklarında yanıt verebilir ve o aracı için yapılandırılan izinler ve araçları kullanarak haftalık durum raporları hazırlayabilir.

Kimlik tabanı:

Bir Microsoft Entra Aracı Kimliği ve ilişkili kullanıcı hesabı oluşturan aracı kimliği şablonuna dayalı: her zaman gerekli.

Agent 365 yeteneklerini kademeli olarak ekleme

Agent 365 her şey ya da hiçbir şey değildir. Birinci günde bir AI takım arkadaşı oluşturmanız gerekmez veya senaryonuz bunu gerektirmiyorsa hiç gerekmez. Özellikleri kademeli olarak benimseyin; aracınızın şu anda ihtiyaç duyduğu özelliklerle başlayıp gereksinimleriniz geliştikçe genişletin.

Neden bir aracı kimliği şablonu üzerine inşa edilir?

Bir aracı kimliği şablonu oluşturduğunuzda, Agent 365 CLI aracınız için Microsoft Entra Aracı Kimliği tedarik eder; bu, kiracınızda birinci sınıf bir kimlik olup insan kullanıcılarla aynı kuruluş yönetişimi ilkelerine tabidir. Bu tek kimlik, şablon tabanlı her aracıya otomatik olarak sağlanan güvenlik avantajlarının temelini oluşturur:

Kazanç Aracınız için ne anlama gelir
Microsoft Entra ID yönetişimi Aracının kimliği ve erişim yaşam döngüsü, insan kullanıcılara uygulanan Koşullu Erişim, kimlik koruması ve erişim incelemeleriyle aynı şekilde yönetilir.
Microsoft Purview Aracının gerçekleştirdiği her veri etkileşimi, kiracınızın duyarlılık etiketlerine, DLP ilkelerine ve bekletme ilkelerine tabidir; otomatik olarak, ek kod gerektirmez.
Microsoft Defender Aracı davranışı, anormallikler ve tehditler açısından sürekli izlenir. Şüpheli etkinlik, kiracıdaki diğer tüm kullanıcılar için olduğu gibi aynı uyarıları ve yanıt iş akışlarını tetikler.

Bu avantajlar, şablon tabanlı tüm aracılara (kullanıcı temsiline sahip aracılar ve kendi kimliğiyle çalışan aracılar dahil olmak üzere) şablon oluşturulur oluşturulmaz uygulanır. Bunları ayrı olarak yapılandırmanız gerekmez.

Aşağıdaki dört yetenek katmanı, kademeli olarak benimseebileceğiniz seviyeleri temsil eder. Aşağıdaki tablo, başlangıç noktanız temelinde Agent 365 için nelerin kullanılabilir olduğunu göstermektedir:

Özellik Microsoft 365 özel motor aracısı Diğer tüm aracılar 1
Kaydolma ✓ 2 ✓
Gözlemlenebilirlik ✓ ✓
Work IQ ✓ ✓
AI ekip arkadaşı ✓ 3 ✓ 3

1 Şu anda Microsoft Entra uygulamaları olarak kayıtlı olan aracıların, bu sütundaki herhangi bir özelliği kullanmaya başlamak için önce bir aracı kimliği şeması oluşturması gerekir.

2 Microsoft 365 özel altyapı aracıları, mevcut Microsoft Entra uygulama kaydı kullanılarak zaten kayıtlı — ek kurulum gerekli değildir.

3 Microsoft 365 özel altyapı aracıları için AI takım arkadaşı, bir aracı kimliği şeması gerektirir. Yalnızca Frontier programı katılımcıları için kullanılabilir.

Kaydol

Aracınızı kaydettiğinizde, onu Microsoft 365 yönetim merkezinde görünür ve yönetilebilir hale getirirsiniz. Yöneticiler bunu bulabilir ve kuruluşlarının aracı envanterinde görebilirler.

Neler elde edersiniz:

Neler oluşturursunuz:

Aracınızı mevcut Microsoft Entra uygulama kaydınızı veya bir şemayı kullanarak kaydedin.

Not

Aracılarınızı Google Vertex AI veya Amazon Bedrock üzerine oluşturursanız, kayıt hiçbir geliştirme işi gerektirmez. Google ve Amazon API'leri aracıları otomatik olarak çeker. SDK entegrasyonu, blueprint ve kod değişikliği gerekmiyor. Kaydolduktan sonra, gözlemlenebilirlik, Work IQ araç erişimi ve diğer özellikleri kademeli olarak eklemek için Agent 365 SDK'sını kullanabilirsiniz. Başlamak için Google Vertex AI ve Amazon Bedrock aracılarını kaydetme bölümüne bakın.

Nasıl oluşturduğunuz:

AI tarafından yönlendirilen kurulumu kullanın ve aracı türü sorularını buna göre yanıtlayın. AI tarafından yönlendirilen kurulum, bu katman için gerekli adımları gerçekleştirir. Microsoft 365 özel motor aracıları, mevcut Microsoft Entra uygulama kaydı kullanılarak bugün zaten bulunabilir.

Gözlemlenebilirlik

Aracınızı kaydettikten sonra, gözlemlenebilirliğe yatırım yapın. Bu yatırım, BT, güvenlik ekipleri ve mühendislik ekibinize aracınızın tam olarak ne yaptığını görme olanağı sağlar. Her çıkarsama çağrısı, araç çağırması ve etkileşim yakalanır, izlenir ve denetlenebilir hale getirilir.

Gözlemlenebilirlik güvenin temelidir. Olmadan, yöneticilerin davranışı doğrulamak, uyumluluğu denetlemek veya sorunları ölçekte tanılamak için hiçbir yolu yoktur. Bununla birlikte, aracınız kara kutu yerine kurumsal bir varlık haline gelir.

Not

Aracınız süper aracı ise - yani bir görevi tamamlamak için dahili olarak bir veya daha fazla alt aracıya çağrı yapıyorsa - bu alt aracı çağrıları gözlemlenebilirlik ardışık düzenine de kaydedilebilir. Bunları araç çağrısı veya aracıdan aracıya (A2A) çağrısı olarak, geçerli olduğu şekilde kaydedin; böylece tüm yetkilendirme zinciri görünür ve denetlenebilir olur.

Neler elde edersiniz:

  • Her aracı etkileşiminin tam [OpenTelemetry (OTel) (OTel)](https://opentelemetry.io/docs/specs/otel/protocol/) tabanlı izlemesi: girdiler, çıktılar, araç çağrıları ve model çağırmaları.
  • Microsoft 365 yönetim merkezi ve bağlı izleme yüzeylerinde görünür etkinlik.
  • Microsoft Entra, Microsoft Purview ve Microsoft Defender'a akışı yapılan denetim izleri; uyumluluk, veri koruma ve tehdit yanıtı gereksinimlerini destekler.

Neler oluşturursunuz:

Agent 365 SDK gözlemlenebilirlik API'leri kullanılarak araçlarla donatım: otomatik araçlarla donatım (OpenAI, LangChain veya Agent Framework kullanıyorsanız) veya diğer yığın için el ile araçlarla donatım.

Not

Çoğu yeni tümleştirme için Microsoft OpenTelemetry Distro kullanın — AI tarafından yönlendirilen kurulum gözlemlenebilirliği sizin için otomatik olarak yapılandırabilir.

Zaten yerinde bir OpenTelemetry ardışık düzeniniz varsa Agent Framework'ünüz Agent 365 SDK'sını kullanamıyorsa veya aracınız SDK tarafından henüz desteklenmeyen bir dilde (örneğin Java) oluşturulduysa, telemetriyi doğrudan Agent 365'e herhangi bir SDK bağımlılığı olmaksızın ham OTLP/HTTP üzerinden gönderebilirsiniz. Bkz. Doğrudan OTel kullanarak Agent 365 gözlemlenebilirliği ile tümleştirin.

Nasıl oluşturduğunuz:

AI tarafından yönlendirilen kurulumu kullanın ve gözlemlenebilirlik sorularını buna göre yanıtlayın. Yapay zeka rehberliğindeki kurulum, bu özellik için gereken adımları gerçekleştirir. Bu, aracınızı desteklemek için Microsoft OpenTelemetry dağıtımını kullanır.

Work IQ

Aracınızı kaydettikten ve gözlemlenebilir hale getirdikten sonra, Work IQ aracılığıyla Microsoft 365 verilerine ve eylemlerine erişim sağlayın. Work IQ, aracınızın Mail, Takvim, OneDrive, SharePoint, Teams ve daha fazlasıyla çalışmasını sağlayan yönetilen bir araç kümesidir.

Work IQ araçları yönetici onayı gerektirir, denetlenir ve iptal edilebilir. Aracınız bunları blueprint'inde tanımlanan izinleri kullanarak çağırır; ek OAuth akışları veya özel bağlayıcılar gerekmez.

Neler elde edersiniz:

  • Tam Work IQ araç kataloğuna erişim - Mail, Takvim, OneDrive, SharePoint, Teams ve daha fazlası.
  • Yöneticilerin kontrol ettiği ve aracınızın ihtiyaç duyduğu şeyle sınırlı izinler.
  • Her araç çağrısı izlenir ve gözlemlenebilirlik ardışık düzeni aracılığıyla denetlenebilir.

Neler oluşturursunuz:

Work IQ araçlarını Agent 365 SDK araçlama API'leri kullanarak çağıran aracı kodu.

Nasıl oluşturduğunuz:

Work IQ araç çağrılarını aracı kodunuza el ile eklemek için Agent 365 SDK araçlama API'leri kullanın. Yapay zeka rehberliğindeki kurulum şu anda bu özelliği desteklemez.

AI ekip arkadaşı

AI çalışma arkadaşları Frontier programı katılımcılarına sunulur.

Son aşama, aracınızın Microsoft 365'te kendi kimliğiyle çalışmasını sağlar. Yapılandırmaya bağlı olarak, bir posta kutusu, Teams varlığı, dizin girişi ve yönetici ilişkisine sahip olabilir. Kullanıcılar bununla e-posta, sohbet, toplantılar ve uygulama yüzeyleri gibi tanıdık Microsoft 365 deneyimleri aracılığıyla etkileşim kurabilir.

Not

Kimlik ve izin modeli değişikliği

AI çalışma arkadaşına geçmek, aracınızın kaynaklara nasıl eriştiğinde temel bir değişimi temsil eder. Mevcut aracınız, aracının oturum açmış bir kullanıcı adına hareket ettiği ve yalnızca o kullanıcının erişebileceği kaynakları erişebileceği temsilci kullanıcı erişimini veya bir hizmet sorumlusuna kapsamı belirlenmiş uygulama izinlerini kullanabilir. Kullanıcı kimliğine sahip bir aracı, çalışma zamanında çağıran kullanıcının erişimini devralması. Bunun yerine, kendi kullanıcı kimliğiyle, kendi erişim izinleriyle, yönetim ilkeleriyle ve denetim izi ile çalışır.

Bu değişiklik şu anlama gelir:

  • Temsilci kullanıcı erişiminde, aracı oturum açmış kullanıcı adına hareket eder ve o kullanıcının erişimiyle sınırlıdır. Aracının kendi kimliğiyle, posta kutusu, takvim, Teams ve SharePoint gibi Microsoft 365 kaynaklarına erişim izni doğrudan aracı kimliğine verirsiniz.
  • Aracı kimliğine verilen izinleri o aracının kendi erişimi olarak yönetir ve denetlersiniz. Bunlar, çağıran kullanıcı tarafından iletilen kullanıcı temsilcisi izinleriyle aynı değildir.
  • Mevcut uygulamanız temsilci kullanıcı erişimine veya uygulama izinlerine dayanıyorsa, bu özelliği etkinleştirmeden önce bu izinleri gözden geçirin ve aracı kimliği için yeniden kapsamı belirleyin.

Neler elde edersiniz:

  • Bulunabilirlik, Gözlemlenebilirlik ve Work IQ'dan her şey.
  • Kendi posta kutusu bulunan bir aracı kullanıcı kimliği - kişiler ona doğrudan e-posta gönderebilir ve bu kendi adresinden e-posta gönderebilir.
  • Microsoft 365 uygulamaları genelinde bir varlık - kişiler bununla sohbet edebilir, @mention bununla iletişim kurabılir, kanalları ekleyebilir ve Teams'te toplantılara davet edebilir; ayrıca Word, Excel, PowerPoint ve diğer M365 yüzeylerde doğrudan bununla etkileşim kurabilir.
  • Belirlenmiş bir yöneticinin altında bir kuruluş şeması girdisi - aracı kuruluşun dizininde görünür.
  • Yönetici tarafından kontrol edilen yaşam döngüsü - aracı Microsoft 365 yönetim merkezi aracılığıyla oluşturulur, yönetilir ve kullanımdan kaldırılır ve her örnek üzerinde tam yönetim sağlanır.

Neler oluşturursunuz:

Tüm özellikler, artı örnek oluşturma ve (isteğe bağlı olarak) Marketplace yayınlama.

Nasıl oluşturduğunuz:

AI destekli kurulum seçeneğini kullanın ve AI takım arkadaşı sorularını buna göre yanıtlayın. AI tarafından yönlendirilen kurulum, bu katman için gerekli adımları gerçekleştirir.

AI tarafından desteklenen kurulum

Agent 365 için aracınızın kurulumunu ve yapılandırmasını otomatikleştirmek üzere bir AI kodlama aracısı kullanın. AI destekli kurulum, kayıt, gözlemlenebilirlik, Work IQ aracı erişimi ve AI takım arkadaşı işlevselliği gibi yetenekleri etkinleştirmek için gereken önkoşul denetimleri, yapılandırma adımları ve kod tümleştirmesi konusunda size yol gösterir.

AI destekli kurulum önkoşulları

Başlamadan önce, aşağıdaki malzemelere sahip olduğunuzdan emin olun:

Gereksinim Details
AI destekli aracı Visual Studio Code ve GitHub Copilot ile GitHub Copilot Chat uzantıları veya terminal erişimine sahip başka bir AI destekli kodlama aracısı
Aracı kodu Python, Node.js veya .NET'te çalışan bir aracı projesi. Yoksa, bir hızlı başlangıç örneğiyle başlayın.
Entra rolü Global Administrator - OAuth2 izin veriş dahil tüm adımları tamamlar. Aracı Kimliği Geliştirici - OAuth2 izin veriş hariç tüm adımları tamamlar; kurulum, Global Administrator'ün devralması için bir geçiş oluşturur.

AI tarafından desteklenen kurulum adımları

Bu adımlar, tek bir aracıyı etkinleştirip etkinleştirmediğiniz veya bir aracı fabrikasını etkinleştirip etkinleştirmediğiniz konusunda geçerlidir. AI destekli aracı, gerekli araçları kontrol eder ve yüklemeyi, kimlik doğrulamayı ve doğrulamayı otomatik olarak yönetir.

Aracı projenizi açın ve bu istemi seçtiğiniz AI destekli aracıya kopyalayın. GitHub Copilot kullanıyorsanız önce aracı moduna geçin. Sor ve Düzenle modlarının terminal erişimi yoktur.

Follow the steps at aka.ms/agent365enable to enable my agent for Agent 365.

AI destekli aracı, aracınız için hangi yeteneklerin geçerli olduğunu belirlemek için size üç soru sorar:

Soru 1: Aracınız zaten Teams veya Copilot'ta kullanılabilir mi?

  • Evet
  • Hayır

Soru 2: Aracınız aşağı yönde API'leri çağırırken nasıl kimlik doğrulaması yapacak?

  • İçin adına (OBO) - aracı oturum açmış kullanıcı olarak davranır (temsilci izinleri)
  • Hizmetten hizmete (S2S) - aracı kendi kimliği olarak davranır (uygulama izinleri)
  • Her ikisi (OBO ve S2S)

Soru 3: Agent 365'in hangi özelliklerini etkinleştirmek istiyorsunuz?

Kurulum, seçiminiz için gerekli tüm ön koşul yeteneklerini otomatik olarak içerir.

AI destekli aracı daha sonra uygun katmanlardan geçerek otomatik olarak çalışır ve yalnızca sizin giriş yapmanız gerektiğinde duraklatır:

Özellik AI destekli aracının yaptığı işlemler 1
Kaydolma .NET ve Agent 365 CLI'yi denetler (eksikse yükler veya güncelleştirir), eksikse Azure CLI'yi yükler, kimliği doğrulanmamışsa az login çalıştırır, özel istemci uygulaması kaydınızı doğrular, aracı adı ve yönetici e-postasını toplar, aracınızı Teams Geliştirici Portalı içinde yapılandırır ve aracı blueprint'inizi kaydeder
Gözlemlenebilirlik Aracı kodunuza Agent 365 SDK observability enstrümantasyonu ekler
AI ekip arkadaşı a365 publish çalıştırır ve aracı örneği oluşturma dahil dağıtım sonrası adımlar konusunda sizi yönlendirir

1 Gerçekleştirilen adımlar, kurulumun başında seçtiğiniz aracı türüne ve aşamasına bağlıdır.

Önemli

Observability için AI destekli aracı kodu doğrudan projenize yazar. AI kodlama aracıları hata yapabilir. Üretim ortamına dağıtmadan önce her zaman değişiklikleri gözden geçirin.

Tamamlamak için gerekli bilgiler

AI destekli aracı, kurulum sırasında yapılandırma toplamak için duraklatılır:

İstem Sağlanacak bilgiler
Aracı adı, yönetici e-postası Temel aracı meta verileri
Türetilen değer onayı Aracı kimliği, şablonu ve kullanıcı sorumlusu için otomatik olarak oluşturulan adları gözden geçirin
Bildirim incelemesi manifest.jsondeğerinin aracınızın adı, açıklaması ve geliştirici bilgileriyle güncelleştirildiğini onaylayın

Dağıtım sonrası adımlar

Otomatik katmanlar tamamlandığında, AI destekli aracı tarayıcı etkileşimi gerektiren iki adım için duraklatılır:

  1. Bir aracı örneği oluşturun

    (Yalnızca AI ekip arkadaşı) — Microsoft Teams'de Uygulamalar'a gidin, aracınızı arayın ve Ekle'yi seçin. Yönetici onayı gerekiyorsa, Microsoft 365 yöneticiniz isteği alır. Onaylandıktan sonra, aracınız kuruluş şemanızda görünür. Ek örnekler için bkz. Aracı örnekleri oluşturun. Yeni yayımlanan bir aracının Teams aramasında görünmesi birkaç dakika sürebilir.

  2. Aracınızı test edin

    Aracınızın çalışıp çalışmadığını doğrulamak için Teams'de aracınıza bir ileti gönderin.

Bitti — aracınız dağıtılmış, yayımlanmış ve canlıdır. Aracı örnekleri oluştur bölümüne bakın; ek örnekler gerekiyorsa buradan başlayabilirsiniz.

Bir şey işe yaramazsa AI destekli aracı, hedeflenen sorun gidermeyi sağlar. Agent 365 Sorun Giderme Kılavuzu'na da başvurabilirsiniz.

El ile yol başvurusu

Bu başvuruyu yalnızca bir adımda sorun gideriyor, CI/CD otomasyonu oluşturuyor veya AI kodlama aracısı olmadan çalışıyorsanız kullanın.

Aşama Ne yapar Kılavuz
Yapılandırmayı ayarlama Kiracınız, aboneliğiniz ve proje ayrıntılarınızla a365.config.json oluşturur. Zaten dağıtılmış bir dağıtımınız varsa, mesajlaşma uç noktasını buradan ayarlayın. Agent 365 yapılandırmasını ayarla
Blueprint'i ayarlama Aracı kimliğinizi Entra'ya kaydeder ve Azure kaynaklarını (kaynak grubu, App Service Planı, Web Uygulaması) hazırlar Aracı şemasını ayarla
Dağıtma Aracı kodunuzu Azure App Service'e dağıtır. Başka bir yerde zaten barındırılmışsa isteğe bağlı. Azure · AWS · GCP
Yayımlama manifest.zip oluşturur ve Microsoft 365 yönetim merkezi'ne yükler Aracıyı yayımlama

CLI yüklemesi, komutları ve sorun giderme için Agent 365 CLI bölümüne bakın.

Aracınızı Microsoft Marketplace'e yayımla

Aracınızı kendi kiracınız veya kiracılarınızda tam olarak geliştirip test ettikten sonra, Microsoft Marketplace'te kullanılabilir hale getirin.

Bunu yapmak için İş Ortağı Merkezi'nde bir Microsoft AI Cloud İş Ortağı Programı hesabınız olması gerekir. Hesabınız yoksa, PartnerID'nizi almak için bir hesap oluşturun. Ardından, aracı tekliflerini yayımlamak için gereken kaynaklara ve desteğe erişim sağlayan Microsoft 365 ve Copilot programına kaydolun. Kaydolduktan sonra gönderim denetim listesini ve doğrulama yönergelerini gözden geçirin ve aracınızı İş Ortağı Merkezi adım adım gönderim kılavuzu aracılığıyla gönderin.

İş Ortağı Merkezi kullanarak aracınızı Microsoft Marketplace'e gönderme hakkında bilgi edinin.

Tamamladıktan sonra, aracınız Microsoft Marketplace'te yayımlanır ve müşterilerin bunu keşfetmesi ve dağıtması için kullanılabilir hale gelir.

AI destekli kurulumun sorunlarını giderme

AI destekli kurulum sırasında sorunlarla karşılaşırsanız, aşağıdaki yaygın sorunları ve çözümlerini bkz.

Sorun Açıklama
AI destekli aracı terminal komutlarını çalıştırmıyor AI destekli aracı komutları tanımlar ancak bunları yürütmez
AI destekli aracı adımları atlıyor Kurulum gerekli adımları atlıyor gibi görünüyor
CLI komutları izin hataları ile başarısız oluyor a365 CLI komutları çalıştırılırken yetkilendirme hataları
Yapılandırma değerleri yanlış a365.config.json oluşturduktan sonra yapılandırma değerlerini değiştirme gereksinimi

AI destekli aracı terminal komutlarını çalıştırmıyor

AI destekli aracı komutları tanımlar ancak bunları yürütmüyorsa, GitHub Copilot Chat'te Aracı modunu kullandığınızdan emin olun. Sor ve Düzenle modlarının terminal erişimi yok.

AI destekli aracı adımları atlıyor

Yönerge dosyası kesin adım sıralamasını uygular. AI destekli aracı bir adımı atlamış görünüyorsa, baştan başlamasını isteyin:

Please start from Step 1 in the setup instructions and work through each step in order.

CLI komutları izin hataları ile başarısız olur

a365 CLI komutları yetkilendirme hataları ile başarısız olursa, en yaygın neden eksik veya tamamlanmamış özel istemci uygulaması kaydıdır. AI destekli aracı bu kaydı kurulum sırasında doğrular, ancak doğrulama atlanırsa bkz. Özel istemci uygulaması kaydı.

Genel sorun giderme için bkz. Agent 365 Sorun Giderme Kılavuzu.

Yapılandırma değerleri yanlış

a365.config.json oluşturduktan sonra yapılandırma değerlerini değiştirmeniz gerekiyorsa:

  • Dosyayı doğrudan düzenleyin ve a365 config init -c ./a365.config.json komutunu yeniden çalıştırın
  • AI destekli aracıdan belirli değerleri güncelleştirmesini isteyin
  • Last updated on