Agentforce Agent Script
Ciclo de vida completo del agente Salesforce Agentforce: diseño, Agent Script, validación, despliegue, publicación.
Probado · Funciona
Qué hace
Dirige el ciclo de vida completo de desarrollo de agentes Agentforce — diseño de Agent Spec, escritura de archivos .agent en Agent Script, validación/vista previa/despliegue/publicación/activación con sf CLI, y depuración de comportamiento mediante trazas de sesión — a través de 18 archivos de referencia detallados. Se activa en trabajos con archivos .agent, metadatos de aiAuthoringBundle, diseño de subagentes/acciones y comandos sf agent CLI; excluye explícitamente el trabajo con Apex, Flow y Experience Cloud.
Informe de la prueba
Instalado con un comando desde un HOME limpio sin ~/.claude — SKILL.md estaba en su lugar; todas las ~30 referencias a references/ y assets/ en el cuerpo se resolvieron, sin scripts ni llamadas de red en la skill (Etapa 0 limpia). Desde la última prueba, el autor añadió un dominio completamente nuevo 'Optimize an Agent' (v0.8 → v0.9) con cuatro patrones e incluyó 'optimize/improve/refactor' en la descripción — el hallazgo antiguo sobre la Regla 8 (prohibición de else-if) sigue ahí y sin cambios. Se ejecutó el nuevo dominio en mi archivo .agent con cuatro defectos inyectados: sin la skill, inventé una sintaxis inexistente `@actions.fetch_case.outputs.caseRecord` (el lenguaje central establece explícitamente: `@outputs` solo vive en `set`/`if` inmediatamente después de una acción), dejé `@variables.customerName` sin `{!...}` y toda la lógica condicional en prosa; con la skill — retransmisión correcta a través de una variable mutable, 4 enlaces `set @variables.X = @outputs.Y`, inyecciones `{!...}` y sentencias `if` planas según la Regla 8. Menos: los nuevos archivos de patrón y la plantilla de informe en SKILL.md requieren `orderRecord: mutable object` y `roomAvailable: boolean` sin valores predeterminados, lo que contradice la propia referencia del lenguaje central de la skill (sección 6 y Anti-Patrón 12: las variables mutables DEBEN tener un valor predeterminado) — por esto, se dedujeron puntos de la salida y la documentación. No se pudo verificar el paso 'sf agent validate': el CLI `sf` y una organización de Salesforce no estaban en el entorno, la compilación no se midió — solo se verificó contra las propias reglas documentadas de la skill.
Probado el: 2026-07-13 · Claude Code 2.x (agent harness)
Instalación
git clone https://github.com/SalesforceAIResearch/agentforce-adlc cd agentforce-adlc mkdir -p ~/.claude/skills cp -r skills/agentforce-generate ~/.claude/skills/agentforce-generate
Comandos y prompts de ejemplo
/agentforce-generateCiclo de vida completo del agente Salesforce Agentforce: diseño, Agent Script, validación, despliegue, publicación.
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Add a billing subagent to our Agentforce agent for unpaid invoicesWrite an Agent Spec and design the subagent graph for a support agentMy sf agent validate is failing, help debug this .agent file