Ana içeriğe geç

Microsoft Teams Entegrasyonu

Automind Agentflow platformu, otomasyon ajanınızı doğrudan Microsoft Teams'de oluşturmanıza ve dağıtmanıza olanak tanır, ekibinizin iletişim iş akışıyla sorunsuz entegrasyon sağlar.

Ön Koşullar​

Automind Agentflow'u Microsoft Teams ile entegre etmeden önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • Oluşturulmuş ve yayınlanmış bir Automind Agentflow botu
  • Uygun izinlere sahip bir Microsoft Teams hesabı
  • Microsoft Teams Developer Portal'a erişim
  • Teams kuruluşunuzda uygulama yükleme için yönetici hakları

Not: Microsoft Teams kanal entegrasyonu bulut dağıtımı gerektirir. Şirket içi kurulumlar Teams entegrasyonu için sınırlı işlevselliğe sahip olabilir.

Bu belgeler, Developer Portal kullanarak Automind Agentflow'u Microsoft Teams ile nasıl entegre edeceğinizi açıklar. Ek entegrasyon seçenekleri için Microsoft Teams Platform belgelerine bakın.

Adım 1: Automind Agentflow'da Microsoft Teams Kanalı Oluşturma​

  1. Kanal Oluşturma Erişimi

    • Automind Agentflow Portal'ınıza giriş yapın
    • Kenar çubuğu menüsünden Channels'a gidin
    • Yeni kanal oluşturmaya başlamak için Yeni düğmesine tıklayın

  2. Temel Bilgileri Yapılandırma

    • Teams kanalınız için açıklayıcı bir İsim girin
    • Kanalın amacını açıklayan bir Açıklama sağlayın
    • Açılır menüden Ajanınızı seçin
    • Platform açılır menüsünden Teams'i seçin
    • Devam etmek için Kanalı Oluştur'a tıklayın

  3. Teams Özel Ayarlarını Yapılandırma

    • Teams uygulamanız için Bot Kimliği'ni girin
    • Uygulama Kimliği'ni (Azure'dan Microsoft Uygulama Kimliği) girin
    • Devam etmek için İleri'ye tıklayın

  4. Kanal Kurulumunu Tamamlama

    • Webhook yapılandırması için son sayfada görüntülenen Çağırma URL'sini kopyalayın
    • Kurulumu tamamlamak için Kanal Oluştur'a tıklayın
    • Kanal oluşturulacak ve etkinleştirilecektir

  5. Mevcut Bağlam Parametreleri Başarılı kanal etkinleştirmesinden sonra, Automind Agentflow otomatik olarak aşağıdaki kullanıcı bağlam parametrelerini sağlar:

    • [[ChatUser]].ChannelId = "msteams"
    • [[ChatUser]].UserId - Teams kullanıcı hesabı için benzersiz tanımlayıcı
    • [[ChatUser]].Email - Kullanıcının e-posta adresi
    • [[ChatUser]].FirstName - Kullanıcının adı
    • [[ChatUser]].LastName - Kullanıcının soyadı
    • [[ChatUser]].DomainUserName - Domain kullanıcı adı

  6. Yapılandırmayı Kaydetme

    • Kanal kurulumunu tamamlamak için Save & Close'a tıklayın

Adım 2: Microsoft Teams Developer Portal Kullanarak Uygulama Paketi Oluşturma​

Developer Portal'a Erişim​

  1. Teams Developer Portal'ı Açma

    • Microsoft Teams istemcisinde sol kenar çubuğundaki ... (taşma menüsü) öğesine tıklayın
    • Menüden Developer Portal'ı seçin

  2. Developer Portal'ı Yükleme (gerekirse)

    • Developer Portal yüklü değilse, Teams uygulama mağazasında "Developer Portal" araması yapın
    • Developer Portal'a tıklayın ve yükleyin
    • Uygulama artık sol menünüzde mevcut olacaktır

Yeni Uygulama Oluşturma​

  1. Yeni Uygulama Oluşturmaya Başlama

    • Developer Portal'da Apps sekmesine tıklayın
    • Teams uygulamanızı oluşturmaya başlamak için New App'a tıklayın

  2. Temel Bilgileri Yapılandırma

    • Automind Agentflow uygulamanız için açıklayıcı bir ad girin
    • Devam etmek için Create'e tıklayın

  3. Uygulama Detaylarını Ayarlama

    • Configure > Basic Information'a gidin
    • Aşağıdaki gerekli alanları doldurun:
      • App name: Automind Agentflow adınız
      • Short description: Ajanınızın yeteneklerinin kısa açıklaması
      • Long description: Özelliklerin ve kullanım durumlarının ayrıntılı açıklaması
      • Developer information: Kuruluş detaylarınız
      • Partner ID: Automind Agentflow kanal yapılandırmanızdan Microsoft Partner Network ID'sini girin

  4. İzinleri Yapılandırma

    • Configure > Permissions'a gidin
    • Device Permissions altında şunları seçin:
      • Send the user notifications
      • Ajanınızın gerektirdiği ek izinler

  5. Bot Özelliklerini Ayarlama

    • Configure > App features'a gidin
    • Sağ panelde Bot'a tıklayın
    • Enter a bot ID'yi seçin
    • Automind Agentflow portalından kopyaladığınız Microsoft Application ID'yi yapıştırın

İpucu: Microsoft Application ID'yi Automind Agentflow Portal'ınızdan Bot Settings > Channels > Teams altından kopyalayabilirsiniz.

  1. Bot Yeteneklerini Yapılandırma Botunuz için uygun yetenekleri ve kapsamları seçin:

    • Capabilities: Ajanınız dosya işlemleri gerçekleştiriyorsa "Upload and download files"'ı etkinleştirin
    • Scopes: Maksimum esneklik için hem Personal hem de Team'i seçin

  2. Güvenilir Domainler Ekleme (İsteğe Bağlı) Automind Agentflow'unuz hassas veri işleme gerektiriyorsa:

    • Configure > Domains'e gidin
    • Aşağıdaki güvenilir domainleri ekleyin:
      • token.botframework.com
      • Automind Agentflow API domaininiz (dağıtım bölgenize özel)

  3. Uygulama Paketini İndirme

    • Sağ üst köşedeki Distribute düğmesine tıklayın
    • Download the app package'ı seçin
    • Paket varsayılan indirme klasörünüze kaydedilecektir

Adım 3: Uygulamanızı Doğrulama​

Automind Agentflow'unuzu Teams'e dağıtmadan önce uygulama paketini doğrulayın:

  1. Doğrulama Sürecini Başlatma

    • Developer Portal'da Publish > App validation'a gidin
    • Doğrulamayı başlatmak için Get Started'a tıklayın

  2. Doğrulamayı Çalıştırma

    • Sunulan üç doğrulama adımını gözden geçirin
    • Otomatik kontrolleri çalıştırmak için Start validation'a tıklayın
    • Doğrulama sırasında belirlenen sorunları ele alın

  3. Doğrulama Tamamlanması

    • Doğrulama başarıyla geçtikten sonra yayınlamaya devam edebilirsiniz
    • Seçenekler şunları içerir:
      • Kuruluşunuza yayınlama
      • Teams mağazasına yayınlama (ek onay gerektirir)
      • Doğrudan Teams'e yükleme

Adım 4: Microsoft Teams'e Automind Agentflow Yükleme​

Önemli: Microsoft Teams'de özel uygulamalar yüklemek için uygun izinlere (takım sahibi veya yönetici) sahip olmanız gerekir.

Not: Teams'de bot yüklemesi aşamalıdır ve büyük kuruluşlar için 48 saat kadar sürebilir. Yükleme sırasında takım üyeleri botu sol menülerinde görecek ve hoş geldin mesajları alabilirler.

Yükleme Süreci​

  1. Takım Yönetimine Erişim

    • Microsoft Teams'de sol kenar çubuğundaki Teams'e gidin
    • Ajanı yüklemek istediğiniz takıma sağ tıklayın
    • Bağlam menüsünden Manage team'i seçin

  2. Özel Uygulama Yükleme

    • Takım yönetimi sayfasında Apps sekmesine tıklayın
    • Upload an app veya Upload a custom app'a tıklayın

  3. Uygulama Paketini Yükleme

    • Adım 2'de indirilen uygulama paketini bulun ve seçin
    • Yükleme sürecini başlatmak için Open'a tıklayın
    • Manifest doğrulaması geçerse yükleme başlayacaktır

  4. Yüklemeyi Doğrulama

    • Automind Agentflow takımın uygulama listesinde görünecektir
    • Takım üyeleri ajanı Teams arayüzlerinde görecekler
    • Yüklemenin tüm takım üyelerine yayılması zaman alabilir

Adım 5: Automind Agentflow'unuzu Kullanmaya Başlama​

Ajana Erişim​

  1. Doğrudan Erişim

    • Automind Agentflow Portal'dan Bot Settings > Channels'a gidin
    • Doğrudan sohbet açmak için Teams kanal simgesine tıklayın
    • Bu, test ve yönetim için anında erişim sağlar

  2. Teams Arayüzü

    • Takım üyeleri ajanı Teams sol kenar çubuğunda bulabilir
    • Sohbet başlatmak için ajana tıklayın
    • Ajan hem doğrudan mesajları hem de takım kanalı etkileşimlerini destekler

Özellikler ve Yetenekler​

Teams'teki Automind Agentflow'unuz şunları destekler:

  • Etkileşimli Sohbetler: Kullanıcı sorguları için doğal dil işleme
  • Dosya İşleme: Yükleme ve indirme yetenekleri (yapılandırılmışsa)
  • Otomasyon İş Akışları: Yapılandırılmış otomasyon süreçlerini yürütme
  • Bağlam Farkındalığı: Kullanıcı bilgilerine ve takım bağlamına erişim
  • Zengin Yanıtlar: Kartlar, düğmeler ve multimedya içeriği desteği

Not: Microsoft Teams kanalı güvenli veri girişi ve işlemeyi destekler. Hassas bilgiler kuruluşunuzun güvenlik politikalarına göre işlenir.

Sınırlamalar ve Dikkat Edilecek Hususlar​

Teknik Sınırlamalar​

  • Sayfalama: Teams zengin içerik için yerleşik sayfalamaya sahiptir:
    • Tekrarlayıcılı hero düğmeleri: Sayfa başına 6 öğe
    • Tekrarlayıcılı hero kartları: Sayfa başına 9 öğe

Dağıtım Dikkat Edilecek Hususlar​

  • Yükleme Süresi: Büyük kuruluşlar tam dağıtım için 48 saate kadar gecikme yaşayabilir
  • İzinler: Uygulama yükleme için uygun yönetici haklarına sahip olduğunuzdan emin olun
  • Ağ: Teams'in Automind Agentflow uç noktalarınıza erişebildiğini doğrulayın

En İyi Uygulamalar​

  • Hoş Geldin Mesajları: Yeni kullanıcıları yönlendirmek için uygun hoş geldin akışları yapılandırın
  • Hata İşleme: Daha iyi kullanıcı deneyimi için açık hata mesajları uygulayın
  • Test: Kuruluş genelinde dağıtımdan önce ajanınızı kapsamlı şekilde test edin
  • Belgeler: Kullanıcılara mevcut komutlar ve özellikler hakkında rehberlik sağlayın

Sorun Giderme​

Yaygın Sorunlar​

  1. Uygulama Paketi Doğrulaması Başarısız

    • Developer Portal'da tüm gerekli alanların doldurulduğunu doğrulayın
    • Microsoft Application ID'nin Automind Agentflow yapılandırmanızla eşleştiğini kontrol edin
    • manifest.json'ın Teams şema gereksinimlerini takip ettiğinden emin olun

  2. Yükleme Gecikmeleri

    • Teams uygulama yüklemesi aşamalıdır; 48 saate kadar izin verin
    • Özel uygulama yüklemelerini kısıtlayabilecek kuruluş politikalarını kontrol edin
    • Hedef takım için uygun izinlere sahip olduğunuzu doğrulayın

  3. Ajan Yanıt Vermiyor

    • Automind Agentflow kanalının aktif ve yayınlanmış olduğunu onaylayın
    • Teams ile ajan uç noktalarınız arasındaki ağ bağlantısını kontrol edin
    • Hata mesajları için Automind Agentflow Portal'daki günlükleri gözden geçirin

  4. İzin Sorunları

    • Botun gerekli kapsamlara (Personal ve Team) sahip olduğundan emin olun
    • Harici hizmetler kullanıyorsanız güvenilir domainlerin yapılandırıldığını doğrulayın
    • Cihaz izinlerinin ajanınızın yetenekleriyle uyumlu olduğunu kontrol edin

Destek Kaynakları​

  • Microsoft Teams Platform Belgeleri
  • Automind Agentflow Destek Portalı
  • Teams Geliştirici Topluluğu
  • Azure Bot Framework Belgeleri