Skip to content

forcedotcom/sf-skills / plugins/builder/agentforce-adlc/skills/agentforce-generate

agentforce-generate

Flagged

Build, modify, audit, repair, optimize, debug, and deploy agents with Agentforce Agent Script. TRIGGER when: user creates, reviews, or changes .agent files or aiAuthoringBundle metadata; asks to fix AgentScript, audit an existing agent, run an AgentScript health check, common-pitfall review, or baseline-versus-candidate repair loop; changes a response, action, subagent, route, state flow, or Agent Spec; migrates or upgrades a legacy GenAiPlannerBundle Agentforce agent (NOT an Einstein Bot) to an aiAuthoringBundle (Agent Script) agent; previews, debugs, deploys, publishes, or tests agents; uses sf agent generate/preview/publish/test; or manages Agentforce MCP servers, tools, assets, or authentication. DO NOT TRIGGER when: Apex, Flow, Prompt Template, Experience Cloud, or general Salesforce CLI work is unrelated to Agent Script; the source is an Einstein Bot (BotDefinition/BotVersion) — use agentforce-bot-upgrade; or the primary input is a production session or trace ID rather than an agent artifact.

FileKindSize
README.mdmarkdown5.4 KB
SKILL.mdskill md31.7 KB
assets/agent-spec-template.mdmarkdown6.4 KB
assets/agents/README.mdmarkdown2.6 KB
assets/agents/hello-world.agentother1.9 KB
assets/agents/knowledge-grounded.agentother5.6 KB
assets/agents/local-info-agent-annotated.agentother17.0 KB
assets/agents/order-service.agentother11.7 KB
assets/agents/production-faq.agentother3.9 KB
assets/agents/production-faq.bundle-meta.xmlconfig161 B
assets/agents/router-first.agentother5.6 KB
assets/agents/simple-qa.agentother1.9 KB
assets/agents/template-multi-subagent.agentother5.4 KB
assets/agents/template-single-subagent.agentother2.6 KB
assets/agents/verification-gate.agentother10.7 KB
assets/agents/voice-knowledge-grounded.agentother8.2 KB
assets/agents/voice-service-agent.agentother4.6 KB
assets/bundle-meta.xmlconfig808 B
assets/invocable-apex-template.clsother6.9 KB
assets/patterns/README.mdmarkdown10.8 KB
assets/patterns/action-callbacks.agentother4.7 KB
assets/patterns/advanced-input-bindings.agentother6.9 KB
assets/patterns/bidirectional-routing.agentother5.6 KB
assets/patterns/critical-input-collection.agentother12.2 KB
assets/patterns/delegation-routing.agentother6.4 KB
assets/patterns/lifecycle-events.agentother4.7 KB
assets/patterns/llm-controlled-actions.agentother5.1 KB
assets/patterns/multi-step-workflow.agentother10.1 KB
assets/patterns/open-gate-routing.agentother11.6 KB
assets/patterns/procedural-instructions.agentother4.8 KB
assets/patterns/prompt-template-action.agentother6.6 KB
assets/patterns/system-instruction-overrides.agentother10.6 KB
references/action-prompt-templates.mdmarkdown5.7 KB
references/actions-reference.mdmarkdown30.2 KB
references/agent-access-guide.mdmarkdown2.9 KB
references/agent-audit-and-repair.mdmarkdown7.9 KB
references/agent-audit-candidate-verification.mdmarkdown5.2 KB
references/agent-audit-diagnostic-catalog.mdmarkdown7.6 KB
references/agent-audit-diagnostics-actions-state.mdmarkdown6.9 KB
references/agent-audit-diagnostics-architecture-evaluation.mdmarkdown2.5 KB
references/agent-audit-diagnostics-instructions-routing.mdmarkdown11.8 KB
references/agent-audit-evaluation-loop.mdmarkdown6.0 KB
references/agent-audit-repair-report.mdmarkdown6.9 KB
references/agent-audit-scope-path-review.mdmarkdown8.5 KB
references/agent-design-and-spec-creation.mdmarkdown54.5 KB
references/agent-metadata-and-lifecycle.mdmarkdown30.2 KB
references/agent-script-core-language.mdmarkdown49.3 KB
references/agent-subagent-map-diagrams.mdmarkdown10.8 KB
references/agent-user-setup.mdmarkdown27.8 KB
references/agent-validation-and-debugging.mdmarkdown44.6 KB
references/agentscript-toolchain.mdmarkdown4.6 KB
references/architecture-patterns.mdmarkdown13.5 KB
references/common-control-flow-pitfalls.mdmarkdown9.4 KB
references/complex-data-types.mdmarkdown3.9 KB
references/control-flow-actions-sequencing.mdmarkdown6.9 KB
references/control-flow-lifecycle-side-effects.mdmarkdown3.3 KB
references/data-library-reference.mdmarkdown40.8 KB
references/deploy-reference.mdmarkdown6.7 KB
references/discover-reference.mdmarkdown4.3 KB
references/examples.mdmarkdown12.6 KB
references/feature-validity.mdmarkdown2.1 KB
references/instruction-resolution.mdmarkdown23.4 KB
references/known-issues.mdmarkdown27.6 KB
references/legacy-nga-regression-eval.mdmarkdown30.2 KB
references/mcp-management-reference.mdmarkdown37.6 KB
references/optimization-pattern-1-data-flow.mdmarkdown4.6 KB
references/optimization-pattern-2-deterministic-logic.mdmarkdown5.4 KB
references/optimization-pattern-3-reference-syntax.mdmarkdown4.1 KB
references/optimization-pattern-4-escalation.mdmarkdown2.2 KB
references/org-setup-for-adl.mdmarkdown23.7 KB
references/patterns-by-requirement.mdmarkdown5.4 KB
references/posture-and-determinism.mdmarkdown9.3 KB
references/production-gotchas.mdmarkdown12.6 KB
references/reference-map.mdmarkdown5.3 KB
references/safety-review-reference.mdmarkdown6.3 KB
references/salesforce-cli-for-agents.mdmarkdown16.7 KB
references/scaffold-reference.mdmarkdown6.7 KB
references/scoring-rubric.mdmarkdown3.3 KB
references/upgrade-legacy-agent-to-agentscript.mdmarkdown26.2 KB
references/version-history.mdmarkdown4.4 KB
references/voice-latency-heuristics.mdmarkdown9.7 KB
references/voice-modality-reference.mdmarkdown19.0 KB
references/voice-telephony-cli.mdmarkdown10.3 KB
references/zen-of-agentscript.mdmarkdown13.1 KB
scripts/__init__.pyscript0 B
scripts/agentscript-sdk-loader.mjsscript4.0 KB
scripts/discover.pyexecutablescript20.2 KB
scripts/generators/__init__.pyscript0 B
scripts/generators/apex_stub.pyscript13.4 KB
scripts/generators/apex_test_stub.pyscript3.8 KB
scripts/generators/flow_xml.pyscript7.6 KB
scripts/generators/permission_set_xml.pyscript1014 B
scripts/generators/remote_site_xml.pyscript1.4 KB
scripts/index-agent.mjsexecutablescript3.8 KB
scripts/org_describe.pyexecutablescript5.8 KB
scripts/scaffold.pyexecutablescript15.1 KB
scripts/setup-agentscript-sdk.mjsexecutablescript9.7 KB
scripts/upgrade-legacy-nga-analyze.pyexecutablescript20.0 KB
scripts/upgrade-legacy-nga-run-trials.shexecutablescript3.4 KB

assets/patterns/prompt-template-action.agent

View on GitHub
# Prompt Template Action Pattern
# Invoke Salesforce PromptTemplates directly from Agent Script
#
# ★ When To Use This Pattern:
#   - Generate dynamic AI content (summaries, emails, recommendations)
#   - Use Einstein Prompt Builder templates from agents
#   - Combine structured data with LLM generation
#   - Leverage existing PromptTemplate investments
#
# ★ Key Insights:
#   - Target uses generatePromptResponse:// protocol (not flow://)
#   - Input names MUST have "Input:" prefix (critical!)
#   - Output field is always named "promptResponse"
#   - PromptTemplate must be deployed BEFORE the agent
#
# ★ Important Limitation:
#   - Template API name must exactly match target
#   - Record-bound templates require recordId input
#
# This is a COMPLETE template - customize for your use case

system:
    instructions: "You are a content generation assistant. Help users create personalized content using AI templates. Always verify the generated content meets quality standards."
    messages:
        welcome: "Hello! I can help generate personalized content for you."
        error: "I encountered an issue generating content. Let me try again."

access:
    default_agent_user: "agent@company.salesforce.com"

config:
    developer_name: "Content_Generator_Agent"
    agent_label: "Content Generator"
    description: "Agent that generates AI content using Prompt Templates"

variables:
    # Standard linked variables
    EndUserId: linked string
        source: @MessagingSession.MessagingEndUserId
        description: "Messaging End User ID"
    RoutableId: linked string
        source: @MessagingSession.Id
        description: "Messaging Session ID"
    ContactId: linked string
        source: @MessagingEndUser.ContactId
        description: "Contact ID"

language:
    default_locale: "en_US"

start_agent agent_router:
    label: "Content Generator"
    description: "Routes to content generation options"

    reasoning:
        instructions: ->
            | Ask the user what type of content they'd like to generate:
              1. Personalized daily schedule
              2. Professional email
              Route to the appropriate request handler.
        actions:
            go_schedule: @utils.transition to @subagent.schedule_generation
            go_email: @utils.transition to @subagent.email_generation

subagent schedule_generation:
    label: "Schedule Generation"
    description: "Generate personalized daily schedules"

    actions:
        # ★ PROMPT TEMPLATE ACTION - Key syntax elements:
        # 1. target: uses generatePromptResponse:// protocol
        # 2. inputs: MUST use "Input:" prefix
        # 3. outputs: field name is always "promptResponse"
        Generate_Personalized_Schedule:
            description: "Generate a personalized daily schedule using AI."
            inputs:
                # ★ CRITICAL: Input names must have "Input:" prefix
                # These map to {!email} and {!timezone} in the PromptTemplate
                "Input:email": string
                    description: "User's email address for preference lookup"
                    is_required: True
                "Input:timezone": string
                    description: "User's timezone for schedule formatting"
                    is_required: False
            outputs:
                # ★ Standard output field name for prompt responses
                promptResponse: string
                    description: "The AI-generated schedule content"
                    is_used_by_planner: True
                    is_displayable: True
            # ★ Target protocol: generatePromptResponse://TemplateApiName
            target: "generatePromptResponse://Generate_Personalized_Schedule"

    reasoning:
        instructions: ->
            | Help the user create a personalized daily schedule.
              1. Ask for their email (required)
              2. Ask for their timezone (optional, defaults to Pacific)
              3. Generate the schedule using the AI template
              4. Present the generated schedule
              The schedule will include morning routine, work blocks,
              breaks, and evening wind-down based on preferences.

        actions:
            create_schedule: @actions.Generate_Personalized_Schedule
                # ★ Input binding with quoted field names
                with "Input:email"=...
                with "Input:timezone"=...

            back: @utils.transition to @subagent.agent_router

subagent email_generation:
    label: "Email Generation"
    description: "Generate professional emails"

    actions:
        # Another Prompt Template action example
        Generate_Professional_Email:
            description: "Generate a professional email draft."
            inputs:
                "Input:recipientName": string
                    description: "Name of the email recipient"
                    is_required: True
                "Input:topic": string
                    description: "Topic or purpose of the email"
                    is_required: True
                "Input:tone": string
                    description: "Desired tone: formal, friendly, urgent"
                    is_required: False
            outputs:
                promptResponse: string
                    description: "The generated email content"
                    is_used_by_planner: True
                    is_displayable: True
            target: "generatePromptResponse://Generate_Professional_Email"

    reasoning:
        instructions: ->
            | Help the user draft a professional email.
              Collect:
              1. Recipient's name (required)
              2. Email topic/purpose (required)
              3. Desired tone: formal, friendly, or urgent (optional)
              Generate the email and present it for review.

        actions:
            create_email: @actions.Generate_Professional_Email
                with "Input:recipientName"=...
                with "Input:topic"=...
                with "Input:tone"=...

            back: @utils.transition to @subagent.agent_router

# ★ Insight: Prompt Template Integration Checklist
#
# BEFORE PUBLISHING AGENT:
#   1. Create PromptTemplate metadata file
#   2. Deploy PromptTemplate: sf project deploy start -m "PromptTemplate:Template_Name"
#   3. Verify template exists: sf org list metadata -m PromptTemplate
#
# INPUT MAPPING:
#   Agent Script "Input:fieldName" → PromptTemplate {!fieldName}
#   "Input:email"                  → {!email}
#   "Input:customerName"           → {!customerName}
#
# COMMON ERRORS:
#   - HTTP 404: PromptTemplate not deployed yet
#   - "property X not found": Input name doesn't match template variable
#   - Missing "Input:" prefix: Inputs won't map correctly
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall