Aracılığıyla paylaş

Aracı şeması ve örnek kurulumu

Önemli

Microsoft Agent 365'e erken erişim elde etmek için Frontier önizleme programının bir parçası olmanız gerekir. Frontier sizi Doğrudan Microsoft'un en son yapay zeka yenilikleri ile bağlar. Sınır önizlemeleri, müşteri sözleşmelerinizin mevcut önizleme koşullarına tabidir. Bu özellikler hala geliştirme aşamasında olduğundan, bunların kullanılabilirliği ve özellikleri zaman içinde değişebilir.

Not

Aracı kimliği kimlik doğrulaması, kullanabileceğiniz iki Kimlik doğrulama akışından biridir. Diğeri, Adına (OBO) akışıdır.

Aracılı kimlik doğrulama akışı, bir aracının kendi kimliğiyle davranmasını sağlar. Bu akışta:

  • Aracı kendi kimlik bilgilerini (aracı şema kimlik bilgileri) kullanarak kimlik doğrulaması yapar
  • Aracı kendi atanmış izinleriyle bağımsız olarak çalışır
  • Aracı, herhangi bir kullanıcıdan ayrı olarak kendi kimliğine sahiptir
  • Bu akış, kullanıcı bağlamı gerektirmeyen otonom aracı işlemleri için idealdir

Kullanım örnekleri:

  • Otonom aracı işlemleri (zamanlanmış görevler, izleme)
  • Aracının posta kutusundan e-posta gönderme veya toplantı oluşturma
  • Aracıya ait kaynakları oluşturma ve yönetme
  • Kullanıcı etkileşimi olmadan arka plan işleme

Aracılı kimliğinizi oluşturma

Aracınızı aracı kimlik doğrulamasıyla geliştirmek ve test etmek için aracı kimliğini oluşturmanız ve Microsoft 365'e kaydetmeniz gerekir. Bu kimlik, aracınızı oluştururken araç, gözlemlenebilirlik ve bildirimler gibi özelliklerini test etmenizi sağlar.

Aracı oluşturma işlemi üç temel adımdan oluşur:

  1. Yapılandırma - Aracı 365 CLI yapılandırmasını başlatma
  2. Kurulum - Azure kaynakları ve aracı şeması oluşturma
  3. Örnek oluşturma - Aracı uygulama kimliği ve kullanıcı oluşturma

Önkoşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

Gerekli izinler:

  • Aşağıdaki rollerden birine sahip geçerli kiracı kullanıcısı:
    • Genel Yönetici
    • Aracı Kimliği Yöneticisi
    • Aracı Kimliği Geliştiricisi
  • Kaynak oluşturma izinlerine sahip bir Azure aboneliğine erişim

4. Adım: Aracıyı yapılandırma

a365 config init komutu, tüm Agent 365 CLI komutları tarafından kullanılan merkezi yapılandırma dosyasını oluşturura365.config.json. CLI, el ile girişi en aza indirmek için Azure CLI tümleştirmesi ve akıllı varsayılanlar ile etkileşimli bir sihirbaz sağlar.

Azure AD ile kimlik doğrulaması

Yapılandırmayı başlatmadan önce şu komutu kullanarak Azure ile kimlik doğrulaması gerçekleştirin:az login

az login

Uygun aboneliği ve projeyi seçin. Yapılandırma sihirbazı kullanılabilir abonelikleri, kaynak gruplarını ve app service planlarını sorgulamak için Azure CLI kullanır.

İlk; Temel; Yapılandırma

Etkileşimli yapılandırma sihirbazını başlatmak için aşağıdaki komutu çalıştırın:

a365 config init

Sihirbaz, el ile girişi en aza indirmek için Azure CLI tümleştirmesini ve akıllı varsayılanları kullanır. Sizden aşağıdakiler istenir:

Alan Veri Akışı Açıklaması Örnek
Aracı adı Benzersiz tanımlayıcı (yalnızca alfasayısal) myagent
Dağıtım projesi yolu Aracı proje dizininizin yolu C:\MyAgent\sample-agent
Yönetici e-postası Bu aracıyı denetleen yöneticinin e-postası manager@yourtenant.onmicrosoft.com
Azure kaynakları Mevcut kaynak gruplarından ve app service planlarından seçim yapın (Etkileşimli seçim)

Sihirbaz otomatik olarak ilgili kaynak adlarını, kimlikleri oluşturur ve proje türünüzü doğrular.

Kullanılabilirlik sınırlaması

Şu anda desteklenen tek Azure bölgeleri şunlardır:

  • centralindia
  • westeurope
  • westus

Farklı bir bölge seçerseniz veya dosyadaki a365.config.json özelliği el ile düzenlersenizlocation, aracı şeması oluşturmaya çalıştığınızda aşağıdaki hatayı görürsünüz.

The selected region ('{location}') is not supported by the Agent 365 CLI. Choose a supported region and ensure your web app name ('{webAppName}') is globally unique

Yapılandırma dosyası yapısı hakkında daha fazla bilgi edinin

Yapılandırmayı doğrulama

Tüm değerlerin a365 config display doğru olduğunu doğrulamak için yapılandırmanızı görüntülemek için komutunu kullanın:

a365 config display

2. Adım: Aracı şeması oluşturma

a365 setup komutu Azure kaynaklarını oluşturur ve aracı şemanızı kaydeder. Şema, aracınızın kimliğini, izinlerini ve altyapı gereksinimlerini tanımlar. Bu adım, Azure'da aracınızı dağıtma ve çalıştırmanın temelini oluşturur.

Kurulumu Çalıştırma

komutunu yürütün.

a365 setup

Kurulum işlemi şu işlemleri gerçekleştirir:

  1. Azure altyapısı oluşturur (henüz yoksa):

    • Kaynak grubu
    • Belirtilen SKU ile App Service Planı
    • Yönetilen kimliğin etkinleştirildiği Azure Web App

  2. Aracı şemasını kaydeder:

    • Microsoft Entra kiracınızda aracı şemasını oluşturur
    • Microsoft Entra uygulama kayıtları oluşturur
    • Aracı kimliğini gerekli izinlerle yapılandırıyor

  3. API izinlerini yapılandırma

    • Microsoft Graph API kapsamlarını ayarlar
    • Mesajlaşma Botu API izinlerini yapılandırıyor
    • Aracı örnekleri için devralınabilir izinleri uygular

  4. Yapılandırma dosyalarını güncelleştirir:

    • Oluşturulan kimlikleri ve uç noktaları a365.generated.config.json
    • Yönetilen kimlik ve kaynak bilgilerini kaydeder

Not

Kurulum sırasında tarayıcı pencereleri yönetici onayı için açılır. Devam etmek için bu onay akışlarını tamamlayın. Kurulum genellikle 3-5 dakika sürer ve yapılandırmayı öğesine a365.generated.config.jsonotomatik olarak kaydeder.

Kurulumu doğrulama

Kurulum başarıyla tamamlandıktan sonra, tamamlanan tüm adımları gösteren bir özet görmeniz gerekir. Oluşturulan kaynakları doğrulayın:

  1. Oluşturulan yapılandırmayı görüntüleyin:

    a365 config display -g

    Bu değerlerin mevcut olduğunu onaylayın:

    • agentBlueprintId - Aracı şemanızın uygulama kimliği
    • agentBlueprintObjectId - Blueprint'in Microsoft Entra Id
    • managedIdentityPrincipalId - Sistem tarafından atanan yönetilen kimlik sorumlusu kimliği

  2. Azure Portal'da Azure kaynaklarını gözden geçirin:

    Aşağıdaki kaynakların oluşturulduğunu doğrulayın:

    • Kaynak Grubu:

      • Kaynak gruplarına gidin ve ilgili kaynak grubunu seçin.
      • App Service Planınızı ve Web Uygulamanızı içerdiğini doğrulayın

    • App Service Planı

      • App Service planları - Azure App Service
      • Planınızı bulun ve fiyatlandırma katmanının yapılandırma SKU'nuzla eşleşip eşleşmedığını doğrulayın

    • Web uygulaması

      • App Services>Web Apps'e gidin
      • Web uygulamanızı bulun ve ardından Atanan Ayarlar>Kimlik>Sistemi'ne gidin
      • Durumun Açık olduğunu doğrulama
      • Nesne (sorumlu) kimliği eşleşmelerine dikkat edin managedIdentityPrincipalId

  3. Azure Portal'da Microsoft Entra uygulamalarını doğrulayın:

    Azure Active DirectoryUygulama kayıtları bölümüne gidin.

    • Aracı şemanızı şu şekilde arayın: agentBlueprintId
    • Uygulamayı açın ve API izinleri'ni seçin
    • İzinlerin yeşil onay işaretleriyle verildiğini doğrulayın:
      • Microsoft Graph (temsilci ve uygulama izinleri)
      • Mesajlaşma Botu API izinleri
    • Tüm izinler "[Kiracınız] için verildi" ifadesini göstermelidir

3. Adım: Aracı örneği oluşturma

komut, a365 create-instance aracı şemanız için aracı uygulama kimliğini ve aracı kullanıcısını oluşturarak kimlik doğrulamasını ve izinleri etkinleştirir. Bu, aracınızın kendi kimliği ve kimlik bilgileriyle belirli bir örneğini oluşturarak Microsoft 365 ortamınızda kimlik doğrulaması ve çalışma olanağı sağlar.

Örnek oluşturma

Şu komutu çalıştırın:

a365 create-instance

Ne yapar:

  1. Aracı uygulama kimliği oluşturur - Bu aracı örneği için Microsoft Entra Kimliği
  2. Aracı kullanıcı oluşturur - Aracı örneği için hizmet sorumlusu
  3. Aracı şema kimliğini kullanır - Oluşturulan yapılandırmadan (a365.generated.config.json)
  4. Yönetici onayı verir - Şemadan devralınan izinleri otomatik olarak uygular
  5. Yapılandırmayı güncelleştirir - Yeni aracı kimlik bilgilerini yerel ortama kaydeder

Beklenen Çıktı:

Her aşama için ilerleme iletileri görürsünüz:

  • 1. Aşama: Aracı Kimliği ve Aracı Kullanıcısı Oluşturma
  • Yönetici onayı istekleri (tarayıcı pencereleri açılır)
  • 2. Aşama: Lisans ataması
  • Yapılandırma Güncelleştirildi

Örneği doğrulama

  1. Oluşturulan yapılandırmayı görüntüleyin:

    a365 config display -g

    Aşağıdaki değerlerin mevcut olduğunu doğrulayın:

    • AgenticAppId - Aracı örneği uygulama kimliğiniz
    • AgenticUserId - Aracı kullanıcı kimliğiniz

  2. Azure Portal'da doğrulama:

    • Azure Active Directory>Uygulama kayıtları bölümüne gidin.
    • Aracı uygulama kimliğinizi bulun (kimlik için oluşturulan yapılandırmayı denetleyin)
    • API izinlerinin verildiğini ve onay verildiğini doğrulama

Sonraki adımlar

Aracı kimliğiniz artık kayıtlı ve hazır. İleri:

  1. Araç özellikleri ekleme - Microsoft 365 araçlarını etkinleştirme (kimlik doğrulamasını test için önerilir)
  2. Aracınızı test edin - Agent Playground ile doğrulama
  • Last updated on