Microsoft Teams a Microsoft 365
Stránku MS Teams pre administrátorov nájdete v hlavnej navigácii; plugin nainštalujete a nastavíte v Nastavenia → Pluginy. Bot odpovedá v osobných chatoch, skupinových chatoch aj kanáloch Teams a jeho nástroje vedia pristupovať k Microsoft 365 za prepojenú osobu. Nastavenie kanála a každodenné používanie opisuje stránka Microsoft Teams.
Kde to nájdete
Plugin nainštalujete a nastavíte v Nastavenia → Pluginy. Stránka MS Teams je iba pre administrátorov a nájdete ju v hlavnej navigácii. Jej karta Ľudia a prístup vypisuje známych ľudí, ich prepojené účty Elowen a všetky pravidlá prístupu. Balíček aplikácie stiahnete v hlavičke pracovného prostredia. Ostatné nastavenia bota zostávajú dostupné na karte Nastavenia pracovného prostredia aj v detaile pluginu.
Plugin registruje chatovú platformu msteams a naučené chaty a kanály ponúka ako ciele naplánovaných oznámení. Ostatným pluginom tiež poskytuje ovládací prvok microsoftIdentity, ale iba vtedy, keď je prepájanie účtov v osobnom chate nastavené a funguje. Ten vie overiť, či je účet Elowen prepojený, a schválenému odberateľovi odovzdať Graph klienta obmedzeného na cesty v úložiskách: osobný OneDrive a knižnice dokumentov SharePoint danej osoby.
Nástroje
Plugin ponúka 17 nástrojov v štyroch skupinách.
Správy v Teams: TeamsSend posiela správu do konverzácie, ktorú bot už pozná; TeamsMessagePerson napíše osobe podľa e-mailu, ID objektu Entra, ID účtu Teams alebo zobrazovaného mena. Keď má daná osoba prepojený účet Elowen, odpoveď napíše jej vlastný agent; inak, alebo keď agent neodpovie, bot otvorí alebo využije existujúci osobný chat a text odošle sám. TeamsSendFile ponúkne súbor v osobnom chate. Príjemca musí kartu prijať, až potom sa súbor nahrá do jeho OneDrivu. Zmienky možno zadať ID, e-mailom alebo presným zobrazovaným menom. Nejednoznačné mená bot neuhádne.
Adresár Teams: TeamsFindPerson, TeamsChatInfo, TeamsMembers, TeamsMemberInfo a TeamsListConversations čítajú osoby a konverzácie, na ktoré bot dosiahne. Týchto päť nástrojov je bezpečných pri plánovaní. Prečítanie zoznamu členov pridá jeho členov do adresára známych ľudí bota.
API Teams: TeamsApi zavolá Bot Connector API pre operáciu, na ktorú nie je samostatný nástroj.
Microsoft 365: Týchto osem nástrojov koná za prihlásenú osobu v rámci jej delegovaných oprávnení. Tokeny zostávajú v službe Bot Framework Token Service.
MicrosoftDirectory: prihlásený používateľ, ľudia, používatelia Entra, organizačná schéma a členstvá v skupinách.MicrosoftSharePoint: weby, zoznamy, položky zoznamov a moderné stránky.MicrosoftFiles: súbory v OneDrive a SharePointe vrátane nahrávania, sťahovania, verzií a odkazov na zdieľanie.MicrosoftOutlook: pošta, kalendár a kontakty vrátane príloh, konceptov, odpovedí a reakcií na udalosti.MicrosoftTasks: To Do a Planner.MicrosoftOneNote: poznámkové bloky, oddiely a stránky.MicrosoftExcel: hárky, tabuľky a oblasti v zošitoch Microsoft 365.MicrosoftTeams: chaty a kanály za prihlásenú osobu.
Každé volanie Microsoft 365 znova zistí aktuálne prepojený účet. Relácia Excelu patrí danej identite Microsoft a danému zošitu, po desiatich minútach bez používania vyprší a pri reštarte démona sa stratí. Hranice produktu a delegovaných relácií opisuje architektúra pluginu.
Počas plánovania je bezpečných iba päť nástrojov adresára Teams a MicrosoftDirectory. Ostatné nástroje pluginu sa považujú za meniace údaje.
Inštalácia a pripojenie
- Použite Elowen core 0.30.7 alebo novší. Plugin vyžaduje zdieľané plugin API verzie 14 a web API verzie 55.
- Nainštalujte ho v Nastavenia → Pluginy → Dostupné pluginy. Pri zapnutí plugin požiada o oprávnenie, ktoré prežije jednu odpoveď – v tomto prípade meniť používateľov. Deklarované čítanie zdieľaných úložísk a súborov Projektu nájdete v detaile pluginu. Zapnutie, vypnutie aj uloženie nastavení vyžiada reštart démona, ktorý môže počkať na bežiace ťahy. Zmeny sa najprv uložia; ak reštart nemožno vyžiadať, prejavia sa pri najbližšom štarte.
- Zaregistrujte aplikáciu Entra pre jediného tenanta, vytvorte k nej Azure Bot pre jediného tenanta, pridajte kanál Teams a nastavte jeho koncový bod správ na
/hooks/msteams/messages. Stiahnite balíček aplikácie v pracovnom prostredí Microsoft Teams a nahrajte ho v centre správy Teams. Postup nastavenia opisuje stránka Microsoft Teams. - V Nastavenia → Prístupy → Microsoft Teams zadajte ID aplikácie bota, tajný kľúč klienta a ID tenantu. Kým nie sú vyplnené všetky tri, bot sa nepripojí.
- Ak chcete zapnúť prihlasovanie v osobnom chate a nástroje Microsoft 365, vytvorte samostatnú registráciu aplikácie Entra a pripojenie OAuth v Azure Bote s poskytovateľom Entra ID v2 a delegovanými rozsahmi Microsoft 365. Zadajte presný názov pripojenia a zapnite prihlasovanie v osobnom chate. Delegované rozsahy musí v Microsofte odsúhlasiť administrátor tenantu.
- Keď je prepájanie účtov zapnuté, prepojte identitu: člen tenantu sa môže prihlásiť v osobnom chate, alebo administrátor prepojí existujúci účet Elowen v Ľudia a prístup. Prepojenie používa nemenné Entra object ID, nie meno ani e-mail.
Prihlasovanie cez Microsoft do webového rozhrania Elowen je samostatná voľba. Zapnite ju v nastaveniach pluginu a zaregistrujte jej URI pre spätné volanie v aplikácii bota. Presmerovanie a zakladanie účtov opisuje stránka Microsoft Teams.
Účet vzniknutý touto cestou sa zakladá rovnako ako účet, ktorý administrátor pridá v Používatelia: začína s oprávneniami inštancie pre nové účty a dedí predvolené nastavenia účtov inštancie. Plugin sám volí iba jeho Projekt (Nový osobný projekt pre každý nový účet, alebo Predvolené projekty nových účtov); modely, oprávnenia pluginov, oprávnenia nástrojov a správanie schvaľovania sa nastavujú raz pre všetky nové účty v Používatelia → Možnosti → Predvolené nastavenia používateľov.
Konfigurácia
Nastavenia pluginu nájdete v detaile pluginu; ID aplikácie, tajný kľúč klienta a ID tenantu sa zadávajú v Nastavenia → Prístupy, kam odkazuje detail pluginu aj karta Nastavenia pracovného prostredia. Tajný kľúč klienta je iba na zápis: uloží sa zašifrovaný a rozhranie ukazuje len to, či je nastavený.
Pripojenie bota a prihlasovanie
| Nastavenie | Kľúč | Predvolená hodnota | Účel |
|---|---|---|---|
| Microsoft App ID | appId |
nenastavené | Povinné ID klienta aplikácie bota pre jediného tenanta. |
| Tajný kľúč klienta | appPassword |
nenastavené | Povinný tajný kľúč na overovanie voči Bot Connectoru. |
| ID tenantu | tenantId |
nenastavené | Povinné ID tenantu Entra. |
| Prihlásenie k Microsoftu v osobnom chate | accountLinking |
false |
Umožní aktívnym členom tenantu prihlásiť sa v osobnom chate a používať prístup svojho prepojeného účtu Elowen. |
| Názov pripojenia OAuth | oauthConnectionName |
nenastavené | Zobrazí sa, keď je prihlasovanie zapnuté; presný názov pripojenia OAuth v Azure Bote. |
| Povoliť prihlásenie cez Microsoft | ssoEnabled |
false |
Pridá prihlásenie cez Microsoft na prihlasovaciu stránku Elowen. |
| Verejná adresa Elowen | ssoRedirectBase |
prázdne | Základná URL s HTTPS a bez cesty. V aplikácii bota zaregistrujte <base>/api/auth/sso/microsoft/callback. |
| Zakladanie účtov | ssoProvision |
off |
tenant (Celý tenant) dovolí ktorémukoľvek aktívnemu členovi tenantu založiť si účet pri prvom prihlásení. Členov od hostí rozlišuje claim acct v ID tokene (aplikácia bota → Konfigurácia tokenu); bez neho je potrebné aplikačné oprávnenie Microsoft Graph User.Read.All so súhlasom administrátora tenantu. |
| Prepájať existujúce účty podľa e-mailu | ssoLinkByEmail |
true |
Pri prvom prihlásení môže prepojiť jeden existujúci účet s rovnakým e-mailom. Neskoršie párovanie identity používa Entra object ID. |
| Nový osobný projekt pre každý nový účet | ssoNewPersonalProject |
false |
Vytvorí jeden spravovaný osobný Projekt pre každý nový účet. Keď je zapnuté, Predvolené projekty sa nepoužijú. |
| Predvolené projekty nových účtov | ssoDefaultProjects |
nenastavené | Aktívne Projekty priradené každému novému účtu, keď je voľba osobného Projektu vypnutá. Je potrebný aspoň jeden; inak sa založenie účtu odmietne a žiadny účet nevznikne. |
Prístup k Microsoft 365
| Nastavenie | Kľúč | Predvolená hodnota | Účel |
|---|---|---|---|
| Prístup k Microsoft 365 | m365AccessMode |
read_only |
Voľba Iba na čítanie blokuje zmeny v Microsoft 365. Voľba Čítanie a zápis každú zmenu najprv zobrazí ako náhľad, kým agent túto presnú operáciu nepotvrdí. |
| Limit prenosu súborov v Microsoft 365 | m365MaxTransferBytes |
20 MiB | Limit na jedno volanie od 1 MiB do 250 MiB. Väčšie nahrávanie použije obnoviteľnú reláciu nahrávania. Ide o pokročilé nastavenie. |
Voľba prístupu sa zobrazí, keď je zapnuté prihlasovanie v osobnom chate.
Aplikácia v Teams a oznámenia
| Nastavenie | Kľúč | Predvolená hodnota | Účel |
|---|---|---|---|
| Názov aplikácie v Teams | agentName |
Elowen | Názov aplikácie a bota v balíčku aplikácie a v /help. Prázdna hodnota znamená Elowen. |
| Názov vydavateľa v Teams | productName |
názov aplikácie | Vydavateľ uvedený v balíčku aplikácie. Prázdna hodnota znamená názov aplikácie. |
| Ikona aplikácie v Teams | appIconPath |
nenastavené | Absolútna cesta na serveri k PNG 192 × 192. Prázdna hodnota použije jednoduchý farebný štvorec. |
| Konverzácia pre oznámenia | notifyConversationId |
nenastavené | Naučený cieľ v Teams pre naplánované oznámenia; prázdna hodnota ich vypne. |
| Vyhľadávanie cez Microsoft Graph | graphLookup |
false |
Umožní botovi nájsť neznámy e-mail v tenante a nainštalovať svoju aplikáciu v Teams, aby otvoril osobný chat. Vyžaduje súhlas administrátora tenantu s User.ReadBasic.All a TeamsAppInstallation.ReadWriteSelfForUser.All. Profilové fotky navyše vyžadujú ProfilePhoto.Read.All. |
| ID aplikácie v katalógu Teams | graphCatalogAppId |
nenastavené | Zobrazí sa, keď je vyhľadávanie cez Graph zapnuté; ID aplikácie v katalógu Teams organizácie. |
Odpovede a konverzácie
| Nastavenie | Kľúč | Predvolená hodnota | Účel |
|---|---|---|---|
| Odpovedať bez zmienky | respondWithoutMention |
true |
V skupinových chatoch odpovedať každému namapovanému odosielateľovi, alebo iba na zmienku. V tímových kanáloch sa správy bez zmienky dostanú k botovi iba vtedy, keď je zapnutá voľba Čítať všetky správy v kanáli a vlastník tímu prijal aktualizovanú aplikáciu. |
| Aktivita nástrojov | toolActivity |
status |
Možnosti: off, status, live. Riadi správy o priebehu. |
| Doručenie odpovede | answerMode |
final |
final odpovie na konci ťahu; live prúdi odpoveď tak, ako sa píše. |
| Detail výstupu nástrojov | toolOutput |
summary |
Možnosti: hidden, summary, tail. |
| Rozloženie správ nástrojov | toolMessageMode |
single |
Možnosti: single jedna upravovaná správa o priebehu, alebo per_tool správa pre každý nástroj. |
| Nahradiť priebeh finálnou odpoveďou | deleteToolActivityAfterTurn |
false |
Použije správu o priebehu na finálnu odpoveď; prebíja priebežnú odpoveď aj rozloženie po nástrojoch. |
| Reakcie počas spracovania | reactions |
true |
Ukazuje stav spracovania pomocou reakcií. |
| Pätička s údajmi o behu | runtimeFooter |
true |
Pridá do finálnej odpovede malý riadok s modelom a kontextom. |
| Zobraziť uvažovanie | showReasoning |
false |
Zahrnie uvažovanie rozšíreného myslenia do správ o priebehu. |
| Jazyk služobných správ | language |
en |
Jazyk služobných správ bota; agent odpovedá jazykom používateľa. |
| Načítanie histórie konverzácie | historyLimit |
0 |
Koľko posledných správ sa načíta do novej konverzácie, od 0 do 100. |
| Čítať všetky správy v kanáli | channelMessagesRsc |
false |
Pridá do balíčka aplikácie oprávnenie, aby bot videl všetky správy v tíme po tom, ako vlastník odsúhlasí aktualizovaný balíček. |
| Model pre obrázky | visionModel |
nenastavené | Model pre správy s obrázkami; prázdna hodnota použije bežný model chatu. |
Správa pravidiel prístupu
Pravidlo pridáte, upravíte, preusporiadate alebo vymažete v Ľudia a prístup, ešte skôr než bot niekoho pozná. Vyberte osobu a upravte pravidlo pre jej Entra object ID, ID účtu Teams alebo UPN. Ak má niekoľko identifikátorov vlastné pravidlá, vyberte ten, ktorý chcete upraviť; úprava ani vymazanie jedného ostatné neodstráni.
Celý zoznam prijíma aj celé ID konverzácií a jediné záložné pravidlo *. Prvé zodpovedajúce
pravidlo rozhoduje o prístupe, doplňujúcich pokynoch a správe miestností Teams. Pri aktivácii
runtime identifikátory oreže, z duplicít ponechá prvé a * presunie na koniec. Pravidlá konverzácií
platia iba pre zodpovedajúcu konverzáciu, takže pohľad osoby nedokáže určiť prístup v každom zdieľanom chate.
Projekty a oprávnenia nástrojov prepojeného účtu majú naďalej prednosť.
Úprava pravidla otvorí formulár. Uložiť pravidlo odošle celé pravidlo; samotné písanie neuloží čiastočný identifikátor. Vymazanie vyžaduje potvrdenie a odstráni iba vybrané pravidlo. Danú osobu môžu naďalej pustiť iné identifikátory, pravidlá konverzácií alebo záložné pravidlo. Zapnuté prihlasovanie k Microsoftu v osobnom chate zostáva dostupné a vymazanie pravidla neodpojí účet Elowen.
Keď uloženie zlyhá, formulár alebo potvrdenie vymazania zostane otvorené. Konflikt revízií vyriešte podľa spoločnej spätnej väzby k ukladaniu a potom aktuálne pravidlo otvorte znova. Hlásenie o čakajúcej aktivácii znamená, že zmena je uložená, ale stále čaká na vyžiadaný reštart démona.
Limity médií a pravidlá prístupu
| Nastavenie | Kľúč | Predvolená hodnota | Účel |
|---|---|---|---|
| Max. veľkosť prichádzajúceho obrázka | maxImageBytes |
5 MiB | Limit prílohy s obrázkom, od 1 do 20 MiB. |
| Max. obrázkov na správu | maxImages |
4 | Koľko obrázkov sa pošle modelu pre obrázky, od 1 do 10. |
| Max. obrázkov na odpoveď | maxUploadImages |
4 | Vygenerované obrázky pripojené k jednej odpovedi, od 1 do 10. |
| Pravidlá prístupu podľa roly | rolePolicies |
nenastavené | Odosielateľa pustí prvé zodpovedajúce pravidlo: Entra object ID, UPN/e-mail, ID konverzácie, alebo posledné * pre všetkých. Príznak admin zapína príkazy na správu miestnosti a kontext dôveryhodnej miestnosti; prístup k Projektom a nástrojom naďalej určuje prepojený účet Elowen. |
Oprávnenia a limity
Plugin nie je podmienený pridelením pre jednotlivých používateľov. Odosielateľa z Teams pustí zodpovedajúce pravidlo roly alebo prepojený účet; nástroje Microsoft 365 vyžadujú overený účet Elowen prepojený s identitou Microsoft. Pracovné prostredie Teams a jeho API cesty sú iba pre administrátorov. Ak je prepájanie účtov zapnuté bez názvu pripojenia OAuth, bot zostane bežať na diagnostiku, ale správy z osobných chatov ľudí s prepojeným účtom bezpečne zlyhajú. Chýbajúca alebo nesprávne veľká nastavená ikona spôsobí, že stiahnutie balíčka aplikácie zlyhá.
Chat bota používa Bot Connector a nepotrebuje oprávnenia Microsoft Graph. Vyhľadávanie cez Graph vyžaduje vyššie uvedené aplikačné oprávnenia. Nástroje Microsoft 365 nemôžu prekročiť delegované rozsahy pridelené prihlásenej osobe. Ostatné pluginy, ktoré používajú microsoftIdentity, dostanú iba Graph klienta obmedzeného na úložiská, nikdy token ani prístup k pošte, kalendáru či chatom.
- Delegované volania Graph vypršia po 15 sekundách; výstup nástroja je obmedzený na 20 000 znakov.
- Čítanie Microsoft Graph za prihlásenú osobu sa skúša najviac trikrát, keď ho Graph obmedzuje, vráti chybu servera alebo spadne spojenie, a tieto pokusy zdieľajú jednu lehotu 15 sekúnd. Zápisy a každé volanie s vlastnými aplikačnými oprávneniami bota sa odošle raz. Volanie Bot Connectoru sa opakuje iba po odpovedi o obmedzení, nikdy po neznámom výsledku.
- Hľadanie v SharePointe vracia najviac 1 000 výsledkov.
- Vymazanie je vypnuté v nástrojoch pre SharePoint, súbory, Outlook a úlohy. Ostatné zmeny vyžadujú, aby agent potvrdil presný náhľad; režim iba na čítanie ich blokuje všetky.
- Ponuky súborov fungujú iba v osobných chatoch 1:1, majú limit 20 MB a úspech znamená, že ponuka bola doručená, nie prijatá.
- Zoznam členov ukáže najviac 50 členov, hľadanie osoby vráti najviac 25 zhôd a priama odpoveď Bot Connectoru sa skráti na 4 000 znakov.
- Adresár známych ľudí zahŕňa osoby, ktoré bot stretol v prevádzke Teams. Chýbajúca osoba napriek tomu môže v tenante existovať.