Agentforce Agent Script

Kompletní životní cyklus agenta Salesforce Agentforce: návrh, Agent Script, validace, nasazení, publikace.

od SalesforceAIResearch · SalesforceAIResearch/agentforce-adlc

Otestováno · Funguje ★ 9.2/10

Agentforce Agent Script — Kompletní životní cyklus agenta Salesforce Agentforce: návrh, Agent Script, validace, nasazení, publikace.

Co umí

Směruje celý životní cyklus vývoje agenta Agentforce — návrh Agent Spec, psaní souborů .agent v Agent Script, sf CLI validate/preview/deploy/publish/activate a behaviorální ladění pomocí trasování relací — prostřednictvím 18 podrobných referenčních souborů. Spouští se při práci se soubory .agent, metadaty aiAuthoringBundle, návrhu subagentů/akcí a příkazech sf agent CLI; explicitně vylučuje práci s Apex, Flow a Experience Cloud.

Testovací report

Nainstalováno příkazem z čistého HOME bez ~/.claude — SKILL.md byl na místě; všech ~30 odkazů na references/ a assets/ v těle se vyřešilo, žádné skripty ani síťová volání ve skillu (Stage 0 čisté). Od posledního testu autor přidal zcela novou doménu 'Optimize an Agent' (v0.8 → v0.9) se čtyřmi vzory a do popisu zahrnul 'optimize/improve/refactor' — staré zjištění o pravidle 8 (zákaz else-if) je stále tam a nedotčeno. Spustil jsem novou doménu na svém souboru .agent se čtyřmi vloženými defekty: bez skillu jsem vymyslel neexistující syntaxi `@actions.fetch_case.outputs.caseRecord` (jádrový jazyk explicitně uvádí: `@outputs` žije pouze v `set`/`if` ihned po akci), nechal `@variables.customerName` bez `{!...}` a veškerou podmíněnou logiku v próze; se skillem — správné předání přes měnitelnou proměnnou, 4 `set @variables.X = @outputs.Y` vazby, `{!...}`-injekce a ploché `if` příkazy podle pravidla 8. Minus: nové soubory vzorů a šablona reportu v SKILL.md vyžadují `orderRecord: mutable object` a `roomAvailable: boolean` bez výchozích hodnot, což je v rozporu s vlastní referencí jádrového jazyka skillu (sekce 6 a Anti-Pattern 12: měnitelné proměnné MUSÍ mít výchozí hodnotu) — za to byly odečteny body z výstupu a dokumentace. Krok 'sf agent validate' nebylo možné zkontrolovat: CLI `sf` a Salesforce org nebyly v prostředí, kompilace nebyla měřena — kontrolováno pouze proti vlastním zdokumentovaným pravidlům skillu.

Testováno: 2026-07-13 · Claude Code 2.x (agent harness)

Instalace

git clone https://github.com/SalesforceAIResearch/agentforce-adlc
cd agentforce-adlc
mkdir -p ~/.claude/skills
cp -r skills/agentforce-generate ~/.claude/skills/agentforce-generate

Příkazy a ukázkové prompty

  • /agentforce-generateKompletní životní cyklus agenta Salesforce Agentforce: návrh, Agent Script, validace, nasazení, publikace.

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

  • Add a billing subagent to our Agentforce agent for unpaid invoices
  • Write an Agent Spec and design the subagent graph for a support agent
  • My sf agent validate is failing, help debug this .agent file