mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-07-30 11:43:26 +08:00
df3467f20b
Aligns with Agent Script v2 naming standards where `topic` is renamed to `subagent` across all skill documentation and templates. Changes: - Agent Script templates: topic keyword → subagent keyword - References: @topic.* → @subagent.* - Documentation: Updated all skill references and guides - Natural language references preserved in comments/descriptions
82 lines
3.1 KiB
Plaintext
82 lines
3.1 KiB
Plaintext
# Single-Topic Agent Template
|
|
# Copy this file to your AiAuthoringBundle directory and rename it to match
|
|
# your agent's developer_name. Replace all placeholder values with real ones.
|
|
|
|
system:
|
|
instructions: "You are a helpful assistant. Describe the agent's persona and purpose here."
|
|
messages:
|
|
welcome: "Hello! How can I help you today?"
|
|
error: "Sorry, it looks like something has gone wrong."
|
|
|
|
config:
|
|
developer_name: "Agent_API_Name"
|
|
agent_label: "Agent Display Name"
|
|
description: "Description of the agent's purpose"
|
|
# agent_type: "AgentforceServiceAgent" for customer-facing (requires default_agent_user)
|
|
# "AgentforceEmployeeAgent" for internal (remove default_agent_user line)
|
|
agent_type: "AgentforceServiceAgent"
|
|
default_agent_user: "username@identifier.org"
|
|
|
|
language:
|
|
default_locale: "en_US"
|
|
additional_locales: ""
|
|
all_additional_locales: False
|
|
|
|
start_agent topic_selector:
|
|
description: "Welcome the user and determine the appropriate topic based on user input"
|
|
reasoning:
|
|
actions:
|
|
go_to_main: @utils.transition to @subagent.main
|
|
go_to_escalation: @utils.transition to @subagent.escalation
|
|
go_to_off_topic: @utils.transition to @subagent.off_topic
|
|
|
|
subagent main:
|
|
label: "Main Topic"
|
|
description: "Describe what this topic handles. The Atlas Reasoning Engine matches user utterances against this description."
|
|
|
|
reasoning:
|
|
instructions: ->
|
|
| Replace this with instructions for how the agent should handle requests in this topic.
|
|
Reference actions with the syntax shown below.
|
|
|
|
actions:
|
|
do_action: @actions.do_action
|
|
with input_param = ...
|
|
|
|
actions:
|
|
do_action:
|
|
description: "Describe what this action does"
|
|
label: "Action Display Name"
|
|
target: "apex://ClassName"
|
|
inputs:
|
|
input_param: string
|
|
description: "Describe this parameter"
|
|
label: "Parameter Display Name"
|
|
is_required: True
|
|
outputs:
|
|
output_field: string
|
|
label: "Output Display Name"
|
|
description: "Describe this output"
|
|
is_displayable: True
|
|
filter_from_agent: False
|
|
|
|
subagent escalation:
|
|
label: "Escalation"
|
|
description: "Handles requests from users who want to transfer or escalate their conversation to a live human agent."
|
|
|
|
reasoning:
|
|
instructions: ->
|
|
| If a user explicitly asks to transfer to a live agent, escalate the conversation.
|
|
actions:
|
|
escalate_to_human: @utils.escalate
|
|
description: "Escalate to a human agent."
|
|
|
|
subagent off_topic:
|
|
label: "Off Topic"
|
|
description: "Redirect conversation to relevant topics when user request goes off-topic"
|
|
|
|
reasoning:
|
|
instructions: ->
|
|
| The user request is off-topic. Do not answer general knowledge questions.
|
|
Redirect the conversation by asking how you can help with topics this agent supports.
|