1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

config:
  developer_name: "Customer_Support_Agent"
  agent_label:    "Customer Support Agent"

system:
  instructions: |
    あなたはカスタマーサポートエージェントです。
  messages:
    welcome: "カスタマーサポートへようこそ。どのようなご用件でしょうか？"  # 必須
    error:   "申し訳ありません。システムエラーが発生しました。"           # 必須

variables:
  inquiry_category: mutable string = ""
  order_id:         mutable string = ""

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# ✅ 正しい書き方 — reasoning.actions 内でアクション名に直接参照
reasoning:
  actions:
    set_classify_inquiry: @utils.setVariables
      description: "カテゴリをセット"
      with inquiry_category: ...      # with で変数に直接セットされる

# ❌ 誤り — topic.actions に @utils.setVariables は定義できない
topic order_inquiry:
  actions:
    set_var:
      target: "@utils.setVariables"   # コンパイルエラー

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# ❌ 誤り — reasoning.instructions の -> は LLM 実行前なので変数がまだ空
reasoning:
  instructions:->
    if @variables.inquiry_category == "ORDER":
      transition to @topic.order_inquiry    # 変数未設定のため発火しない

# ✅ 正しい書き方 — LLM 推論完了後に実行される after_reasoning:->
after_reasoning:->                          # -> の付け忘れはコンパイルエラー
  if @variables.inquiry_category == "ORDER":
    transition to @topic.order_inquiry      # LLM が変数をセット済みのタイミング
  if @variables.inquiry_category == "RETURN":   # else if は非対応 → sequential な if
    transition to @topic.return_inquiry
  if @variables.inquiry_category == "OTHER":
    transition to @topic.general_support

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# ✅ | プロンプトテキスト内 — {!@variables.xxx} が使える
reasoning:
  instructions:->
    if @variables.order_id != "":
      | 注文番号 {!@variables.order_id} の情報を確認しました。

# ✅ -> コードブロック内（with 句など） — @variables.xxx を直接書く
actions:
  get_order: @actions.search_order
    with order_id=@variables.order_id      # テンプレート式ではなく直接参照

# ❌ 誤り — -> ブロック内で {!...} を使うと構文エラー
  get_order: @actions.search_order
    with order_id={!@variables.order_id}   # 構文エラー

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

# カスタマーサポート対応 Agent Script
# ファイルパス: force-app/main/aiAuthoringBundles/CustomerSupport/CustomerSupport.agent

config:
  developer_name: "Customer_Support_Agent"
  agent_label: "Customer Support Agent"
  description: "カスタマーサポートの問い合わせを受け付け、クローズまで標準化するエージェント"

system:
  instructions: |
    あなたはカスタマーサポートエージェントです。
    お客様の問い合わせに丁寧かつ正確に対応してください。
  messages:
    welcome: "カスタマーサポートへようこそ。どのようなご用件でしょうか？"
    error: "申し訳ありません。システムエラーが発生しました。しばらくお待ちください。"

variables:
  inquiry_category: mutable string = ""   # ORDER / RETURN / OTHER
  order_id:         mutable string = ""
  order_details:    mutable string = ""
  product_name:     mutable string = ""
  return_reason:    mutable string = ""
  within_period:    mutable boolean = False

start_agent:
  description: "問い合わせ内容を分類し、適切なトピックへ遷移する"

  reasoning:
    instructions:->
      if @variables.inquiry_category == "":
        | ユーザーの問い合わせ内容を確認し、以下のいずれかに分類してください。
        |   ORDER  : 注文・配送に関する問い合わせ
        |   RETURN : 返品・交換に関する問い合わせ
        |   OTHER  : その他
        | 分類が決まったら set_classify_inquiry を使って inquiry_category を設定してください。

    actions:
      set_classify_inquiry: @utils.setVariables
        description: "問い合わせカテゴリを ORDER / RETURN / OTHER のいずれかにセットします"
        with inquiry_category: ...

  after_reasoning:->
    if @variables.inquiry_category == "ORDER":
      transition to @topic.order_inquiry
    if @variables.inquiry_category == "RETURN":
      transition to @topic.return_inquiry
    if @variables.inquiry_category == "OTHER":
      transition to @topic.general_support

topic order_inquiry:
  description: "注文番号を収集し、注文レコードを検索して対応案を提示する"

  actions:
    search_order:
      description: "注文番号でレコードを検索する"
      inputs:
        order_id: string
          description: "検索対象の注文番号"
      outputs:
        order_details: string
          description: "注文の詳細情報"
      target: "flow://Search_Order_Flow"
    close_case:
      description: "ケースをクローズする"
      target: "flow://Close_Case_Flow"

  reasoning:
    instructions:->
      if @variables.order_id == "":
        | 注文番号・注文日・問題の内容（未着 / 破損 / 誤品）をお知らせください。
      if @variables.order_id != "":
        | 注文情報を確認しました。検索結果をもとに適切な解決案をご提案します。

    actions:
      collect_order: @utils.setVariables
        description: "注文番号をユーザーから収集して変数にセットする"
        available when @variables.order_id == ""
        with order_id: ...

      get_order: @actions.search_order
        available when @variables.order_id != ""
        with order_id=@variables.order_id
        set @variables.order_details = @outputs.order_details

  after_reasoning:->
    | 検索結果をもとに、適切な解決案（再配送 / 返金など）を提示してください。
    | 対応完了後、他にお困りの点がないか確認し、問題がなければケースをクローズしてください。

topic return_inquiry:
  description: "返品情報を収集し、ポリシー確認後に対応案を提示する"

  actions:
    check_return_policy:
      description: "返品受付期間内かを確認する"
      inputs:
        product_name: string
          description: "返品対象の商品名"
      outputs:
        within_period: boolean
          description: "返品受付期間内であれば True"
      target: "flow://Check_Return_Policy_Flow"
    close_case:
      description: "ケースをクローズする"
      target: "flow://Close_Case_Flow"

  reasoning:
    instructions:->
      if @variables.product_name == "":
        | 注文番号・返品希望の商品名・返品理由（商品不良 / イメージ違い / 誤注文）をお知らせください。

    actions:
      collect_return: @utils.setVariables
        description: "返品に必要な商品名・返品理由を収集して変数にセットする"
        available when @variables.product_name == ""
        with product_name: ...
        with return_reason: ...

      policy_check: @actions.check_return_policy
        available when @variables.product_name != "" and @variables.return_reason != ""
        with product_name=@variables.product_name
        set @variables.within_period = @outputs.within_period

  after_reasoning:->
    if @variables.within_period == True:
      | 返品受付期間内です。返品手続きの案内をしてください。
    if @variables.within_period == False and @variables.product_name != "":
      | 返品受付期間を超えています。お客様に丁寧にお伝えし、
      | 例外対応の可否を確認するため、上位サポートへのエスカレーションを案内してください。

topic general_support:
  description: "フロー定義外の問い合わせを AI が自律的に対応する"

  actions:
    close_case:
      description: "ケースをクローズする"
      target: "flow://Close_Case_Flow"

  reasoning:
    instructions: |
      お客様の問い合わせ内容に対して、適切な回答をしてください。
      解決できない場合は有人サポートへのエスカレーションを案内してください。
      対応完了後、他にお困りの点がないか確認し、問題がなければケースをクローズしてください。

    actions:
      finish: @actions.close_case
        description: "問題が解決し、お客様の確認が取れたらケースをクローズする"