Configurați Microsoft 365 pentru mediul dvs.
Există două moduri de a conecta Microsoft 365 la mediul dvs. AI-Corporate. Alegeți mai întâi ruta potrivită organizației dvs.
| Rută | Când | Ce faceți |
|---|---|---|
| Aplicația centrală AI-Corporate (implicit) | Conectări personale cu Outlook Mail, Outlook Calendar, Teams și SharePoint/OneDrive. | Un administrator Entra acordă consimțământul organizației prin Conectarea Microsoft 365. După aceea, activați integrările conform pasului 5 din acest articol. Nu este nevoie de o aplicație proprie, secret client sau Identity Provider. |
| Aplicație Entra proprie | Doriți să importați central foldere SharePoint în baza de cunoștințe, angajații se autentifică deja cu Microsoft printr-o aplicație proprie sau doriți să administrați singuri aplicația. | Urmați acest articol începând cu pasul 1. |
Dacă organizația dvs. se autentifică deja cu Microsoft printr-o aplicație proprie (câmpul Microsoft ID al mediului este completat), atunci toate conectările folosesc acea aplicație proprie. Ruta centrală nu se aplică în acest caz.
Aplicație Entra proprie
Cu o aplicație Microsoft Entra proprie, organizația dvs. poate folosi aceeași aplicație pentru autentificare cu Microsoft și pentru Outlook, Teams și SharePoint. Dumneavoastră decideți central ce integrări și acțiuni de scriere sunt disponibile. Utilizatorii activează sau dezactivează apoi doar conectările personale în Preferințe → Tools → Conectări.
Integrările personale funcționează cu modele suportate de OpenAI, Claude, Gemini și Mistral. Modelul ales trebuie să poată folosi tools. La conectările personale, accesul urmează drepturile utilizatorului Microsoft autentificat. Consimțământul organizației nu autentifică automat toți angajații și nu oferă AI-ului acces independent la toate cutiile poștale. Baza de cunoștințe SharePoint centrală folosește permisiuni separate ale aplicației și drepturile existente ale bazei de cunoștințe, așa cum este descris mai departe în acest articol.
De ce aveți nevoie?
- O organizație Microsoft 365 cu Microsoft Entra ID și conturi cu acces la serviciile dorite.
- Un administrator care poate înregistra o aplicație și poate acorda consimțământul organizației pentru permisiunile Microsoft Graph alese. O simplă rolă de abonament Azure nu este suficientă; rolul dvs. Entra trebuie să permită acest consimțământ.
- Drepturi de administrare în mediul AI corect pentru a face integrările disponibile.
- Un administrator de platformă care poate configura Microsoft Identity Provider pentru acest mediu AI în Google Cloud Identity Platform.
- Un app registration în propriul dvs. Microsoft directory, cu un client secret și cele două URL-uri de redirecționare ale brandului corect.
Autentificarea cu Microsoft și accesul la datele Microsoft sunt două funcții separate. Doar o autentificare Microsoft funcțională nu înseamnă încă faptul că Outlook, Teams sau SharePoint este configurat.
1. Înregistrați o singură aplicație organizațională
Deschideți Microsoft Entra admin center și mergeți la App registrations → New registration. Folosiți un nume ușor de recunoscut, de exemplu AI-Corporate – numele organizației dvs.. Pentru o organizație proprie, alegeți Accounts in this organizational directory only (Single tenant).
Salvați următoarele informații din Overview:
| Informație | Pentru ce? |
|---|---|
| Directory (tenant) ID | Directory-ul Microsoft al organizației dvs.; acesta intră în câmpul Microsoft ID al mediului AI. |
| Application (client) ID | Aplicația înregistrată; aceasta intră în Microsoft Identity Provider. |
Aceste două ID-uri sunt diferite. La Microsoft ID nu introduceți client ID-ul sau Firebase tenant ID-ul.
2. Configurați URL-urile de redirecționare corecte
Mergeți la Authentication → Add a platform → Web. Adăugați pentru brandul dvs. ambele URL-uri de mai jos, exact cum sunt afișate. Primul procesează autentificarea; al doilea procesează consimțământul pentru integrările de cont de lucru.
| Brand | Autentificare cu Microsoft | Integrări de cont de lucru |
|---|---|---|
| AI-School | https://ai-school-pro.firebaseapp.com/__/auth/handler | https://europe-west1-ai-school-pro.cloudfunctions.net/completeConnectorOAuth |
| AI-Corporate | https://ai-corporate.firebaseapp.com/__/auth/handler | https://europe-west1-ai-corporate.cloudfunctions.net/completeConnectorOAuth |
| AI-Public | https://ai-public-pro.firebaseapp.com/__/auth/handler | https://europe-west1-ai-public-pro.cloudfunctions.net/completeConnectorOAuth |
Folosiți URL-urile brandului pe care rulează mediul dvs. Numele propriu al organizației sau tenant ID-ul nu trebuie introduse în aceste URL-uri. URL-ul website-ului, URL-ul dashboard-ului și URL-ul .web.app nu înlocuiesc aceste callback-uri. Înregistrați-le ca Web, chiar dacă folosiți integrarea dintr-un browser. Nu trebuie să activați implicit token issuance sau public client flow pentru asta.
3. Creați un client secret și atribuiți permisiuni
Mergeți la Certificates & secrets → Client secrets → New client secret. Alegeți o perioadă de valabilitate potrivită și salvați în siguranță Value imediat ce devine vizibilă. Furnizați valoarea prin canalul securizat convenit pentru administrarea platformei; Secret ID nu este client secret-ul. Urmăriți data de expirare și înlocuiți secretul înainte de acea dată, inclusiv în Identity Provider.
Apoi mergeți la API permissions → Add a permission → Microsoft Graph → Delegated permissions. Adăugați doar permisiunile necesare pentru integrările și acțiunile pe care organizația dvs. le va oferi.
| Integrare | Permisiuni de citire | Permisiuni suplimentare pentru scriere |
|---|---|---|
| Profil / bază | User.Read; fluxul de autentificare solicită și openid, profile, email și offline_access | Niciuna |
| Outlook Mail | Mail.Read | Drafts: Mail.ReadWrite. Trimitere: Mail.Send. |
| Outlook Calendar | Calendars.Read | Scriere: Calendars.ReadWrite. |
| Microsoft Teams | Chat.Read, ChannelMessage.Read.All | Postare: Team.ReadBasic.All, Channel.ReadBasic.All, ChannelMessage.Send. |
| SharePoint / OneDrive | Sites.Read.All, Files.Read.All | Această integrare de cont de lucru nu oferă aici acțiuni de scriere. |
Mail.ReadWrite nu oferă drept de trimitere; pentru aceasta este necesar separat Mail.Send. Postarea în Teams scrie mesaje text într-un canal ales, nu mesaje private de chat. Pentru această integrare folosiți Delegated permissions, nu Application permissions. Chiar și la permisiunile cu All în nume, accesul delegat rămâne limitat de drepturile utilizatorului.
Faceți clic pe Grant admin consent for organizația dvs. și verificați că permisiunile alese apar ca acordate. Astfel, angajații pot folosi accesul aprobat fără să fie nevoiți să acorde singuri drepturi organizaționale. Microsoft poate solicita în continuare autentificare, MFA sau reconfirmarea consimțământului, în funcție de politica dvs.
4. Conectați aplicația în două locuri la mediul AI
Rugați administratorul de platformă să selecteze mediul corect și să efectueze aceste setări:
- În Admin → Environment → Tenant: activați metoda de autentificare Microsoft și introduceți la Microsoft ID Directory (tenant) ID.
- În Google Cloud → Identity Platform → tenantul relevant → Identity providers → Microsoft: activați providerul și introduceți Application (client) ID și client secret Value din aceeași aplicație Entra.
Identity Provider aparține tenantului Firebase/Identity Platform al mediului dvs. AI, nu unei alte organizații și nici mediului general Admin. Integrarea de cont de lucru reutilizează aplicația din acest provider. Client secret-ul nu trebuie introdus în preferințele utilizatorilor, în mesajele de chat sau în câmpuri obișnuite de mediu.
Oferiți administrării platformei numele organizației, brandul, Directory ID, client ID, valoarea secretului prin canalul securizat, data de expirare și integrările/permisiunile dorite. Un app ID singur nu este suficient.
5. Activați integrările și acțiunile de scriere
Deschideți mediul de administrare al organizației dvs. → Tools → MCP. Activați integrarea Microsoft 365 în Suite shortcuts. Rândurile Microsoft vor deveni vizibile; când întreaga suită este dezactivată, acele rânduri rămân ascunse.
Alegeți pentru fiecare integrare dacă este disponibilă. În coloana Scriere actions alegeți separat:
- Outlook Mail → Drafts: creați și modificați drafturi.
- Outlook Mail → Send: trimiteți efectiv un draft existent.
- Outlook Calendar → Write: creați și modificați întâlniri.
- Microsoft Teams → Post: plasați mesaje text într-un canal Teams ales.
Faceți clic pe Salvare. O acțiune de scriere funcționează doar dacă sunt activate atât integrarea, cât și dreptul de administrare asociat, Microsoft a acordat permisiunile necesare și utilizatorul a activat personal conectarea. Utilizatorul nu primește pentru aceasta un formular suplimentar de drepturi de scriere.
Setările trebuie să fie suportate și de backend-ul brandului dvs. Această extensie de scriere a fost publicată și testată direcționat pe 7 octombrie 2026 pentru OnderwijsSupport pe AI-Corporate. Asta nu înseamnă automat că aceeași extensie este deja disponibilă pentru AI-School, AI-Public sau orice alt mediu. Cereți confirmare administrării platformei atunci când lipsesc acțiunile de scriere.
6. Verificați configurarea
Rugați un utilizator să se autentifice în mediul AI corect și să activeze integrarea dorită conform Utilizarea integrărilor Microsoft. Verificați dacă Microsoft afișează numele propriei dvs. aplicații Entra.
Testați mai întâi un draft recognoscibil și o întâlnire fără participanți. Verificați elementele salvate în Outlook. Apoi testați trimiterea cu un destinatar de test convenit și postarea în Teams într-un canal de test convenit. O întâlnire cu participanți poate trimite invitații sau actualizări. O comandă de trimitere acceptată nu înseamnă încă livrare confirmată.
La extinderea permisiunilor, conectarea încearcă să reînnoiască tokenurile. Dacă Microsoft solicită din nou autentificare sau consimțământ, rugați utilizatorul să reconecteze conectarea existentă. Nu este nevoie să creați o a doua aplicație sau o setare separată pentru utilizator.
Depanare
| Problemă | Verificare |
|---|---|
AADSTS50011 / redirect mismatch | Ambele callback-uri înregistrate exact ca Web, pentru brandul corect. |
| Apare alt nume de aplicație la consimțământ | Mediul AI corect, Directory ID și Microsoft Identity Provider specific tenantului; reconectați apoi. |
| Login funcționează, dar integrarea nu | Verificați și callback-ul connectorului, permisiunile Graph și consimțământul organizației. |
| Citirea merge, scrierea nu | Verificați dreptul de administrare, permisiunea Graph delegată aferentă, consimțământul acordat și disponibilitatea backend-ului. |
| Client secret invalid sau expirat | Value, nu Secret ID; actualizați noul secret și în Identity Provider. |
| Integrarea lipsește pentru utilizator | Verificați disponibilitatea în Tools, drepturile utilizatorului pentru conectări și mediul AI selectat. |
Mai multe informații
- Administrarea Tools
- Utilizarea integrărilor Microsoft
- Microsoft: înregistrarea unei aplicații
- Microsoft: URL-uri de redirecționare
- Microsoft Graph: referință permisiuni
Bază de cunoștințe SharePoint centrală: configurarea Microsoft
Un folder conectat central funcționează prin aplicația organizației, fără ca fiecare angajat să activeze o conexiune SharePoint personală. Pentru aceasta sunt necesare două consimțăminte separate: permisiunea aplicației Sites.Selected cu admin consent, și un grant read pe site-ul SharePoint ales. O autentificare Microsoft funcțională sau doar admin consent nu este suficientă.
1. Verificați aplicația organizațională
Folosiți aceeași single-tenant app registration ca pentru autentificarea Microsoft în mediul dvs. AI. O aplicație existentă poate fi extinsă; nu este nevoie de o a doua aplicație de integrare. Verificați în Microsoft Entra → App registrations → aplicația dvs. → Overview Directory (tenant) ID și Application (client) ID. Folosiți mai jos client ID-ul, nu Object ID.
Directory ID trebuie să fie în Admin → Environment → Tenant → Microsoft ID. Client ID și Value unui client secret valid trebuie să fie la Microsoft Identity Provider al exact acelui mediu AI. Această configurare este gestionată de administrarea platformei. Un secret expirat împiedică și importul central; urmăriți data de expirare.
Conexiunea centrală de server folosește client_credentials și nu solicită un URL suplimentar de redirect. Redirect-urile Web existente pentru autentificare și integrările personale de cont de lucru rămân necesare; folosiți URL-urile specifice brandului din tabelul de mai devreme din acest articol.
2. Adăugați permisiunea aplicației și acordați admin consent
- Deschideți API permissions → Add a permission → Microsoft Graph → Application permissions.
- Căutați Sites.Selected, selectați această permisiune și faceți clic pe Add permissions.
- Rugați un administrator Entra autorizat să execute Grant admin consent for organizația dvs..
- Verificați că Sites.Selected, tip Application, apare ca acordat.
Permisiunile delegate pentru conectările personale Outlook, Teams și SharePoint pot rămâne pe aceeași aplicație. Ele nu înlocuiesc permisiunea aplicației pentru baza de cunoștințe centrală. Pentru acest import central nu este necesară permisiunea aplicației Sites.Read.All, Sites.ReadWrite.All sau Sites.FullControl.All.
3. Acordați aplicației acces de citire separat la site
Această acțiune de administrare poate fi făcută cu Microsoft Graph Explorer. Folosiți un cont de administrator în același Microsoft directory, cu rolul SharePoint Administrator sau un rol administrativ echivalent superior și acces la site-ul respectiv. O rolă de abonament Azure sau doar proprietatea asupra aplicației nu sunt suficiente pentru aceasta.
- Autentificați contul de administrator în Graph Explorer și verificați organizația afișată.
- Deschideți profilul dvs. → Consent to permissions, căutați Sites.FullControl.All și alegeți Consent pentru a acorda permisiunea necesară pentru Graph Explorer în acest context administrativ. La unele interogări, puteți deschide și panoul complet de permisiuni prin Modify Permissions → Open the permissions panel. Aceasta este o permisiune de administrare delegated pentru gestionarea site grants; nu o adăugați ca permisiune largă de aplicație pe aplicația bazei de cunoștințe. Folosiți consimțământul legat de cont atunci când consimțământul organizațional pentru toți utilizatorii nu este necesar.
- Găsiți site ID-ul cu următorul GET. Înlocuiți hostul de exemplu și calea site-ului cu cele ale propriului dvs. folder. La un URL cu
/teams/, folosiți acea cale în loc de/sites/.
GET https://graph.microsoft.com/v1.0/sites/uworganisatie.sharepoint.com:/sites/uwsite?$select=id,displayName,webUrl
Valoarea id din răspuns este site ID-ul complet, inclusiv numele gazdei și două GUID-uri. Verificați și displayName și webUrl: grant-ul trebuie să ajungă pe site-ul în care se află cu adevărat folderul dvs.
- Verificați mai întâi granturile existente cu GET la adresa de mai jos. Dacă client ID-ul dvs. apare deja acolo cu rolul
read, nu trebuie să creați un al doilea grant. Cereți administratorului Microsoft să evalueze granturile existente mai largi sau diferite.
GET https://graph.microsoft.com/v1.0/sites/SITE-ID/permissions
- Dacă grant-ul lipsește, alegeți POST, folosiți aceeași adresă și introduceți următorul JSON la Request Body. Înlocuiți cele două valori de exemplu;
CLIENT-ID-VAN-UW-APPeste Application (client) ID al aplicației dvs. de integrare, nu aplicația Graph Explorer.
{
"roles": ["read"],
"grantedToIdentities": [
{
"application": {
"id": "CLIENT-ID-VAN-UW-APP",
"displayName": "NAAM-VAN-UW-INTEGRATIE-APP"
}
}
]
}
- Alegeți Run query. O adăugare reușită returnează 201 Created. Verificați în răspuns rolul
readși client ID-ul; Graph le poate afișa subgrantedToIdentitiesV2. Verificați apoi din nou cu GET. Păstrați permission ID-ul pentru administrare și eventualele revocări ulterioare. - Repetați acest lucru doar pentru fiecare alt site pe care doriți în mod conștient să conectați foldere de bază de cunoștințe.
Grant-ul Microsoft oferă aplicației acces de citire la întregul site selectat. Mediul AI importă doar folderul ales și subfolderele. Folosiți preferabil un site separat pentru cunoștințe partajate central. Drepturile existente ale bazei de cunoștințe stabilesc ce utilizatori primesc documentele importate; drepturile individuale SharePoint nu sunt preluate.
4. Conectați folderul și verificați rezultatul
Deschideți Administrare → Baza de cunoștințe → Adăugare → Foldere SharePoint → Conectare folder și folosiți URL-ul real al folderului, nu un link de invitație sau adresa de prezentare generală OneDrive. Alegeți domeniul, publicul țintă și starea publicării conform manualului bazei de cunoștințe. O sursă centrală nu necesită un conector personal în preferințele utilizatorului.
Verificați cu Reîmprospătează dacă documentele au fost procesate fără erori. Folosiți Sincronizează acum pentru o nouă verificare și apoi adresați o întrebare concretă în chat despre un document importat. Verificați că răspunsul menționează sursa corectă de cunoștințe centrală.
| Problemă | Verificare pe partea Microsoft |
|---|---|
| Login funcționează, dar folderul central nu | Sites.Selected trebuie să fie de tip Application și să aibă admin consent; verificați și grant-ul separat pentru site. |
403 Forbidden la accesarea folderului | Microsoft directory corect, site ID, client ID și read-grant; admin consent singur nu acordă acces la site. |
403 la acțiunea de administrare în Graph Explorer | Delegated Sites.FullControl.All, consimțământ acordat, rol administrativ și acces la site-ul țintă. Nu adăugați o permisiune largă în aplicația de integrare ca soluție. |
| Site-ul funcționează, folderul nu este găsit | Verificați URL-ul real al folderului, biblioteca de documente și calea site-ului; o scurtătură OneDrive poate trimite către un alt site. |
| Secret expirat sau invalid | Rugați administrarea platformei să actualizeze noua Value a secretului în Microsoft Identity Provider corect. |
Pentru OnderwijsSupport pe AI-Corporate, această conectare centrală a fost publicată și testată la 14 octombrie 2026. Disponibilitatea pe AI-School, AI-Public sau pe alt mediu trebuie confirmată de administrarea platformei.
Documentație Microsoft: Selected permissions, adăugare sitegrant și verificare sitegrants.