defineSkill
Definujte dovednosti agentů AI
defineSkill
Definujte dovednosti agentů AI
Dovednosti definují znovupoužitelné pokyny a schopnosti, které mohou agenti AI používat ve vašem pracovním prostoru. K definování dovedností s vestavěnou validací použijte Hlavní body:
defineSkill():src/skills/example-skill.ts
nameje jedinečný identifikátor dovednosti (doporučuje se kebab-case).labelje uživatelsky čitelný název zobrazovaný v UI.contentobsahuje pokyny dovednosti — je to text, který agent AI používá.icon(volitelné) nastavuje ikonu zobrazovanou v UI.description(volitelné) poskytuje doplňující kontext o účelu dovednosti.
defineAgent
Definujte AI agenty s vlastními prompty
defineAgent
Definujte AI agenty s vlastními prompty
Agenti jsou asistenti AI, kteří běží ve vašem pracovním prostoru. K vytvoření agentů s vlastním systémovým promptem použijte Hlavní body:Poznámky ke schématu:
defineAgent():src/agents/example-agent.ts
nameje jedinečný identifikátor agenta (doporučuje se kebab-case).labelje zobrazovaný název v UI.promptje systémový prompt, který definuje chování agenta.description(volitelné) poskytuje kontext o tom, co agent dělá.icon(volitelné) nastavuje ikonu zobrazovanou v UI.modelId(volitelné) přepíše výchozí model AI používaný agentem.responseFormat(volitelně) určuje tvar výstupu agenta. Výchozí hodnota je{ type: 'text' }pro volný text. Použijte{ type: 'json', schema }k vynucení strukturovaného výstupu ve formátu JSON.
responseFormat na { type: 'json' } a poskytněte schema:src/agents/structured-agent.ts
- Schéma je plochý objekt:
typekaždé vlastnosti musí být primitivní typ (string,numberneboboolean). Vnořené objekty a pole nejsou podporovány. description(volitelně) u každé vlastnosti navádí model, co má na toto místo doplnit.required(volitelně) vypisuje vlastnosti, které musí model vždy vrátit.additionalProperties: false(volitelně) zakáže jakoukoli vlastnost, která není deklarována vproperties.
runAgent
Spuštění agenta z logické funkce
runAgent
Spuštění agenta z logické funkce
runAgent() umožňuje logické funkci spustit jednoho z agentů vaší aplikace (s jeho dovednostmi a nástroji). Identifikujte agenta pomocí universalIdentifier, který jste předali do defineAgent(). Předejte buď řetězec prompt, nebo historii konverzace messages, ale ne obojí zároveň:src/logic-functions/run-enricher.ts
messages místo jednoho prompt:src/logic-functions/reply-in-thread.ts
- Zadejte přesně jednu z možností:
prompt(řetězec) nebomessages(1 až 100 položek{ role: 'user' | 'assistant', content: string }). - Agent běží synchronně a může sám číst/aktualizovat záznamy pomocí vlastních nástrojů —
runAgent()vrátí výsledek až po dokončení běhu. - Aplikace může spouštět pouze své vlastní agenty.
- Výchozí role aplikace musí udělovat příznak oprávnění
AI— přidejteSystemPermissionFlag.AIdopermissionFlagUniversalIdentifiers(nebo nastavtecanAccessAllTools: true). Bez nějrunAgent()selže s chybou oprávnění. - Nastavte u logické funkce velkorysou hodnotu
timeoutSeconds— běh agenta může trvat několik sekund. successjetruearesultnení null po dokončení běhu; při chybě jesuccessfalse,resultjenullaerrorobsahuje důvod (například když během běhu workspace vyčerpal AI kredity).
src/roles/default-role.ts
Spuštění jménem člena pracovního prostoru
PředejterunAsWorkspaceMemberId, když je spuštění vyvoláno osobou — například chatbotem odpovídajícím na zprávu — aby agent jednal jako tento člen, nikoli jako aplikace:src/logic-functions/answer-question.ts
- Token, který nemá přiřazeného žádného uživatele, může pojmenovat libovolného člena. Logická funkce běží
s takovým tokenem a totéž platí pro tokeny vytvořené prostřednictvím
client_credentialsnebo z klíče API. - Token vydaný jménem uživatele, jaký obdrží front-endová komponenta, smí pojmenovat pouze člena daného uživatele.