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 Podpora Drive 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 vraťte stručné shrnutí, rizika, vlastníky nebo další kroky.
- Připravit opakovatelný výzkum. Použijte složky na Drive jako stabilní zdrojový materiál pro opakující se zprávy, balíčky zákaznických recenzí nebo provozní pracovní postupy.
- Udržovat omezený přístup. Přístup je omezen na to, co již může vidět Google účet, takže před připojením určete rozsah účtu.
Bezpečnost 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 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 opakovatelný znalostní povrch a usnadňuje kontrolu stavu zpracování, neúspěšných souborů a vlastnictví zdroje.
Použijte pouze sbírku dat Podpora Drive. 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.
Použití výsledků souborů v pracovních postupech
Použijte strukturované výstupy ListFilesAsync a ReadFileAsync k předání výsledků souborů do pozdějších kroků pracovního postupu.
| Výstupní pole | Význam |
|---|---|
Files | Pole odpovídajících souborů; prázdné pole znamená žádné shody. |
Files[].Id, Files[].Name, Files[].MimeType | Identita souboru, název a typ média. Tyto hodnoty mohou být null. |
NextPageToken | Nullable token pokračování vrácený Drive. Funkce nemá vstupní token stránky, takže to neposkytuje automatickou stránkování ani nezaručuje úplný seznam souborů. |
Content | Text CSV exportu z ReadFileAsync. Pole výše patří k ListFilesAsync. |
Čtenář vybere soubor podle názvu, ne podle ID, a exportuje ho jako CSV (první list pro tabulku). Tato výstupní schéma nepřidává obecné čtení PDF nebo binárních souborů. Ingestace sbírky dat je samostatná cesta s vlastní podporou formátu.
Strukturované výstupy jsou aditivní: existující LlmText a UserText zůstávají dostupné, takže není vyžadována povinná migrace. Viz Mapování výstupů Drive do dalšího kroku.
Stahování souborů pro práci agenta
Použijte ListFilesAsync k nalezení ID souboru, poté použijte DownloadFileAsync, když agent potřebuje samotný soubor místo extrahovaného textu. Výsledek je stahovatelný artefakt konverzace, takže ho můžete otevřít nebo stáhnout pomocí stejných ovládacích prvků jako jiné publikované soubory.
- Zkratky Drive se před stažením vyřeší na cílový soubor.
- Google Docs, Sheets, Slides a Drawings jsou exportovány jako DOCX, XLSX, PPTX a PNG.
- Běžné soubory Drive si zachovávají svůj původní formát.
- Složky a nepodporované typy Google Workspace, jako jsou Forms, Sites a nepodporované nativní typy souborů, nelze stáhnout touto akcí.
Každé vyvolání nástroje může vrátit soubory o celkové velikosti až 50 MiB. Pokud soubor překročí tento limit, zúžte požadavek nebo použijte schválenou alternativu pro přenos originálu. Stažení souboru nezpřístupňuje jeho binární obsah jako hodnotu pracovního postupu; použijte strukturované seznamy a textové výstupy při mapování hodnot do pozdějších kroků pracovního postupu.
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 rozsah připojeného účtu omezte 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ý | Explicitně pojmenujte sbírku dat 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 o sdílení připojení nebo použijte osobní připojení. |
Znovu připojení dokazuje, že Google přijal OAuth grant; nedokazuje, že účet může číst každý zamýšlený soubor nebo sdílený disk. Postupujte podle běžného kontrolního seznamu zdraví připojení a znovu autorizace, poté otestujte jeden očekávaný soubor s připojeným účtem.
Související průvodci
Kontrola OAuth připojení
Reconnect potvrzuje přijetí OAuth grantu, nikoli přístup ke každému souboru nebo shared drive. Použijte kontrolu health a reautorizace a potom ověřte jeden očekávaný soubor účtem connection.