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.

System Tools je celá sekce vestavěných nástrojů v konfiguraci agenta. Platform Tools je jeden přepínač uvnitř této sekce: umožňuje agentovi pracovat s objekty Siesta AI, například s agenty a skilly. Ostatní System Tools, například Sandbox a Image generation, mají vlastní přepínače; zapnutí Platform Tools je nezapne.

Pro uživatele existují pouze dvě skupiny:

Tools
├── Connection Tools
│   ├── Shared Tools
│   └── Private Tools
└── System Tools
    ├── Vyhledávání, scraping, kód, úkoly a orchestrace
    └── Platform Tools pro správu Siesta AI

Nástroje nastavíte v konfiguraci agenta.

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	System Tool	Generování obrázků, Task Management, Web Scraper
Vytvářet nebo měnit konfiguraci Siesta AI	Platform Tools	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.

System Tools

System Tools je název sekce v konfiguraci agenta. Obsahuje vestavěné schopnosti poskytované a provozované Siesta AI, včetně položky Platform Tools pro správu platformy. Uživatel kvůli nim nemusí vytvářet běžné firemní Connection.

Aktuálně sem patří:

• Task Management,
• Workflows,
• Grounding with Google Search,
• Web Scraper,
• Image generation,
• Sandbox,
• SiestaAI Help,
• Orchestration,
• JavaScript Executor,
• Platform Tools.

Čá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 System Tools.

Průběh a výsledky jednotlivých spuštění najdete v Tool Executions.

Platform Tools

Platform Tools je jeden z přepínačů v sekci System Tools pro správu Siesta AI. Zpřístupňuje například Platform_CreateAgent a Platform_UpdateSkill pro práci s:

• agenty a jejich konfiguraci,
• Skills,
• Templates,
• Memory collections a pages,
• soukromými konverzacemi a zprávami agenta, které umožňuje administrativně číst.

Zapnutím Platform Tools se nezapne Sandbox, Image generation ani Workflows. Pokud je agent potřebuje, zapněte každý z těchto nástrojů zvlášť.

Při spuštění musí být splněny obě podmínky:

1. agent má Platform Tools zapnutý,
2. aktuální uživatel má oprávnění Use platform tools in chat (Agents.UsePlatformTools), které mají ve výchozím nastavení Owner a Admin. Každá akce navíc ověřuje přístup k cílovému objektu.

Ovládání Platform Tools se zobrazuje podle oprávnění aktuálního uživatele. Backend oprávnění znovu ověřuje 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é System 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.

Rozlišení názvů

V konfiguraci agenta je System Tools název celé sekce. Položka Platform Tools v této sekci zpřístupňuje správu Siesta AI. Ostatní nástroje mají vlastní přepínače.

Postup přiřazení

1. Rozhodněte, zda agent potřebuje externí systém, nebo vestavěnou schopnost Siesta AI.
2. Pro externí systém nejprve vytvořte a nastavte Connection.
3. Otevřete Configuration agenta.
4. V sekci System Tools zapněte potřebné vestavěné nástroje. Connection Tools vyberte v sekcích Shared Tools nebo Private Tools.
5. Zkontrolujte Templates, aby nečekaně nekopírovaly privilegovaná přiřazení.
6. Otestujte bezpečné čtení i důležité zápisy a chybové stavy.
7. 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 Tools, 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 System Tools.

Spouštění workflow

System Tool Workflows umožňuje agentovi spustit vybraná workflow na výslovný požadavek uživatele. Zapněte jej a vyberte povolené položky v konfiguraci agenta. Samotný přepínač nezpřístupní všechna workflow; bez způsobilého přiřazení se funkce trigger_workflow nenabídne.

Argument	Povinný	Význam
workflowId	Ano	ID způsobilého přiřazeného workflow.
input	Ano	Řetězec obsahující text nebo serializovaný JSON; bez vstupu použijte prázdný řetězec.

Backend workflow zařadí do fronty a vrátí potvrzení spuštění. Výsledek workflow toto volání nevrací. Dokončení, výstupy uzlů a chyby ověřte ve Workflows → Runs. Zpracování stále vyžaduje aktivního autora s oprávněním ke spuštění.

Neaktivní, smazaná, nepřístupná a nepřiřazená workflow nástroj nezpřístupní. Task created potřebuje událost úkolu. Opětovné spuštění stejného workflow z jeho běhového řetězce se odmítne. Vstup spuštění a mapování dalších uzlů jsou oddělené; viz omezení vstupu.

Task Management

Platform_CreateTask vytvoří úkol pouze na výslovný požadavek uživatele. Použije workspace aktuální konverzace nebo prostor přiřazený agentovi v běžné konverzaci; agent musí do prostoru patřit. Název jiného prostoru v promptu cíl nepřepne. Uloží také zdrojového agenta a konverzaci. Nový úkol může spustit aktivní workflow Task Created; přiřazení agenta ani výchozí agent prostoru samy úkol nespouštějí.

Parametr	Význam
summary	Povinné stručné shrnutí úkolu.
prompt	Volitelný podrobný prompt.
icon	Volitelný název ikony.
status	Todo, InProgress, Review nebo Done; výchozí je Todo.
assignedChatBotId	Volitelné UUID přiřazeného agenta.
assignedChatBotName	Volitelný přesný název; při nejednoznačnosti použijte ID.

Úspěšná odpověď vrací ID, shrnutí, stav a Open task. Volání selže při chybějícím shrnutí, nedostupném prostoru nebo zápisu, neplatném ID či nejednoznačném, nedostupném nebo rozporném výběru agenta.

Grounding with Google Search

GoogleSearch.Search používá systémové připojení GoogleSearch, vrací seřazené výsledky a může doplnit krátký text nalezených stránek. Výsledek obsahuje název, URL, úryvek a případně kontext; uživatel může dostat také View on Google.

Parametr	Význam
query	Povinný vyhledávací dotaz.
count	Počet výsledků 1–10; výchozí 3.
country	Google kód země, například cz, sk nebo us; výchozí cz.
timePeriod	Časové omezení, například d1, w1, m1 nebo y1.

Výsledky veřejného vyhledávání mohou být neaktuální; důležitá tvrzení ověřujte a citujte zdroje.

Web Scraper

Web scraper používá systémové Firecrawl připojení ke čtení externího obsahu. ScrapePageAsync načte stránku podle url a onlyMainContent; CrawlSiteAsync prochází omezený web podle url, limit, includePaths a excludePaths; MapSiteAsync vyhledá odkazy podle url, search a limit; SearchWebAsync hledá podle query a limit. Crawl může selhat, vypršet nebo nevrátit stránky. Přístup vyžaduje nakonfigurovaný Firecrawl endpoint a klíč; externí obsah může být zastaralý, citlivý nebo chráněný.

Čtení souborů mezi agenty

Nástroje pro soubory konverzace dodává runtime; nemají samostatný přepínač System Tools a nepotřebují Sandbox. Hlavní agent i subagent mohou pracovat s přílohami a publikovanými artefakty souvisejících rodičovských/podřízených konverzací a aktuálního kontextu volání subagenta. Nejde o prohledávání libovolných konverzací organizace ani disku Sandboxu.

1. Nechte agenta nejprve zavolat listAvailableFiles. Během tahu mohou přibýt soubory, takže starší seznam nemusí být aktuální.
2. Z vráceného seznamu vyberte název a zavolejte readFileContent s přesným fileName.
3. Při delegování pojmenujte potřebné soubory a požádejte subagenta, aby je ve vlastním kontextu vypsal a přečetl. Nepředpokládejte automatické kopírování počátečního modelového vstupu rodiče.
4. Ověřte výsledek nástroje. Chybějící soubor, nepodporovaný či poškozený formát a selhání stažení nejsou použitelný obsah; vyžádejte podporovaný soubor místo odhadování.

Obsah	Chování a omezení
Text a podporované dokumenty	Vrací extrahovaný text. Pro analýzu tabulek využijte specializované Excel nástroje, pokud jsou dostupné.
PDF	Extrahuje čitelný text. Neslibuje OCR naskenovaných stran.
PNG, JPEG, GIF, WebP	Aktuální dev může vrátit obrazový obsah ve výsledku nástroje, nejvýše 8 MiB na obrázek. Vyžaduje kompatibilní model a provider cestu; OpenAI používá Responses API. Podpora tím není doložena pro ostatní poskytovatele.
Bezpečnostně označená příloha	Vrací bezpečnostní placeholder, neobnovuje zablokovaný obsah.

Příklad požadavku:

Předej práci čtecímu agentovi. Ať vypíše dostupné soubory, přečte sales-notes.txt a sales-report.pdf a doloží údaje z obou. Pokud soubor nepřečte, ať uvede který.

Na první ukázce hlavní agent shrnuje údaje, které subagent přečetl ze syntetických souborů TXT, PDF a PNG:

V detailu delegování vedle odpovědi najdete soubory a zadání předané subagentovi:

readFileContent se liší od readFile a viewImage v Sandboxu i od uživatelského společného náhledu souborů. Náhled má vlastní formáty, velikostní a rozměrové limity. Jeho podpora AVIF a limit 20 MiB se na nástroj agenta nevztahují.

Generování obrázků

Image generation je System Tool, který podporovanému agentovi umožňuje vytvořit obrázek z textového zadání. Aktuální katalog System Tools v prostředí app-dev tento nástroj nabízí.

Runtime přidá funkci image_generation pouze tehdy, když platí obě podmínky:

1. agent má přiřazený nástroj Image generation,
2. agent používá model providera OpenAI, jehož název začíná gpt-.

Vlastní modely, jiní provideři a ostatní rodiny názvů modelů tento nástroj nedostanou. Runtime používá gpt-image-2, úspěšný výsledek nahraje jako image/png a uloží jej jako artefakt zprávy asistenta. Selhání se zobrazí jako neúspěšné spuštění nástroje pro generování obrázků, nikoli jako použitelný obrázek.

Například požádejte agenta: „Vygeneruj obrázek kočky.“ Výsledek se zobrazí v chatu, kde jej můžete otevřít nebo stáhnout. Pokud chcete výsledek upřesnit, popište motiv, kompozici, styl a barvy. Podrobný postup najdete v části Generování obrázků v Chatu.

Sandbox

Sandbox dává agentovi izolované linuxové prostředí a disk pro příkazy a práci se soubory v jedné konverzaci. Zapněte Sandbox v Configuration > System Tools agenta a vyberte Base image z katalogu poskytnutého serverem. Pokud je katalog dostupný, nový výběr je povinný a neznámé hodnoty jsou odmítnuty. Dříve uloženou volbu lze zachovat i po vyřazení image z nabídky; pro nové relace zvolte dostupný image. Nástroj se zobrazuje jen tehdy, když jej nasazené prostředí zpřístupňuje.

Produktový pracovní prostor (Workspace) sdružuje agenty, konverzace, úkoly a publikované soubory. Ze sandboxového disku nedělá sdílené úložiště: konverzace ve stejném pracovním prostoru mají stále oddělené sandboxové relace a disky.

Sandbox není počítač uživatele. Má vlastní linuxové prostředí pro jednu konverzaci a k lokálním souborům se dostane pouze tehdy, když je uživatel nahraje a agent je explicitně stageuje.

Session a příkazy

První operace vytvoří session pro aktuální konverzaci lazy provisioningem a použije Base image vybraný u agenta. Další volání používají stejnou session a disk. Změna Base image proto ovlivní jen nově vytvořené sessions; běžící konverzace zachová svůj původní image. Každé runCommand spustí nový shell bash -lc v /mnt/work, ale soubory a nainstalované balíčky mohou mezi voláními na disku konverzace zůstat.

V jedné konverzaci běží současně jen jedna Sandbox operace. Lease serializuje volání mezi instancemi aplikace a organizační a uživatelské concurrency limity omezují počet aktivních sandboxů. Nečinnou session lze suspendovat a později obnovit. Pokud session chybí, selhala nebo byla resetována, může další operace vytvořit náhradu a agent musí znovu vytvořit potřebné soubory a nainstalovat balíčky.

Smazání konverzace odstraní její Sandbox prostředky. Reconciliation vyřazuje osiřelé nebo chybné session. Disk sandboxu slouží k uchování pracovního stavu konverzace a není trvalým úložištěm dokumentů. Síťový přístup se řídí allowlistem nasazeného prostředí.

Funkce

Funkce	Účel	Důležité chování
runCommand	Spustí shell příkaz v /mnt/work.	Vrací exit code, stdout a stderr. Platí timeout prostředí a dlouhý výstup může být zkrácen.
writeFile	Zapíše UTF-8 textový soubor.	Relativní cesta musí zůstat uvnitř /mnt/work.
readFile	Přečte textový nebo binární soubor.	Text se vrací jako text, binární obsah jako base64. Výsledek uvádí truncation.
listFiles	Vypíše jeden adresář sandboxu.	Výpis není rekurzivní a obsahuje název, velikost a příznak adresáře.
viewImage	Zobrazí obrázek ze sandboxu agentovi ke kontrole.	Podporuje PNG, JPEG, GIF a WebP v limitu nasazení. Obrázek tím nezveřejní uživateli.
publishFiles	Publikuje vybrané soubory jako artefakty zprávy.	Cesta musí ukazovat na existující soubor. Nic se nepublikuje automaticky.

Čas příkazu, velikost souborů a obrázků, počet publikovaných souborů i souběžné relace mají samostatné limity. Mezi nasazeními se mohou lišit. Při dosažení limitu se řiďte hodnotou v chybě a požádejte správce prostředí o kontrolu příslušného nastavení.

Vizuální kontrola výsledku

U dokumentu, prezentace nebo grafu požádejte agenta, aby výsledek převedl na obrázek a před publikováním jej zkontroloval pomocí viewImage. Stránky PDF a soubory SVG musí nejprve převést do podporovaného obrazového formátu. Zvolený Base image musí obsahovat software potřebný pro převod.

Kontrola může odhalit oříznutý text, chybějící graf nebo špatné rozložení stránky. Publikovaný soubor pak zkontrolujete v Chatu nebo v původní aplikaci. viewImage slouží agentovi; pro vás jsou u publikovaného souboru akce Open a Download original. Viz formáty náhledu.

Staging vstupů

Přílohy a dřívější artefakty konverzace se nekopírují automaticky. Agent uvede každý požadovaný soubor v argumentu files funkce runCommand. Siesta AI vybrané vstupy vloží pod /mnt/work/in a vrátí jejich přesné cesty v stagedFiles. Agent má použít vrácenou cestu a nemá hádat název souboru.

Bezpečný tok je: uživatel nahraje sales.csv, agent jej uvede v files, zpracuje vrácenou staged cestu, vytvoří /mnt/work/cleaned-sales.csv, ověří výsledek a zavolá publishFiles s cleaned-sales.csv. Siesta AI připojí publikovaný název, velikost a content type k assistant message jako stažitelný artefakt.

Soubory ponechané jen v /mnt/work jsou mezistav sandboxu. Nejsou viditelné uživateli, automaticky publikované ani trvalou náhradou Data nebo Memory. Opětovné publikování změněné cesty vytvoří nový artefakt.

Publikování souboru z konverzace do pracovního prostoru

Vytvořte a ověřte soubor na sandboxovém disku konverzace, potom pomocí publishFiles uložte artefakt konverzace. Samotný zápis nebo kontrola přes viewImage soubor nepublikují.

V chatu pracovního prostoru se nové artefakty asistenta a úspěšných výsledků nástrojů automaticky připojují k prostoru konverzace, pokud je uživatel přihlášený, má oprávnění upravovat pracovní prostory a přístup pro zápis. Druhé volání Platform_PublishWorkspaceArtifact obvykle není potřeba. Výsledek ověřte v Artefaktech prostoru nebo globálním katalogu Artefakty. Vstupní přílohy a nepublikované soubory sandboxu se automaticky nepřipojují.

Pokud automatické publikování selže, výstup zůstane v konverzaci s upozorněním: „The generated file was saved in this conversation, but could not be added to Workspace Artifacts.“ Ověřte zápis do prostoru a podle dostupnosti publikování zopakujte; úspěšný výstup nevytvářejte znovu jen kvůli selhání jeho přiřazení.

Pro výslovné publikování může agent přiřazený k prostoru použít Platform_PublishWorkspaceArtifact. Například: „Publikuj cleaned-sales.csv z této konverzace do svého pracovního prostoru.“ Slouží také pro podporované konverzace bez výslovné příslušnosti k prostoru a opakování publikování existujícího výstupu. Vyžaduje přihlášení, oprávnění upravovat prostory, zápis a přístup k agentovi a konverzaci. Předejte právě jeden údaj: sourceFileName (jednoznačný úspěšný výstup aktuálního běhu) nebo sourceArtifactId (existující artefakt stejné konverzace). Cesta v sandboxu ani libovolná URL nejsou zdrojem pro publikování. Runtime znovu kontroluje prostor a vazbu agenta; po změně přiřazení zahajte nový běh.

Publikování přiřadí artefakt k prostoru a nekopíruje sandboxový disk. Opětovné připojení stejného artefaktu využije existující přiřazení. Po úpravě souboru v sandboxu zavolejte publishFiles pro nový výstup; dřívější artefakt se nepřepíše. V chatu prostoru lze nový výstup připojit automaticky, jinde jej podle potřeby publikujte výslovně. Viz Artefakty pracovního prostoru.

Chyby a schválení

Mezi očekávané chyby patří nedostupná kapacita, provisioning nebo resume timeout, obsazená session či vypršelý lease, timeout příkazu, nenulový exit code, zkrácený výstup, reset workspace, chybějící vstup, cesta mimo workspace, příliš velký přenos, chybějící publish target a částečné publikování.

Nepředpokládejte, že runCommand vždy vyžaduje schválení. Funkce Sandboxu sama approval prompt negarantuje; toto chování musí zajistit nasazený runtime a tool policy. Před použitím pro sdíleného nebo produkčního agenta ověřte skutečný approval flow a před povolením zkontrolujte příkaz v detailu nástroje.

Příznak	Význam	Postup
Sandbox není v seznamu nebo Base image nenabízí žádnou volbu	Prostředí Sandbox nezpřístupňuje nebo nemá žádný povolený image.	Požádejte správce prostředí o kontrolu funkce a katalogu obrazů.
Formulář vyžaduje Base image nebo odmítne uloženou hodnotu	Není vybraný aktuální image nebo hodnota neplatí pro nový výběr.	Vyberte položku ze seznamu; nikdy nezadávejte nezobrazené ID.
Provisioning selže po úspěšném uložení agenta	Formulář výběr přijal, ale session nebo image nebylo možné vytvořit.	Zkontrolujte kapacitu a dostupnost image; změna agenta nepřebuduje session existující konverzace.

Task Management a automatizace

Platform_CreateTask vytváří trvalý úkol v prostoru aktuální konverzace, případně v prostoru přiřazeném agentovi, pokud běžná konverzace nemá výslovnou příslušnost. Agent musí do prostoru nadále patřit; uvedení jiného prostoru v promptu cíl nástroje nezmění. Úkol vzniká pouze na výslovný požadavek uživatele. Vytvoření může spustit aktivní workflow Task Created navázané na tento prostor. Pracovní prostor má vlastní nastavení výchozího agenta. Při ručním spuštění úkolu se použije agent vybraný v detailu, jinak přidělený agent úkolu a poté jeho zdrojový agent. Výchozí agent pracovního prostoru ani přiřazení agenta k úkolu samo o sobě práci nespustí. Požadovanou automatizaci nastavte ve Workflows.

SiestaAI Help

siesta_help_resolve pomáhá s diagnostikou připojení, přiřazením nástrojů a dokumentací. Zapíná se v Configuration → System Tools → SiestaAI Help a samo neuděluje oprávnění. Povinný userRequest obsahuje původní dotaz. Volitelné capability určuje schopnost, targetService nebo targetServices výslovně uvedené služby a targetServiceMentionedByUser zda je uživatel skutečně pojmenoval. Cílového agenta určují targetAgentId, targetAgentName a targetAgentMentionedByUser. intent může být connection_setup, connection_assignment, connection_diagnostics nebo platform_docs; topic označuje téma dokumentace. Výsledek může obsahovat zprávu, stav, odkaz do dokumentace nebo akční kartu s tlačítky.

Funkce Platform Tools

Kromě zapnutí nástroje agentovi potřebuje uživatel Agents.UsePlatformTools; každá akce ověřuje také přístup k cílovému objektu.

• Agenti: Platform_CreateAgent, Platform_CreateAgentFromTemplate, Platform_GetAgent, Platform_ListAgents a Platform_UpdateAgent vytvářejí, vyhledávají nebo mění agenty. Platform_ListConversations a Platform_ListMessages čtou dostupné soukromé konverzace a zprávy; veřejné a sdílené konverzace nezahrnují.
• Skills: Platform_CreateSkill, Platform_GetSkill, Platform_ListSkills a Platform_UpdateSkill spravují název, instrukce a popis. Změna instrukcí ovlivňuje agenty používající skill.
• Templates: Platform_GetTemplate a Platform_ListTemplates čtou nebo vyhledávají šablony.
• Memory: Platform_CreateMemoryCollection, Platform_GetMemoryCollection, Platform_ListMemoryCollections, Platform_UpdateMemoryCollection, Platform_CreateMemoryPage, Platform_GetMemoryPage a Platform_UpdateMemoryPage pracují s kolekcemi a stránkami.

U agentů Platform_CreateAgent přijímá název, systémovou zprávu, popis, modelová nastavení a úvodní zprávu; bez přepsání používá model a připojení současného agenta. Platform_CreateAgentFromTemplate přijímá templateId. Platform_GetAgent a Platform_UpdateAgent umožňují vlastní identitu pomocí self; listovací funkce podporují hledání a limit. Výpis zpráv navíc podporuje filtr role.

Skill se vytváří pomocí name, instructions a volitelného description; aktualizace mění jen poskytnutá pole. Stránka Memory používá collectionId, name, body, order a parentId; aktualizace může měnit název, obsah, pořadí a nadřazenou stránku.

U Platform_UpdateAgent poskytnutá pole přiřazení nahrazují celý odpovídající seznam, například skillIds, systemToolIds nebo subAgentIds; nejde o přidání jedné položky. Stejně tak pole Memory nahrazují aktuální přiřazení stránek. Poskytnutá znalost Memory se stává opakovaně použitelným obsahem.

Orchestration

run_function_batch předává každou položku pole input pojmenované funkci subagenta functionName. Pro každý vstup vzniká soukromá konverzace; výsledky se spojí. Volání běží paralelně nejvýše ve 40 souběžných úlohách. Jde o dávkový nástroj, který se liší od Agent harness.

JavaScript Executor

JsExecutorAgent synchronně vykoná JavaScript v Jint a vrací logy a výsledek posledního výrazu. Objekty a pole se převádějí přes JSON.stringify.

Pomocná funkce	Použití
log, logStatus	Interní výstup a průběžný stav pro uživatele.
callAgent, callAgentsParallel	Volání jednoho nebo více subagentů; pole jmen a promptů musí mít stejnou délku.
readExcelFile, listExcelSheets, writeExcelFile, createExcelDocument	Čtení a tvorba Excel souborů; vytvořený dokument lze připojit jako artefakt.
searchExcelRows, getExcelColumnStats	Vyhledávání řádků a číselné statistiky sloupce.
copyFileAsArtifact, editArtifactFile	Kopie přílohy do artefaktů a změna dříve vytvořeného souboru.

Pomocné funkce jsou synchronní; nepoužívejte async, await ani Promises. U významné práce zobrazte průběh pomocí logStatus. Nástroj zpřístupňujte důvěryhodným agentům, protože umí volat subagenty a vytvářet soubory.

Související návody

• Spuštění nástrojů
• Pro uživatele: Nastavte a používejte agenta
• Pro uživatele: Jednoduchá otázka
• Pro uživatele: Použijte Tasks ke sledování práce
• Nastavení Tools, API a MCP
• Pro administrátory: Definování přístupových zásad a pravidel viditelnosti