Ako krok za krokom prepojiť Disk Google s Onyxom

Disk Google sa môže stať jedným z hlavných zdrojov vedomostí spoločnosti Onyx. Prepojením oboch služieb platforma indexuje dokumenty uložené na Disku, aby ich používatelia mohli nájsť prostredníctvom vyhľadávania a použiť ich ako kontext v konverzáciách a pre agentov umelej inteligencie.

Túto integráciu by ste nemali zamieňať s konvenčnou synchronizáciou súborov medzi počítačmi. Onyx nevytvára lokálnu kópiu Disku Google ani ho nemožno použiť na prenos dokumentov medzi zariadeniami.Jeho funkciou je čítať autorizovaný obsah, spracovávať ho a začleňovať ho do svojho indexu znalostí.

Existujú dva spôsoby pripojenia. Organizácie so službou Google Workspace môžu použiť jeden servisný účetčo je odporúčaný systém pre obchodné prostredia. Je možné nakonfigurovať aj aplikáciu OAuth, čo je platná alternatíva pre individuálne účty a organizácie, ktoré uprednostňujú autorizáciu prístupu prostredníctvom používateľa.

Čo dokáže Onyx indexovať z Disku Google?

Konektor služby Disk Google umožňuje importovať dokumenty uložené na autorizovaných osobných diskoch a pracovných priestoroch. Medzi podporované formáty patria:

• Dokumenty, Tabuľky a Prezentácie Google.
• Súbory programov Microsoft Word, Excel a PowerPoint.
• PDF dokumenty.
• Súbory CSV a TXT.
• Iné formáty dokumentov, text a obrázky podporované systémom.

Po indexovaní obsahu ho Onyx môže načítať počas vyhľadávania alebo ho použiť ako kontext na generovanie odpovedí pomocou RAG. Kvalita výsledku bude závisieť od dostupného obsahu, nakonfigurovaných oprávnení a použitého modelu.

Môžete tiež vytvoriť viacero konektorov Disku Google v rámci tej istej inštancieKaždá osoba môže používať vlastné prihlasovacie údaje, čo umožňuje oddelenie rôznych domén, oddelení alebo zdrojov dokumentov v službe Google Workspace.

OAuth alebo servisný účet: ktorú metódu zvoliť

Funkcia	OAuth	Servisný účet
Vyžaduje sa Google Workspace	Nie	Áno
Autorizácia	Robí to používateľ Googlu	Vykonáva sa to pomocou technickej identity
Odporúčané použitie	Individuálny účet alebo malé nasadenie	Obchodné organizácie a nasadenia
Administratívny prístup	Je to potrebné len pre určité obchodné funkcie	Vyžaduje sa nastavenie v službe Google Workspace
Synchronizácia povolení	Vyžaduje sa účet správcu Workspace	Kompatibilné s delegovaním v rámci celej domény
Správa poverení	Autorizácia klienta a používateľa OAuth	Súbor JSON s kľúčom služby

Pre osobný účet je OAuth zvyčajne najjednoduchšou možnosťou. Ak potrebujete indexovať dokumenty pre organizáciu, spravovať viacero pracovných priestorov alebo udržiavať povolenia pre Disk Google v rámci Onyxu, servisný účet ponúka vhodnejšiu kontrolu.

Ako prepojiť Disk Google s Onyxom pomocou OAuth

Metóda OAuth umožňuje používateľovi autorizovať Onyx na prístup k dokumentom uloženým v jeho účte. Nevyžaduje sa predplatné služby Google Workspace Business, hoci budete musieť vytvoriť projekt a prihlasovacie údaje v službe Google Cloud.

Vytvorte projekt a aktivujte API

Otvorte konzolu Google Cloud a vytvorte projekt venovaný integrácii. Potom otvorte knižnicu API a povoľte tieto služby:

• API rozhrania Disku Google.
• Rozhranie API SDK pre administrátorov.
• Rozhranie API pre Dokumenty Google.
• API pre Tabuľky Google.

Použitie samostatného projektu uľahčuje kontrolu povolení a umožňuje vám zrušiť integráciu bez ovplyvnenia iných aplikácií v organizácii.

Konfigurácia obrazovky súhlasu

Otvorte sekciu OAuth v službe Google Cloud a nakonfigurujte obrazovku súhlasu. V závislosti od typu účtu môžete vytvoriť internú aplikáciu pre používateľov vo vašej organizácii alebo externú aplikáciu.

Ak aplikácia zostane v testovacom režime, pridajte účty, ktoré budú používať konektor, ako testovacích používateľov. Neoprávnený účet môže pri pokuse o prihlásenie dostať chybu.

Vytvorte klienta OAuth

Vytvoriť poverenia typu webová aplikáciaAutorizované adresy závisia od toho, kde Onyx beží.

V miestnom zariadení je obvyklým autorizovaným zdrojom:

http://localhost:3000

Zodpovedajúci URI presmerovania je:

http://localhost:3000/admin/connectors/google-drive/auth/callback

Ak Onyx používa vlastnú doménu, nahraďte ju http://localhost:3000 prostredníctvom verejného oslovenia agentúry:

https://onyx.ejemplo.com/admin/connectors/google-drive/auth/callback

Adresa sa musí presne zhodovať s adresou registrovanou v službe Google Cloud. Rozdiel v protokole, doméne, porte alebo ceste môže spôsobiť chybu. redirect_uri_mismatch.

Po dokončení nastavenia si stiahnite súbor JSON s povereniami klienta.

Pridajte poverenia OAuth do Onyxu

1. Otvorte Administračný panel z ónyxu.
2. Prejdite do sekcie a pridajte konektory.
3. Vyberte Disk Google.
4. Kliknite na možnosť vytvorenia nových poverení.
5. Vyberte metódu OAuth.
6. Nahrajte alebo vložte obsah stiahnutého súboru JSON.
7. Kliknite na tlačidlo pre overenie totožnosti pomocou Disku Google.
8. Prihláste sa s účtom, ktorý obsahuje dokumenty.
9. Skontrolujte požadované povolenia a dokončite autorizáciu.

Po vytvorení poverení ho vyberte a pokračujte v konfigurácii konektora. Súbor aplikácie OAuth sa potom priradí k týmto povereniam, takže ho možno znova použiť na vytvorenie ďalších kompatibilných konektorov v rámci inštancie.

Ako pripojiť Disk Google pomocou servisného účtu

Servisný účet je odporúčaná metóda pre organizácie používajúce Google Workspace. Namiesto spoliehania sa na reláciu osoby používa Onyx na prístup k dokumentom autorizovanú technickú identitu.

Vytvorenie projektu a servisného účtu

V konzole Google Cloud vytvorte projekt a povoľte nasledujúce rozhrania API:

• API rozhrania Disku Google.
• Rozhranie API SDK pre administrátorov.
• Rozhranie API pre Dokumenty Google.
• API pre Tabuľky Google.

Ďalej otvorte sekciu servisných účtov, vytvorte novú identitu a vygenerujte kľúč vo formáte JSON. Súbor uložte na bezpečné miesto, pretože obsahuje poverenia, ktoré by nemali byť publikované ani zahrnuté do úložiska.

Povoliť delegovanie v rámci celej domény

Skopírujte jedinečný identifikátor servisného účtu a prihláste sa do konzoly správcu služby Google Workspace. V sekcii delegovania v rámci domény pridajte nového klienta pomocou tohto identifikátora.

Onyx vyžaduje nasledujúce rozsahy iba na čítanie:

https://www.googleapis.com/auth/drive.readonly,
https://www.googleapis.com/auth/drive.metadata.readonly,
https://www.googleapis.com/auth/admin.directory.group.readonly,
https://www.googleapis.com/auth/admin.directory.user.readonly

Udeľte iba potrebné rozsahy. Neodporúča sa ich nahrádzať všeobecnými oprávneniami na čítanie a zápis, ak konektor potrebuje iba indexovať dokumenty.

Pripravte si hlavný administrátorský účet

Pri vytváraní poverení v Onyxe budete musieť zadať hlavný e-mail správcuTáto e-mailová adresa nie je e-mailová adresa servisného účtu, ale e-mailová adresa skutočného používateľa služby Google Workspace, ktorú možno použiť na delegovanie.

Účet musí mať prístup k Disku a Dokumentom, ako aj oprávnenia správcu na čítanie:

• Používatelia.
• Skupiny.
• Organizačné jednotky.
• Nastavenia Disku a Dokumentov.

Môžete použiť existujúci administrátorský účet alebo si vytvoriť samostatný účet pre Onyx s minimálnymi potrebnými oprávneniami.

Vytvorte si poverenia v Onyxe

1. Prihláste sa do administračného panela Onyx.
2. Vyberte konektor Disku Google.
3. Vytvorte si nové poverenie.
4. Vyberte možnosť servisného účtu.
5. Nahrajte vygenerovaný súbor JSON do služby Google Cloud.
6. Zadajte e-mailovú adresu hlavného správcu.
7. Uschovajte si poverenie.
8. Vyberte ho a pokračujte vo vytváraní konektora.

Aktuálne verzie Onyxu vám umožňujú ukladať viacero prihlasovacích údajov pre Disk Google nezávisle. Ak spravujete viac ako jednu doménu Workspace, vytvorte pre každú z nich samostatné prihlasovacie údaje a konektor.

Ako nakonfigurovať prístup k indexovaným dokumentom

Autentifikácia určuje, aký obsah môže konektor čítať, ale nastavenia prístupu určujú, kto k nemu má prístup z Onyxu. Pred začatím indexovania si toto nastavenie pozorne skontrolujte.

• Súkromné: Obsah je dostupný iba osobe, ktorá konektor vytvorila, a používateľom alebo skupinám, ktoré boli výslovne pridané.
• Verejné: Všetci používatelia inštancie Onyx si môžu zobraziť indexovaný obsah.
• Automatická synchronizácia povolení: Onyx udržiava zoznam prístupových práv na základe existujúcich povolení na Disku Google.

Neoznačujte ako verejný konektor, ktorý má prístup k dôverným dokumentom. Táto možnosť môže používateľom Onyxu umožniť zobraziť informácie, ktoré boli pôvodne v službe Disk Google obmedzené.

Automatická synchronizácia povolení je k dispozícii v Onyx Cloud a edícii Enterprise. Pre Disk Google vyžaduje servisný účet alebo autorizáciu OAuth vykonanú správcom Google Workspace s príslušnými oprávneniami.

Ako spustiť a monitorovať indexovanie

Po vytvorení konektora začne Onyx načítavať a spracovávať dokumenty. Ich stav si môžete skontrolovať v sekcii Existujúce konektory z administračného panela.

Najbežnejšie štáty sú:

• Naplánované: Konektor čaká na začatie ďalšieho vykonávania.
• Počiatočné indexovanie: Vykonáva sa prvá indexácia.
• Indexovanie: Obnovujú sa nové zmeny.
• Indexované: Posledná synchronizácia bola úspešne dokončená.
• Pozastavené: Indexovanie je zastavené.
• Chyba: Počas načítania alebo spracovania sa vyskytol problém.

Dokumenty indexované pred chybou zostávajú k dispozícii. Onyx sa operácie pokúsi zopakovať, hoci konektor môže byť pozastavený, ak sa v ňom nahromadí príliš veľa po sebe idúcich chýb.

Ako upraviť frekvenciu aktualizácií

Rozšírené možnosti konektora vám umožňujú ovládať, kedy sa zmeny načítajú a kedy sa z indexu odstránia dokumenty, ktoré už neexistujú v službe Disk Google.

• Frekvencia obnovovania: Určuje, ako často sa kontrolujú nové alebo upravené dokumenty. Predvolená hodnota je 30 minút.
• Frekvencia prerezávania: Toto nastavenie určuje, ako často sa odstránené alebo nedostupné dokumenty odstraňujú z indexu. Predvolená hodnota je 30 dní.
• Dátum začiatku indexovania: Umožňuje vám ignorovať obsah starší ako určitý dátum.

Prílišné skrátenie intervalu aktualizácie môže zvýšiť počet volaní do rozhraní Google API a zvýšiť pravdepodobnosť dosiahnutia časových limitov. Vyberte frekvenciu zodpovedajúcu rýchlosti zmien vašich dokumentov.

Bežné chyby pri prepojení Disku Google s Onyxom

Google zobrazuje chybu redirect_uri_mismatch

URI registrované v službe Google Cloud sa nezhoduje presne s URI používaným službou Onyx. Skontrolujte protokol, doménu, port, cestu a prítomnosť koncových lomítok.

Účet nemôže dokončiť autorizáciu OAuth

Ak je aplikácia v skúšobnom režime, overte, či sa účet zobrazuje medzi autorizovanými používateľmi. V organizácii si tiež prečítajte pravidlá, ktoré obmedzujú aplikácie OAuth tretích strán.

Servisný účet nemôže zobraziť dokumenty

Overte, či je delegovanie v rámci celej domény aktívne, či je identifikátor klienta správny a či boli udelené všetky požadované rozsahy iba na čítanie.

E-mail hlavného administrátora bol odmietnutý

Nepoužívajte e-mailovú adresu spojenú s vaším servisným účtom. Musíte použiť e-mailovú adresu používateľa služby Google Workspace s prístupom k Disku a potrebnými oprávneniami správcu na čítanie.

Niektoré dokumenty sa nezobrazujú vo vyhľadávaniach

Overte, či je súbor v kompatibilnom formáte, či k nemu majú prístup použité prihlasovacie údaje a či nie je starší ako dátum pôvodného indexovania. Skontrolujte tiež stav konektora a počkajte na dokončenie počiatočného indexovania.

Používateľ si môže pozrieť dokumenty, ktoré by nemal.

Okamžite skontrolujte typ prístupu konektora. Ak je nastavený na verejný, všetok jeho obsah bude viditeľný pre používateľov Onyxu. Ak zdroj obsahuje obmedzené informácie, použite súkromný prístup alebo automatickú synchronizáciu povolení.

Konektor opakovane prechádza do chybového stavu

Skontrolujte stav konektorov a servisných protokolov Onyx. V samostatne spravovaných inštaláciách môžete dočasne zvýšiť úroveň protokolovania na debug získať viac informácií a vyhnúť sa zbytočnému udržiavaniu tejto úrovne vo výrobe.

Prepojenie Disku Google s Onyxom transformuje roztrúsené dokumenty na prehľadávateľnú znalostnú základňu prístupnú prostredníctvom vyhľadávania, chatu a agentov umelej inteligencie. Pre individuálne účty zvyčajne postačuje OAuth. V organizáciách používajúcich Google Workspace poskytuje servisný účet stabilnejšiu správu a umožňuje funkcie synchronizácie povolení na podnikovej úrovni.

Najdôležitejšou časťou nie je len autorizácia prístupu, ale aj správna konfigurácia toho, kto si môže dokumenty zobraziť po ich indexovaní. Pred aktiváciou konektora v produkčnom prostredí otestujte integráciu s malou sadou súborov, skontrolujte povolenia z viacerých účtov a overte, či Onyx nezobrazuje informácie mimo zamýšľaného rozsahu.