Nástroje
Nástroj umožňuje agentovi udělat víc než jen napsat odpověď. Může načíst aktuální informace, pracovat s jinou aplikací, spustit kód, vytvořit soubor nebo spravovat Siesta AI.
Pro uživatele existují pouze dvě skupiny:
Tools
├── Connection Tools
│ ├── Shared Tools
│ └── Private Tools
└── Platform Tools
├── Vyhledávání, scraping, kód, úkoly a orchestrace
└── Platform Management pro správu Siesta AI
Tato stránka pomáhá vybrat správnou skupinu. Úplný seznam vestavěných funkcí najdete v referenci Platform Tools.
Jaký nástroj vybrat
| Agent potřebuje | Použijte | Příklad |
|---|---|---|
| Číst nebo měnit externí aplikaci | Connection Tool | Gmail, Slack, Jira, HubSpot, Google Drive |
| Použít týmový nebo organizační účet | Shared Tool | Sdílený support mailbox nebo servisní Jira účet |
| Jednat jménem aktuálního uživatele | Private Tool | Osobní Gmail, kalendář nebo OneDrive |
| Použít schopnost poskytovanou Siesta AI | Platform Tool | Code Interpreter, Task Management, Web Scraper |
| Vytvářet nebo měnit konfiguraci Siesta AI | Platform Management | Vytvoření agenta, změna Skill, zápis Memory page |
| Odpovídat z udržovaných znalostí | Data nebo Memory | Směrnice, manuály, schválené kolekce |
| Volat vlastní rozhraní | REST nebo MCP Connection Tool | Interní CRM API nebo MCP server |
Connection Tools
Connection Tools pracují s externími systémy. Funkce získávají z nakonfigurovaných Connections, REST API nebo MCP serverů. Mohou například číst soubor z Google Drive, poslat zprávu do Slacku, vytvořit Jira issue nebo načíst analytická data.
Stejný provider může být dostupný dvěma způsoby:
- Shared Tool používá Connection sdílené s uživateli agenta. Hodí se pro týmové a organizační účty.
- Private Tool používá vlastní Connection aktuálního uživatele konverzace. Hodí se, pokud musí akce proběhnout pod identitou uživatele.
Rozdíl je ve vlastnictví credentialu a runtime identitě, nikoli v samotné funkci.
Funkce lze zakázat, povolit nebo povolit s potvrzením. Potvrzení vyžadujte pro odesílání, publikování, vytváření, změny, mazání, oprávnění, finance a zásahy do produkce.
Platform Tools
Platform Tools jsou vestavěné schopnosti poskytované a provozované Siesta AI. Uživatel kvůli nim nemusí vytvářet běžné firemní Connection.
Aktuálně sem patří:
- Task Management,
- Grounding with Google Search,
- Web Scraper,
- Code Interpreter,
- SiestaAI Help,
- Orchestration,
- JavaScript Executor,
- Platform Management.
Část nástrojů sestavuje přímo backend. Google Search a Web Scraper používají systémová provider Connections, ale pro uživatele stále patří mezi Platform Tools.
Podmínky, funkce, limity a doporučení najdete v referenci Platform Tools.
Platform Management
Platform Management je privilegovaný Platform Tool pro správu Siesta AI. Zpřístupňuje funkce Platform_* pro:
- agenty a jejich konfiguraci,
- Skills,
- Templates,
- Memory collections a pages,
- administrativní čtení soukromých konverzací a zpráv agenta.
Při spuštění musí být splněny obě podmínky:
- agent má Platform Management zapnutý,
- aktuální uživatel má roli Owner nebo Admin.
Běžný User tyto administrativní funkce nedostane. Backend kontrolu role opakuje při sestavování runtime katalogu.
Jak vzniká runtime katalog
Siesta.AI.Backend sestaví pro každé spuštění agenta jeden katalog funkcí. Podle přiřazení a oprávnění může obsahovat:
- Shared a Private Connection funkce,
- přiřazené Platform Tools,
- vyhledávání v přiřazených Data collections,
- Skills a sub-agenty,
- Memory pages,
- funkce pro aktuální přílohy.
Model vidí jeden katalog. Aplikace konfiguraci rozděluje podle vlastnictví a rizika, aby administrátor rozuměl oprávněním agenta.
Role jednotlivých repozitářů
| Repozitář | Odpovědnost |
|---|---|
| Siesta.AI.App | Zobrazuje Connection Tools a výběr vestavěných Platform Tools; ukládá vybrané funkce a ID k agentovi |
| Siesta.AI.Backend | Vyhodnocuje přístup, Connections, přiřazení a potvrzení a sestavuje výsledný runtime katalog |
| Siesta.AI.Tools | Implementuje provider funkce jako Google Search, Firecrawl, Jira nebo Google Drive |
Technická poznámka
Zdrojový kód a API pro vestavěné Platform Tools stále používají interní názvy SystemTool, systemTools a systemToolIds. Jde o implementační detail, nikoli další skupinu, kterou se musí uživatel učit.
Privilegovaná schopnost označená v některých částech zdrojového kódu jako Platform Tools se v dokumentaci jmenuje Platform Management, aby se nepletla s celou skupinou Platform Tools.
Postup přiřazení
- Rozhodněte, zda agent potřebuje externí systém, nebo vestavěnou schopnost Siesta AI.
- Pro externí systém nejprve vytvořte a nastavte Connection.
- Otevřete Configuration agenta.
- Zapněte potřebné Platform Tools a vyberte Shared nebo Private Tools.
- Zkontrolujte Templates, aby nečekaně nekopírovaly privilegovaná přiřazení.
- Otestujte bezpečné čtení i důležité zápisy a chybové stavy.
- Spuštění ověřte v Tool Executions a případně také v cílovém systému.
Governance checklist
- Agentovi dejte pouze schopnosti potřebné pro jeho účel.
- Shared Tools používejte pro týmové identity, Private Tools pro identity uživatelů.
- Změny v externích systémech a platformě nechte potvrzovat, dokud workflow neprojde kontrolou.
- Platform Management, Orchestration a JavaScript Executor povolujte jen kontrolovaným agentům.
- Oprávnění providera a oprávnění v Siesta AI kontrolujte odděleně.
- Po testech a změnách oprávnění zkontrolujte Tool Executions.
- Před publikováním nebo změnou Template znovu ověřte Platform Tools.