Nástroje

Nástroje jsou akce, které může agent nebo workflow provést přes připojenou externí službu. Typicky jde o načtení dat, vyhledání informací, vytvoření záznamu nebo odeslání zprávy. Uživatel je nenastavuje přímo v katalogu nástrojů. Nejdřív vytvoří Připojení, potom nástroj povolí agentovi, skillu nebo workflow.

Kdy nástroj použít

Nástroj použijte ve chvíli, kdy má agent pracovat s reálnými daty mimo Siesta AI:

• načíst e-maily, kalendář, soubory nebo CRM záznamy,
• vytvořit tiket, událost, dokument, zprávu nebo obchodní záznam,
• vyhledat informace přes Google Search, Firecrawl nebo interní API,
• aktualizovat položky v reklamních, analytických nebo projektových systémech.

Pokud má agent odpovídat jen z nahraných znalostí, použijte spíš Data nebo Memory. Pokud má něco provést v jiné aplikaci, použijte nástroj.

Jak s nástroji pracovat

1. Otevřete Připojení a přidejte integraci, kterou nástroj potřebuje.
2. V detailu připojení zkontrolujte oprávnění, dostupné funkce a jestli změnové akce vyžadují potvrzení.
3. Přidejte připojení do agenta, skillu nebo workflow, kde má být dostupné.
4. V promptu popište, co má agent s daným nástrojem udělat a kdy má požádat o potvrzení.
5. Výsledek ověřte v cílové aplikaci nebo v sekci Spuštění nástrojů.

Čtení vs. změny

Některé funkce jen čtou data, například vyhledají soubory, vypíšou kalendář nebo načtou detail tiketu. Jiné funkce mění externí systém: vytvoří událost, pošlou Slack zprávu, upraví kampaň nebo vytvoří Jira issue.

U změnových akcí nastavte potvrzení všude, kde by nechtěné spuštění mohlo poslat zprávu, změnit data, publikovat obsah nebo spustit proces mimo Siesta AI.

Co má obsahovat dokumentace konkrétního nástroje

Každý nástroj by měl být popsaný tak, aby podle stránky mohl pracovat běžný uživatel:

• k čemu nástroj slouží a kdy ho nepoužívat,
• jaké připojení je potřeba vytvořit,
• jaká oprávnění nebo API klíče jsou potřeba,
• co nástroj umí číst a co umí změnit,
• které akce mají být chráněné potvrzením,
• jednoduchý příklad promptu nebo workflow kroku,
• jak ověřit výsledek a kde hledat chyby.

Aktuální audit pokrytí

Automatický audit porovnává aktuální Siesta.AI.Tools s dokumentací v docs/connections. Výstup ukáže, které nástroje už mají uživatelskou stránku a které ještě chybí.

npm run tools:map
npm run connections:compare

Výsledky se ukládají do artifacts/tools-inventory/dev.md a artifacts/connections-coverage/dev.md.