@salesforce/afv-skills 1.7.3 → 1.7.4

package/skills/developing-agentforce/assets/agents/production-faq.agent

@@ -29,7 +29,7 @@ variables:
 	user_question: mutable string
 		description: "The user's current question"
 	conversation_topic: mutable string
-		description: "The current topic being discussed"
+		description: "The current subject being discussed"
 	question_count: mutable number
 		description: "Number of questions answered in this session"
 
@@ -38,20 +38,20 @@ language:
 	additional_locales: ""
 	all_additional_locales: False
 
-start_agent topic_selector:
-	label: "Topic Selector"
+start_agent agent_router:
+	label: "Subagent Router"
 	description: "Routes incoming questions to the FAQ handler"
 
 	reasoning:
 		instructions: ->
 			| Listen to the user's question and determine how to help.
-			| If the question is about a specific topic, note it.
+			| If the question is about a specific subject, note it.
 			| Route to the FAQ handler for processing.
 		actions:
-			handle_faq: @utils.transition to @topic.faq_handler
-			end_conversation: @utils.transition to @topic.farewell
+			handle_faq: @utils.transition to @subagent.faq_handler
+			end_conversation: @utils.transition to @subagent.farewell
 
-topic faq_handler:
+subagent faq_handler:
 	label: "FAQ Handler"
 	description: "Handles frequently asked questions and provides helpful answers"
 
@@ -74,11 +74,11 @@ topic faq_handler:
 			| - Suggest contacting customer support
 			| - Offer to help with something else
 		actions:
-			new_question: @utils.transition to @topic.topic_selector
-			end_conversation: @utils.transition to @topic.farewell
-			escalate: @utils.transition to @topic.escalation
+			new_question: @utils.transition to @subagent.agent_router
+			end_conversation: @utils.transition to @subagent.farewell
+			escalate: @utils.transition to @subagent.escalation
 
-topic farewell:
+subagent farewell:
 	label: "Farewell"
 	description: "Ends the conversation politely"
 
@@ -88,7 +88,7 @@ topic farewell:
 			| Wish them a great day.
 			| Let them know they can return anytime for more help.
 
-topic escalation:
+subagent escalation:
 	label: "Escalation"
 	description: "Handles requests to speak with a human agent"
 

package/skills/developing-agentforce/assets/agents/simple-qa.agent

@@ -35,8 +35,8 @@ language:
 	additional_locales: ""
 	all_additional_locales: False
 
-start_agent topic_selector:
-	label: "Topic Selector"
+start_agent agent_router:
+	label: "Subagent Router"
 	description: "Routes incoming requests to the Q&A handler"
 
 	reasoning:
@@ -44,10 +44,10 @@ start_agent topic_selector:
 			| Listen to the user's question.
 			| Route to the Q&A handler for processing.
 		actions:
-			handle_question: @utils.transition to @topic.qa_handler
-			end_conversation: @utils.transition to @topic.farewell
+			handle_question: @utils.transition to @subagent.qa_handler
+			end_conversation: @utils.transition to @subagent.farewell
 
-topic qa_handler:
+subagent qa_handler:
 	label: "Q&A Handler"
 	description: "Handles questions and provides answers"
 
@@ -58,10 +58,10 @@ topic qa_handler:
 			| Keep responses clear and easy to understand.
 			| If you need more information, ask clarifying questions.
 		actions:
-			new_question: @utils.transition to @topic.topic_selector
-			end_conversation: @utils.transition to @topic.farewell
+			new_question: @utils.transition to @subagent.agent_router
+			end_conversation: @utils.transition to @subagent.farewell
 
-topic farewell:
+subagent farewell:
 	label: "Farewell"
 	description: "Ends the conversation gracefully"
 

package/skills/developing-agentforce/assets/agents/verification-gate.agent

@@ -1,7 +1,7 @@
 # Verification Gate Architecture Template
 # ========================================
 #
-# Users must pass identity verification before accessing protected topics.
+# Users must pass identity verification before accessing protected subagents.
 #
 # Pattern: Security gate before protected functionality.
 # Use when: Handling sensitive data, payments, PII access.
@@ -58,26 +58,26 @@ language:
 	additional_locales: ""
 	all_additional_locales: False
 
-start_agent topic_selector:
+start_agent agent_router:
 	description: "Route through identity verification"
 	reasoning:
 		instructions: |
 			You are a router only. Do NOT answer questions or provide help directly.
 			Route all users to identity verification first.
-			If already verified, route to the appropriate topic:
+			If already verified, route to the appropriate subagent:
 			- Account questions -> use to_account
 			- Refund requests -> use to_refund
 		actions:
-			to_verify: @utils.transition to @topic.identity_verification
+			to_verify: @utils.transition to @subagent.identity_verification
 				description: "Begin identity verification"
-			to_account: @utils.transition to @topic.account_management
+			to_account: @utils.transition to @subagent.account_management
 				description: "Access account settings"
 				available when @variables.customer_verified == True
-			to_refund: @utils.transition to @topic.refund_processor
+			to_refund: @utils.transition to @subagent.refund_processor
 				description: "Process a refund request"
 				available when @variables.customer_verified == True
 
-topic identity_verification:
+subagent identity_verification:
 	label: "Identity Verification"
 	description: "Verify customer identity before proceeding"
 
@@ -96,7 +96,7 @@ topic identity_verification:
 		instructions: ->
 			if @variables.failed_attempts >= 3:
 				| Too many failed attempts. Transferring to a human agent.
-				transition to @topic.escalation
+				transition to @subagent.escalation
 
 			if @variables.customer_verified == True:
 				| Identity verified! How can I help you today?
@@ -110,18 +110,18 @@ topic identity_verification:
 				with email = ...
 				set @variables.customer_verified = @outputs.verified
 
-			go_to_account: @utils.transition to @topic.account_management
+			go_to_account: @utils.transition to @subagent.account_management
 				description: "Access account settings"
 				available when @variables.customer_verified == True
 
-			go_to_refund: @utils.transition to @topic.refund_processor
+			go_to_refund: @utils.transition to @subagent.refund_processor
 				description: "Process a refund request"
 				available when @variables.customer_verified == True
 
 			escalate_now: @utils.escalate
 				description: "Transfer to human agent"
 
-topic account_management:
+subagent account_management:
 	label: "Account Management"
 	description: "Manage customer account settings (requires verification)"
 
@@ -151,7 +151,7 @@ topic account_management:
 	reasoning:
 		instructions: ->
 			if @variables.customer_verified == False:
-				transition to @topic.identity_verification
+				transition to @subagent.identity_verification
 
 			| Welcome to account management.
 			| What would you like to do with your account?
@@ -169,10 +169,10 @@ topic account_management:
 				with pref_value = ...
 				available when @variables.customer_verified == True
 
-			back: @utils.transition to @topic.topic_selector
+			back: @utils.transition to @subagent.agent_router
 				description: "Return to main menu"
 
-topic refund_processor:
+subagent refund_processor:
 	label: "Refund Processor"
 	description: "Process refund requests (requires verification)"
 
@@ -225,13 +225,13 @@ topic refund_processor:
 	reasoning:
 		instructions: ->
 			if @variables.customer_verified == False:
-				transition to @topic.identity_verification
+				transition to @subagent.identity_verification
 
 			if @variables.refund_status == "Approved":
 				run @actions.create_crm_case
 					with customer_id = @variables.ContactId
 					with refund_amount = @variables.refund_amount
-				transition to @topic.success_confirmation
+				transition to @subagent.success_confirmation
 
 			run @actions.check_churn_risk
 				with customer_id = @variables.ContactId
@@ -257,7 +257,7 @@ topic refund_processor:
 				with amount = 10
 				set @variables.refund_status = @outputs.status
 
-topic success_confirmation:
+subagent success_confirmation:
 	label: "Success Confirmation"
 	description: "Confirm successful operation"
 	reasoning:
@@ -265,10 +265,10 @@ topic success_confirmation:
 			Great news! Your request has been processed successfully.
 			Is there anything else I can help you with?
 		actions:
-			new_request: @utils.transition to @topic.topic_selector
+			new_request: @utils.transition to @subagent.agent_router
 				description: "Start a new request"
 
-topic escalation:
+subagent escalation:
 	label: "Escalation"
 	description: "Escalate to human agent"
 	reasoning:

package/skills/developing-agentforce/assets/components/apex-action.agent

@@ -1,15 +1,15 @@
 # Apex-Based Action Template
 # Define an action that calls a Salesforce Apex @InvocableMethod
-# This is a PARTIAL template - define actions inside a topic block
+# This is a PARTIAL template - define actions inside a subagent block
 #
 # Usage: Replace {{placeholders}} with your values
-# Place this inside a topic's actions: block
+# Place this inside a subagent's actions: block
 #
 # ⚠️ The target format is apex://ClassName (NOT ClassName.MethodName)
 #    The runtime auto-discovers the @InvocableMethod on the class.
 # ⚠️ NO GenAiFunction metadata needed for AiAuthoringBundle (Agent Script).
 
-# Action Definition (place inside topic's actions: block)
+# Action Definition (place inside subagent's actions: block)
 {{action_name}}:
 	description: "{{ActionDescription}}"
 	inputs:

package/skills/developing-agentforce/assets/components/error-handling.agent

@@ -1,13 +1,13 @@
-# Error Handling Topic Template
-# A topic with validation and guard clauses for critical operations
+# Error Handling Subagent Template
+# A subagent with validation and guard clauses for critical operations
 # This is a PARTIAL template - use within a complete agent file
 #
 # Usage: Replace {{placeholders}} with your values
 # Note: Includes validation patterns and error handling
 
-topic {{topic_name}}:
-	label: "{{TopicLabel}}"
-	description: "{{TopicDescription}} - includes validation and error handling"
+subagent {{subagent_name}}:
+	label: "{{SubagentLabel}}"
+	description: "{{SubagentDescription}} - includes validation and error handling"
 
 	actions:
 		{{action_name}}:
@@ -52,7 +52,7 @@ topic {{topic_name}}:
 				available when @variables.validation_passed == True
 
 			# Handle errors
-			retry_operation: @utils.transition to @topic.{{topic_name}}
+			retry_operation: @utils.transition to @subagent.{{subagent_name}}
 				available when @variables.operation_success == False
 
-			back_to_menu: @utils.transition to @topic.topic_selector
+			back_to_menu: @utils.transition to @subagent.agent_router

package/skills/developing-agentforce/assets/components/escalation-setup.agent

@@ -9,7 +9,7 @@
 # ★ Key Components:
 #   1. connection messaging: block - defines routing destination
 #   2. @utils.escalate action - triggers the transfer
-#   3. escalation topic - handles the handoff flow
+#   3. escalation subagent - handles the handoff flow
 #
 # ★ Prerequisites:
 #   - Omni-Channel configured in Salesforce
@@ -46,7 +46,7 @@ variables:
 	escalation_requested: mutable boolean = False
 		description: "Whether customer requested human agent"
 	escalation_reason: mutable string
-		description: "Reason for escalation"
+		description: "Reason for escalation subagent"
 	# ⚠️ Use 'number' not 'integer' - integer type is NOT supported in AiAuthoringBundle
 	attempts_before_escalation: mutable number = 0
 		description: "Number of attempts before escalating"
@@ -83,9 +83,9 @@ connection messaging:
 #       adaptive_response_allowed: False
 
 # Entry point
-start_agent topic_selector:
-	label: "Topic Selector"
-	description: "Routes users to appropriate topics based on intent"
+start_agent agent_router:
+	label: "Subagent Router"
+	description: "Routes users to appropriate subagents based on intent"
 
 	reasoning:
 		instructions: ->
@@ -93,11 +93,11 @@ start_agent topic_selector:
 			| If they ask for a human or live agent, route to escalation.
 			| Otherwise, try to help them directly.
 		actions:
-			go_help: @utils.transition to @topic.help
-			go_escalation: @utils.transition to @topic.escalation
+			go_help: @utils.transition to @subagent.help
+			go_escalation: @utils.transition to @subagent.escalation
 				available when @variables.escalation_requested == True
 
-topic help:
+subagent help:
 	label: "Help"
 	description: "Provides assistance to customers"
 
@@ -117,11 +117,11 @@ topic help:
 			| Track escalation reason if provided:
 			set @variables.escalation_reason = ...
 		actions:
-			offer_escalation: @utils.transition to @topic.escalation
+			offer_escalation: @utils.transition to @subagent.escalation
 
-			immediate_escalation: @utils.transition to @topic.escalation
+			immediate_escalation: @utils.transition to @subagent.escalation
 
-topic escalation:
+subagent escalation:
 	label: "Escalation"
 	description: "Transfers conversation to human agent"
 

package/skills/developing-agentforce/assets/components/flow-action.agent

@@ -1,19 +1,19 @@
 # Flow-Based Action Template
 # Define an action that calls a Salesforce Flow
-# This is a PARTIAL template - define actions inside a topic block
+# This is a PARTIAL template - define actions inside a subagent block
 #
 # ⚠️ NOTE ON DEPLOYMENT METHODS:
 #    - AiAuthoringBundle: `with`/`set` clauses ARE supported (TDD validated v1.7.0+)
 #    - GenAiPlannerBundle: Full syntax including `with`/`set` also supported
 #
 # Both deployment methods support the Two-Level Action System:
-#   Level 1: Action definition in topic `actions:` block (with target/inputs/outputs)
+#   Level 1: Action definition in subagent `actions:` block (with target/inputs/outputs)
 #   Level 2: Action invocation in `reasoning.actions:` block (with `with`/`set` clauses)
 #
 # Usage: Replace {{placeholders}} with your values
-# Place this inside a topic's actions: block
+# Place this inside a subagent's actions: block
 
-# Action Definition (place inside topic's actions: block)
+# Action Definition (place inside subagent's actions: block)
 {{action_name}}:
 	description: "{{ActionDescription}}"
 	inputs:
@@ -54,7 +54,7 @@
 #       | Help the user with their request.
 #       | Use the available actions when needed.
 #    actions:
-#       back_to_menu: @utils.transition to @topic.topic_selector
+#       back_to_menu: @utils.transition to @subagent.agent_router
 
 # Common Flow Target Patterns:
 # - flow://Get_Account_Details

package/skills/developing-agentforce/assets/components/n-ary-conditions.agent

@@ -23,15 +23,15 @@
 # ═══════════════════════════════════════════════════════════════
 
 # Example: Require multiple authentication checks
-topic secure_action:
+subagent secure_action:
 	label: "Secure Action"
 	description: "Performs security-sensitive operations"
 
 	before_reasoning:
 		# All three conditions must be true
 		if @variables.is_authenticated and @variables.has_permission and @variables.session_valid:
-			transition to @topic.authorized_action
-		# Otherwise stay in this topic
+			transition to @subagent.authorized_action
+		# Otherwise stay in this subagent
 
 	reasoning:
 		instructions: ->
@@ -42,22 +42,22 @@ topic secure_action:
 # ═══════════════════════════════════════════════════════════════
 
 # Example: Any elevated role gets access
-topic admin_panel:
+subagent admin_panel:
 	label: "Admin Panel"
 	description: "Administrative features"
 
 	before_reasoning:
 		# Any one of these roles grants access
 		if @variables.is_admin or @variables.is_moderator or @variables.is_superuser:
-			transition to @topic.admin_features
+			transition to @subagent.admin_features
 		# Non-admins redirected
-		transition to @topic.access_denied
+		transition to @subagent.access_denied
 
 # ═══════════════════════════════════════════════════════════════
 # PATTERN 3: N-ary conditions in available when
 # ═══════════════════════════════════════════════════════════════
 
-topic order_management:
+subagent order_management:
 	label: "Order Management"
 	description: "Handles order operations"
 
@@ -84,14 +84,14 @@ topic order_management:
 # PATTERN 4: Complex grouped conditions
 # ═══════════════════════════════════════════════════════════════
 
-topic smart_routing:
+subagent smart_routing:
 	label: "Smart Routing"
 	description: "Routes based on complex criteria"
 
 	before_reasoning:
 		# Premium with any product type OR standard with warranty
 		if (@variables.tier == "premium" and @variables.product_type != None) or (@variables.tier == "standard" and @variables.has_warranty == True):
-			transition to @topic.priority_support
+			transition to @subagent.priority_support
 
 # ═══════════════════════════════════════════════════════════════
 # ANTI-PATTERNS - DO NOT USE
@@ -102,9 +102,9 @@ topic smart_routing:
 #    if @variables.a == True:
 #       if @variables.b == True:
 #          if @variables.c == True:
-#             transition to @topic.x
+#             transition to @subagent.x
 
 # ✅ CORRECT - Flat N-ary condition
 # before_reasoning:
 #    if @variables.a == True and @variables.b == True and @variables.c == True:
-#       transition to @topic.x
+#       transition to @subagent.x

package/skills/developing-agentforce/assets/components/{topic-with-actions.agent → subagent-with-actions.agent}

@@ -1,18 +1,18 @@
-# Topic with Actions Template
-# A topic that integrates with external systems via Flow or Apex actions
+# Subagent with Actions Template
+# A subagent that integrates with external systems via Flow or Apex actions
 # This is a PARTIAL template - use within a complete agent file
 #
 # Two-Level Action System:
-#   Level 1: topic.actions block DEFINES actions (with target:, inputs:, outputs:)
+#   Level 1: subagent.actions block DEFINES actions (with target:, inputs:, outputs:)
 #   Level 2: reasoning.actions block INVOKES them (with @actions.name, with/set)
 #
 # Usage: Replace {{placeholders}} with your values
-# Note: Actions defined inside topic are local to that topic
+# Note: Actions defined inside subagent are local to that subagent
 
-topic {{topic_name}}:
-	description: "{{TopicDescription}}"
+subagent {{subagent_name}}:
+	description: "{{SubagentDescription}}"
 
-	# Level 1: DEFINE actions available to this topic
+	# Level 1: DEFINE actions available to this subagent
 	actions:
 		{{action_name}}:
 			description: "{{ActionDescription}}"
@@ -26,7 +26,7 @@ topic {{topic_name}}:
 
 	reasoning:
 		instructions: ->
-			| {{TopicInstructions}}
+			| {{SubagentInstructions}}
 			| Use the available actions to help the user.
 			| Capture and communicate results clearly.
 
@@ -36,5 +36,5 @@ topic {{topic_name}}:
 				with {{input_name}}=...
 				set @variables.{{result_variable}} = @outputs.{{output_name}}
 
-			back_to_menu: @utils.transition to @topic.topic_selector
+			back_to_menu: @utils.transition to @subagent.agent_router
 				description: "Return to main menu"

package/skills/developing-agentforce/assets/deterministic-routing.agent

@@ -40,7 +40,7 @@ variables:
    low_confidence_warning: mutable boolean = False
       description: "Flag for low confidence routing"
 
-start_agent topic_selector:
+start_agent agent_router:
    description: "Classify intent and route deterministically"
    reasoning:
       instructions: ->
@@ -54,13 +54,13 @@ start_agent topic_selector:
             # HIGH-CONFIDENCE ROUTING
             if @variables.confidence_score >= 80:
                if @variables.classified_intent == "billing":
-                  transition to @topic.billing
+                  transition to @subagent.billing
                if @variables.classified_intent == "technical_support":
-                  transition to @topic.technical_support
+                  transition to @subagent.technical_support
                if @variables.classified_intent == "sales":
-                  transition to @topic.sales
+                  transition to @subagent.sales
                if @variables.classified_intent == "returns":
-                  transition to @topic.returns
+                  transition to @subagent.returns
 
             # LOW-CONFIDENCE: Confirm with user
             if @variables.confidence_score < 80:
@@ -69,7 +69,7 @@ start_agent topic_selector:
                | It sounds like you need help with **{!@variables.classified_intent}**.
                | Is that correct?
 
-         # INITIAL STATE: Ask for help topic
+         # INITIAL STATE: Ask for help subject
          if @variables.needs_classification == True:
             | I can help with billing, technical support, sales, or returns.
             | What do you need help with today?
@@ -88,19 +88,19 @@ start_agent topic_selector:
             set @variables.needs_classification = False
 
          # Manual routing for low-confidence cases
-         go_billing: @utils.transition to @topic.billing
+         go_billing: @utils.transition to @subagent.billing
             description: "Yes, I need billing help"
             available when @variables.low_confidence_warning == True and @variables.classified_intent == "billing"
 
-         go_support: @utils.transition to @topic.technical_support
+         go_support: @utils.transition to @subagent.technical_support
             description: "Yes, I need technical support"
             available when @variables.low_confidence_warning == True and @variables.classified_intent == "technical_support"
 
-         go_sales: @utils.transition to @topic.sales
+         go_sales: @utils.transition to @subagent.sales
             description: "Yes, I need sales help"
             available when @variables.low_confidence_warning == True and @variables.classified_intent == "sales"
 
-         go_returns: @utils.transition to @topic.returns
+         go_returns: @utils.transition to @subagent.returns
             description: "Yes, I need returns help"
             available when @variables.low_confidence_warning == True and @variables.classified_intent == "returns"
 
@@ -114,53 +114,53 @@ start_agent topic_selector:
             with low_confidence_warning = False
 
 # ============================================================
-# ROUTED TOPICS
+# ROUTED SUBAGENTS
 # ============================================================
 
-topic billing:
+subagent billing:
    description: "Handle billing inquiries"
    reasoning:
       instructions: |
          Help the customer with their billing question.
          You can view invoices, explain charges, or process payments.
       actions:
-         back: @utils.transition to @topic.topic_selector
+         back: @utils.transition to @subagent.agent_router
             description: "Return to main menu"
          escalate_now: @utils.escalate
             description: "Transfer to billing specialist"
 
-topic technical_support:
+subagent technical_support:
    description: "Handle technical support issues"
    reasoning:
       instructions: |
          Help the customer with their technical issue.
          Troubleshoot problems and provide solutions.
       actions:
-         back: @utils.transition to @topic.topic_selector
+         back: @utils.transition to @subagent.agent_router
             description: "Return to main menu"
          escalate_now: @utils.escalate
             description: "Transfer to technical specialist"
 
-topic sales:
+subagent sales:
    description: "Handle sales inquiries"
    reasoning:
       instructions: |
          Help the customer with sales questions.
          Provide product information and pricing.
       actions:
-         back: @utils.transition to @topic.topic_selector
+         back: @utils.transition to @subagent.agent_router
             description: "Return to main menu"
          escalate_now: @utils.escalate
             description: "Transfer to sales representative"
 
-topic returns:
+subagent returns:
    description: "Handle return requests"
    reasoning:
       instructions: |
          Help the customer with their return request.
          Check eligibility and process returns.
       actions:
-         back: @utils.transition to @topic.topic_selector
+         back: @utils.transition to @subagent.agent_router
             description: "Return to main menu"
          escalate_now: @utils.escalate
             description: "Transfer to returns specialist"