Google Drive
Připojení Google Drive umožňuje agentům číst schválené soubory na Google Drive bez širokého přístupu k pracovnímu prostoru. Použijte ho, když agent potřebuje zdrojové dokumenty, složky, exporty, tabulky, PDF nebo soubory sdíleného týmu jako kontext. Je založeno na OAuth a řídí se oprávněními Drive připojeného Google účtu.
Kdy ho použít
Použijte ho, když agent potřebuje trvalý zdrojový materiál z Drive, jako jsou produktové dokumenty, podpůrné politiky, smlouvy, návrhy nebo materiály pro zaškolení, spíše než jednorázovou přílohu chatu. Je to znalostní zdroj orientovaný na čtení, nejlepší pro vyhledávání dokumentů, získávání souborů a sbírky dat.
Nastavení
- V Připojeních klikněte na Přidat integraci a vyberte Google Drive ze skupiny poskytovatelů Google.
- Přihlaste se účtem, který již má přístup ke složkám nebo sdíleným diskům, které by měl agent číst.
- Pojmenujte připojení tak, aby vysvětlovalo zdroj, například Podpůrný disk nebo Dokumenty pro podporu prodeje, a poté vyberte soukromý nebo sdílený přístup.
- Připojte připojení ke sbírce dat, konfiguraci agenta nebo kroku pracovního postupu, který potřebuje kontext souboru.
Co nástroj umí
- Odpovídat z firemních dokumentů. Připojte produktové dokumenty, podpůrné politiky, smlouvy, návrhy nebo materiály pro zaškolení prostřednictvím sbírky dat.
- Shrnout sdílené soubory. Čtěte soubory, ke kterým má připojený účet přístup, a vracejte stručné shrnutí, rizika, vlastníky nebo další kroky.
- Připravit opakovatelný výzkum. Použijte složky Drive jako stabilní zdrojový materiál pro opakující se zprávy, balíčky zákaznických recenzí nebo provozní pracovní postupy.
- Udržet přístup omezený. Přístup je omezen na to, co již může vidět Google účet, takže před připojením vymezte účet.
Zabezpečení a potvrzení
Google Drive je připojení orientované na čtení, ale je stále citlivé, protože získaný obsah souboru se stává kontextem agenta. Použijte co nejmenší praktický rozsah Google účtu nebo sdíleného disku, zkontrolujte, kteří agenti mohou připojení používat, a zkontrolujte běhy nástroje nebo stav zdroje dat, když přístup selže.
Před připojením potvrďte, že:
- Google účet má přístup k přesným souborům nebo složkám, které by měl agent číst.
- Zdroj není lépe řešen jako jednorázová příloha chatu.
- Název připojení říká uživatelům, kterou oblast Drive představuje.
- Sdílený přístup je záměrný a schválený pro tým, který ho používá.
- Citlivé složky jsou vyloučeny nebo nejsou sdíleny s připojeným účtem.
- Agent nebo sbírka dat používající tento zdroj má jasný účel.
| Oblast | Jak o tom přemýšlet |
|---|---|
| Autentizace | OAuth s Google. Znovu autorizujte, pokud token vyprší nebo se změní rozsahy. |
| Hranice oprávnění | Připojený Google účet a pravidla sdílení Drive rozhodují, co lze číst. |
| Doporučený přístup | Soukromý pro osobní práci; sdílený pouze pro složky vlastněné týmem nebo sdílené disky. |
| Chování zápisu | Považujte to za pouze pro čtení, pokud vaše uvolněná plocha nástroje výslovně nepřidává funkce zápisu. |
| Audit | Zkontrolujte běhy nástroje, stav synchronizace zdroje dat a administrativní auditní logy, když výsledky vypadají špatně. |
Příklad použití
Pro trvalý zdrojový materiál vytvořte sbírku dat z připojení Drive místo toho, abyste uživatele žádali o opakované nahrávání stejného souboru. To poskytuje agentům opakovaně použitelný znalostní povrch a usnadňuje kontrolu stavu zpracování, neúspěšných souborů a vlastnictví zdroje.
Použijte pouze sbírku dat Podpůrný disk. Odpovězte na otázku zákazníka,
uveďte název zdrojového dokumentu a řekněte "nenalezeno", pokud odpověď
není v připojených souborech Drive.
Technické poznámky
- Implementace: Připojení zdroje OAuth 2.0 k Google Drive, vystavené jako znalostní zdroj orientovaný na čtení pro sbírky dat.
- Autentizace/rozsahy: OAuth s Google. Pravidla sdílení Drive připojeného účtu určují, které soubory jsou viditelné; znovu autorizujte, když token vyprší nebo se změní rozsahy.
- Chování zápisu: pouze pro čtení v této dokumentační ploše. Získaný obsah souboru se může stát kontextem agenta, takže vymezte připojený účet na minimum potřebné.
Běžné problémy
| Příznak | Pravděpodobná příčina | Oprava |
|---|---|---|
| Agent nemůže najít soubor | Připojený účet k němu nemá přístup, nebo soubor není zahrnut ve sbírce dat | Sdílejte složku/soubor s připojeným účtem a obnovte zdroj. |
| Autorizace selhala | OAuth token vypršel nebo Google účet změnil bezpečnostní nastavení | Znovu připojte Google Drive z detailu připojení. |
| Používají se špatné dokumenty | Agent má více zdrojů a vybral špatný | Pojmenujte sbírku dat explicitně v promptu nebo připojte pouze zamýšlený zdroj. |
| Sdílené připojení chybí | Přístupová politika nezahrnuje váš tým nebo agenta | Požádejte administrátora, aby sdílel připojení, nebo použijte osobní připojení. |