Google Docs
Prepojenie prebieha rovnako ako pri ostatných Google účtoch v Siesta AI (OAuth 2.0). OAuth prihlásenie a consent obrazovka v Google účte sa môže líšiť podľa typu účtu, doménovej politiky a dostupných oprávnení.
Prehľad
Tento dokument popisuje integráciu GoogleDocs pre prácu s dokumentmi v Google Workspace.
Integrácia je vhodná pre:
- čítanie obsahu dokumentov pre agentov a workflows,
- automatizované vytváranie dokumentov,
- aktualizáciu obsahu dokumentov v rámci interných procesov.
1. Pripojenie Google Docs v Siesta AI
- V sekcii Pripojenia klikni na Add Connection.
- Vo výbere konektorov vyber Google pripojenie.
- Prihlás sa svojím Google účtom.
- Potvrď požadované oprávnenia (scopes) pre Google Docs.
- V detaile pripojenia môžeš upraviť prístup a rozsah povolených funkcií (scopes/policies).
2. Google Docs Integration
Názov služby
GoogleDocs
Popis
Integrácia umožňuje vytvárať, načítať a aktualizovať Google dokumenty cez autorizovaný Google účet.
2.1 CreateDocumentAsync
Popis
Vytvorí nový Google dokument.
Vstupné parametre
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| title | String | Áno | Názov dokumentu. |
| content | String | Nie | Počiatočný textový obsah dokumentu. |
Správanie
- Ak je predaný
content, zapíše sa do novo vytvoreného dokumentu. - Výstupom je identifikátor a metadata nového dokumentu.
Typické použitie
- Generovanie reportov
- Zakladanie dokumentov zo šablón
2.2 GetDocumentAsync
Popis
Načíta existujúci Google dokument podľa ID.
Vstupné parametre
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| documentId | String | Áno | ID cieľového dokumentu. |
Správanie
- Vracia metadata a obsah dokumentu podľa oprávnení účtu.
- Ak dokument neexistuje alebo nie je dostupný, operácia zlyhá.
2.3 UpdateDocumentAsync
Popis
Aktualizuje obsah existujúceho dokumentu.
Vstupné parametre
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| documentId | String | Áno | ID dokumentu, ktorý sa má upraviť. |
| content | String | Áno | Nový obsah určený na zápis. |
Správanie
- Aktualizácia prebieha nad existujúcim dokumentom.
- Rozsah a spôsob zmien sa riadi oprávneniami pripojeného Google účtu.
Typické použitie
- Aktualizácia prevádzkových dokumentov
- Dopisovanie výstupov z workflow
- Synchronizácia obsahu medzi systémami
Bezpečnostné poznámky
- Integrácia beží cez oficiálne Google API.
- Prístup je riadený cez OAuth 2.0 a scopes udelené používateľom.
- Odporúča sa používať princíp minimálnych oprávnení a pravidelne revidovať scopes.
Dizajnové rozhodnutia
- Všetky operácie prebiehajú nad konkrétnym autorizovaným Google účtom.
- Oprávnenia k dokumentom sa dedí z Google Workspace zdieľania.
- Chýbajúce oprávnenia alebo neexistujúci dokument vracia chybu okamžite (fail-fast).
Zhrnutie
- GoogleDocs konektor umožňuje vytvárať, čítať a upravovať dokumenty v Google Docs.
- Pripojenie je založené na OAuth a správe scopes.
- Integrácia je vhodná pre automatizované dokumentačné a reportingové scenáre v agentoch a workflows.