Microsoft Teams

Plugin Microsoft Teams nastavíte v Nastavenia → Pluginy → Microsoft Teams. Cez Azure Bot prepája Elowen s osobnými chatmi, skupinovými chatmi a tímovými kanálmi. Najprv ho nainštalujte v Nastavenia → Pluginy → Dostupné pluginy.

Pravidlá pre identity a konverzácie, ktoré platia pre všetky kanály, popisuje časť Kanály.

Čo plugin ponúka

Bot zvládne Adaptive Cards, priebežné informácie o práci nástrojov, obrázky, proaktívne správy z úloh cron aj pravidelných kontrol a na stiahnutie ponúka balíček aplikácie Teams. Napísať vie do konverzácií aj ľuďom, ktorých už pozná. Voliteľné vyhľadávanie cez Microsoft Graph dokáže nájsť nového človeka podľa e-mailu a otvoriť s ním chat.

Nastavenie bota

Potrebujete registráciu aplikácie Microsoft Entra pre jediný tenant a prostriedok Azure Bot, ktorý používa ID tejto aplikácie.

1. V centre spravovania Entra vytvorte registráciu aplikácie s voľbou Kontá iba v tomto organizačnom adresári. Skopírujte ID aplikácie (klienta) a ID adresára (tenantu) a potom vytvorte tajný kľúč klienta.
2. V portáli Azure vytvorte Azure Bot typu Single Tenant s rovnakým ID aplikácie.
3. Nastavte jeho koncový bod pre správy na https://<domain>/hooks/msteams/messages a povoľte kanál Microsoft Teams. Verejná reverzná proxy s HTTPS musí smerovať /hooks/ na démona.
4. V Elowen otvorte Nastavenia → Prístupy → Microsoft Teams a vyplňte polia Microsoft App ID, Tajný kľúč klienta a ID tenantu.
5. Otvorte stránku MS Teams, zvoľte Stiahnuť balíček aplikácie, nahrajte súbor v centre spravovania Teams → Spravovať aplikácie a aplikáciu potom pridajte do chatu alebo tímu.

Plugin sa pripojí až po vyplnení všetkých troch prihlasovacích údajov bota. Bežný chat s botom ide cez Bot Connector a oprávnenie Microsoft Graph nepotrebuje. Po zmene nastavení balíčka, napríklad Čítať všetky správy v kanáli, Názov aplikácie v Teams, Názov vydavateľa v Teams alebo Ikona aplikácie v Teams, stiahnite nový balíček.

Kto smie bota používať

Pravidlá prístupu spravujte na stránke MS Teams na karte Ľudia a prístup. V zdieľaných chatoch rozhoduje prvé zodpovedajúce pravidlo; odosielateľ, ktorému nezodpovedá žiadne, nedostane odpoveď. Pravidlo môže zodpovedať ID objektu Entra, ID účtu Teams začínajúcemu 29:, UPN alebo e-mailovej adrese, napríklad alex@contoso.com, celému ID konverzácie, alebo * ako záverečné pravidlo pre všetkých. Pravidlo s * nechajte nakoniec.

Zapnutím voľby Administrátor Teams pri pravidle povolíte príkazy na správu miestnosti a dôveryhodný kontext miestnosti. Neudeľuje účet Elowen, prístup k projektom, oprávnenia nástrojov, prístup k Microsoftu ani práva prevádzkovateľa inštancie. Tie vychádzajú z účtu Elowen prepojeného s odosielateľom a z jeho oprávnení.

Príjem správ z tímových kanálov

Teams zvyčajne posiela botovi správy z kanálov, ktoré ho spomínajú. Ak chcete dostávať všetky správy v tímovom kanáli, kde je aplikácia nainštalovaná:

1. Zapnite Čítať všetky správy v kanáli.
2. Stiahnite a nahrajte aktualizovaný balíček aplikácie.
3. Požiadajte vlastníka tímu, aby pri inštalácii alebo aktualizácii aplikácie v každom tíme schválil oprávnenie ChannelMessage.Read.Group.

Toto oprávnenie je oddelené od súhlasu administrátora tenantu s aplikačnými oprávneniami. Aj s ním však platí, že keď je Odpovedať bez zmienky vypnuté, správy, ktoré bota neoslovujú, sa odfiltrujú. Odpovedať bez zmienky je v predvolenom nastavení zapnuté.

Načítanie histórie konverzácie je v predvolenom nastavení 0 a prijíma hodnoty 0–100. Uchováva priebežný prepis správ, ktoré bot videl. So súhlasom pre tímový kanál môže nová konverzácia vo vlákne kanála načítať celé vlákno aj cez Microsoft Graph.

Prepojenie účtov Microsoft a práca s Microsoft 365

K dispozícii sú dve samostatné možnosti prihlásenia:

• Prepojenie účtu v osobnom chate používa pripojenie OAuth v Azure Bote a delegované oprávnenia Microsoft 365. Vytvorte druhú aplikáciu Entra pre jediný tenant, pridajte adresu presmerovania https://token.botframework.com/.auth/web/redirect, udeľte potrebné delegované oprávnenia a v Azure Bote nastavte pripojenie s poskytovateľom Microsoft Entra ID v2. Pole Token Exchange URL nechajte prázdne. Presný názov pripojenia zadajte do poľa Názov pripojenia OAuth a zapnite Prihlásenie k Microsoftu v osobnom chate.
• Prihlásenie na webe používa tok OIDC aplikácie bota. Zapnite Povoliť prihlásenie cez Microsoft, do poľa Verejná adresa Elowen zadajte verejnú adresu Elowen cez HTTPS a v aplikácii bota zaregistrujte túto adresu s doplnenou cestou /api/auth/sso/microsoft/callback ako adresu presmerovania.

Prepojenie v osobnom chate a prihlásenie na webe sú dve rozdielne veci. Pri zapnutom Prihlásení k Microsoftu v osobnom chate sa aktívny člen tenantu môže prihlásiť z osobného chatu a používať prístup svojho prepojeného účtu. Prepájať existujúce účty podľa e-mailu dokáže pri prvom prihlásení na webe priradiť práve jeden existujúci účet Elowen; po prepojení je trvalou identitou ID objektu Entra. Administrátori môžu v pracovnom priestore Teams použiť Prepojiť účet Elowen a priradiť známu identitu Teams inému existujúcemu účtu. Nejednoznačné alebo konfliktné prepojenia sa odmietnu.

Voľbou Celý tenant v Zakladaní účtov vytvoríte účty pre aktívnych členov nastaveného tenantu. Členov od hostí Elowen rozlíši podľa voliteľného claimu acct v ID tokene; pridajte ho v Token configuration aplikácie bota. Bez tohto claimu sa Elowen opýta Microsoft Graphu, čo vyžaduje aplikačné oprávnenie User.Read.All so súhlasom administrátora tenantu. Hostia, zakázané účty a identity mimo tenanta sa odmietnu. Predvolené projekty nových účtov a Nový osobný projekt pre každý nový účet platia len pre novo založené účty; existujúce účty sa nemenia.

Nástroje Microsoft 365 konajú delegovanou identitou a oprávneniami prepojeného účtu všade, kde sa tento účet používa, vrátane zdieľaných chatov a osobných naplánovaných úloh. Tokeny zostávajú v službe Bot Framework Token Service, nie v Elowen. Prístup k Microsoft 365 je v predvolenom nastavení Iba na čítanie. Čítanie a zápis každú zmenu najprv zobrazí v náhľade, kým ju agent výslovne nepotvrdí. Delegovaná aplikácia potrebuje len oprávnenia pre nástroje, ktoré používate. Rozumná sada je:

openid profile email offline_access
User.Read User.Read.All People.Read
Files.ReadWrite.All Sites.ReadWrite.All
Mail.ReadWrite Mail.Send Mail.ReadWrite.Shared Mail.Send.Shared
Calendars.ReadWrite Calendars.ReadWrite.Shared
Contacts.ReadWrite Tasks.ReadWrite
Group.ReadWrite.All Notes.ReadWrite.All
Chat.ReadWrite ChatMessage.Send
Team.ReadBasic.All Channel.ReadBasic.All ChannelMessage.Read.All ChannelMessage.Send

offline_access nechajte, aby pripojenie prežilo vypršanie tokenu. GroupMember.Read.All pridajte len vtedy, keď volania členstva v skupinách adresára hlásia, že chýba. Adaptér Teams Chat.Read.All nevyžaduje.

Súbory a proaktívne správy

Ponuky súborov fungujú len v osobných chatoch medzi dvoma ľuďmi, nie v skupinových chatoch ani v tímových kanáloch. V poli Konverzácia pre oznámenia zvoľte, kam majú chodiť proaktívne správy z úloh cron a pravidelných kontrol. Prijíma známe ID konverzácie alebo osobu určenú e-mailom, ID objektu Entra, ID účtu 29: alebo jednoznačným zobrazovaným menom. Prázdne pole proaktívne správy vypne.

Voliteľné Vyhľadávanie cez Microsoft Graph slúži pre ľudí, ktorých bot nikdy nevidel. Aplikácia bota potrebuje súhlas administrátora tenantu s User.ReadBasic.All a TeamsAppInstallation.ReadWriteSelfForUser.All; ProfilePhoto.Read.All je voliteľné. ID aplikácie v katalógu Teams je ID nahranej aplikácie Teams v centre spravovania Teams → Spravovať aplikácie, nie ID aplikácie bota. Prázdne ho nechajte len vtedy, keď aplikáciu Teams používateľom nasadzuje politika aplikácií.

Príkazy

Teams zobrazuje ovládanie modelu, uvažovania, zobrazenia a kontextu ako Adaptive Cards. Dostupné príkazy dodáva bežiaci démon.

/model, /reasoning, /display, /context, /plan, /build a /workflow vyžadujú pravidlo roly administrátora. Aj /stop, /stats, /compact a /restart sú len pre administrátorov. Nástroje Microsoft 365 sú dostupné cez prepojenie účtu a delegovaný prístup, nie ako príkazy chatu.

Ďalej: WhatsApp