Přeskočit na hlavní obsah

Připojení

Integration control plane

Propojte nástroje, nastavte přístup a dejte agentům bezpečné akce.

Připojení propojují Siesta AI se SaaS aplikacemi, API, modely, interními systémy a znalostními zdroji. V katalogu autorizujete službu, nastavíte přístup, přiřadíte ji agentům nebo workflows a určíte, které funkce běží automaticky nebo vyžadují potvrzení.

01Vyberte připojeníZvolte OAuth, API klíč, REST API, model provider nebo interní službu.
02Autorizujte přístupPřipojte účet, token, tenant, base URL, scopes nebo endpoint funkce.
03Nastavte governanceRozhodněte o private/shared přístupu a funkcích, které vyžadují potvrzení.

Připojení představuje centrální místo, kde se spravují veškerá napojení platformy Siesta AI na externí služby, ať už jde o akční nástroje, knihovny znalostí nebo samotné AI modely. Díky této sekci mají administrátoři okamžitý přehled, jaké zdroje jsou k dispozici, a mohou je během pár kliknutí přidávat, upravovat i odstraňovat. Napojením nové služby se ta ihned objeví v celém systému a lze ji rovnou přiřadit při tvorbě či úpravě agenta.

Sekce Připojení slouží k práci s externími systémy. Připojení umožňuje propojit Siesta AI s nástroji třetích stran (API, SaaS platformy, interní systémy), aby agenti a workflows mohli číst data, zapisovat změny nebo spouštět akce.

Jak to funguje

  • Správa: v sekci Připojení aktivujete konkrétní připojení, nastavíte přístup (OAuth, API klíč, connection string nebo jiný typ přihlašovacích údajů) a přiřadíte ho agentům nebo workflows.
  • Použití: akce připojení se volají z promptů, nástrojů nebo automatizací (např. odeslat e-mail, načíst data z CRM, založit objednávku nebo zkontrolovat náklady v Azure).
  • Kontext účtu: u OAuth připojení agent obvykle pracuje v kontextu připojeného uživatele. Vidí a může měnit jen to, co povolují udělená oprávnění daného účtu.
  • Zabezpečení: přístupové tokeny a citlivé hodnoty se ukládají zabezpečeně. Operace provedené přes připojení je vhodné sledovat v auditních logách a v logách cílové služby.

Připojení samo o sobě neurčuje, co má agent dělat. Určuje, ke kterému externímu systému má Siesta AI bezpečný přístup a jaké operace jsou k dispozici. Agent nebo workflow potom vybere konkrétní akci připojení a předá jí potřebné vstupy.

Typy přístupu

  • OAuth přihlášení: uživatel je přesměrován na poskytovatele služby, přihlásí se a potvrdí požadovaná oprávnění. Tento model používají například Google, Microsoft nebo Slack konektory.
  • API klíč nebo token: uživatel vloží hodnotu vygenerovanou v cílové službě. Tento model je častý u technických API, e-shopů nebo interních systémů.
  • Connection string / systémové údaje: některé služby vyžadují technický řetězec nebo kombinaci údajů, například endpoint, tenant, client ID a secret.

U každého připojení zkontrolujte, jestli přidělený účet nebo token má jen taková oprávnění, která agent skutečně potřebuje.

Přehled sekce Připojení

  • Vyhledávací pole nahoře pro rychlé filtrování připojení.
  • Tabulka se sloupci: Název, Typ, Vytvořeno, Přístup + akce vpravo (menu ...).
  • Tlačítko Přidat integraci pro vytvoření nového připojení.
  • Příklady dostupných připojení: Jira, Google Search, HubSpot, OpenAI.

Přehled připojení

Detail připojení

V detailu jednotlivých připojení lze nastavit rozsah oprávnění (scopes) a povolené funkce. Správci zde určují, které akce jsou dostupné, zda vyžadují potvrzení a jaký přístup má připojení (sdílené nebo soukromé).

Přidání nového připojení

Po kliknutí na Add Connection se otevře dialog s vyhledávacím polem a seznamem dostupných připojení (např. Gmail, Google Calendar, Google Drive, Slack App, OpenAI).

Podle vybraného typu připojení je uživatel přesměrován na stránku poskytovatele, kde musí povolit Siesta AI přístup k dané službě.

Po úspěšném potvrzení je v okně uživatel vyzván aby pojmenoval své nové připojení. Po zadání jména a potvrzení je nové připojení přidáno.

Kdy připojení znovu autorizovat

Připojení může přestat fungovat, pokud vyprší token, změní se heslo nebo bezpečnostní politika v cílové službě, uživatel odebere souhlas, administrátor změní scopes, nebo je účet v cílové službě deaktivovaný. V takovém případě otevřete detail připojení a proveďte znovu autorizaci nebo aktualizujte uložené přihlašovací údaje.

Doporučení pro bezpečné používání

  • Pro produkční připojení používejte samostatné účty nebo tokeny s jasným účelem.
  • Nepřidělujte širší oprávnění, než agent nebo workflow potřebuje.
  • U připojení, která zapisují data nebo odesílají zprávy, zvažte potvrzovací krok v agentovi nebo workflow.
  • Pokud služba podporuje vlastní auditní logy, kontrolujte je společně s auditním logem v Siesta AI.
  • Při změně vlastníka účtu, odchodu uživatele nebo změně zákaznického prostředí připojení ověřte a případně znovu vytvořte.