AgentX Support - パラメーター
パラメーターには、AIエージェントとの会話中に収集または生成された情報が保存されます。 エージェントはこれらのパラメーターを使用して、会話を進行し、応答をパーソナライズし、自動化されたアクションを有効にします。
たとえば、ユーザーが組織への問い合わせ理由としてSupportを選択した場合、エージェントはその選択をパラメーターに保存し、フローの後半で意思決定の指針として使用できます。
ノードへのパラメーターの割り当て
会話フロービルダーでパラメーターを作成して割り当てることができます。 パラメーターは通常、ユーザーが特定のノードに到達したときに割り当てられます。
会話フロービルダーでノードにパラメーターを割り当てるには、次の手順を実行します。
ノードを選択します。
追加設定セクションを見つけます。
パラメータの割り当ての横にある編集をクリックします。
ノードにパラメーターを割り当てる
パラメーターを追加または更新します。
パラメーターの割り当て
パラメーターはノードの評価後に割り当てられ、後続のステップで使用できるようになります。
パラメーター値のタイプ
パラメーターには、次のタイプの値を割り当てることができます。
固定値
固定値を使用すると、定義済みの値またはシステムデータを使用してパラメーターを設定できます。
| パラメーター | 説明 |
|---|---|
$sys_transcript | この時点までの会話のトランスクリプトを保存します。 |
$sys_outgoing_transition | 質問ノードからユーザーの選択をパラメータに取り込みます。 |
$a.b.c | 会話コンテキストからネストされたパラメーター値をコピーします。これはネストされたJSON応答に役立ちます。 |
<Any Text Value> | カスタムテキスト値をパラメーターに保存し、会話全体で使用できるようにします。 |
アクションパラメーター
アクションパラメーターを使用すると、フロー実行中に実行する特定のアクションを定義できます。 これらは、パラメーターのプロパティとして機能する値を持つ固定値パラメーターです。
| パラメーター | 説明 |
|---|---|
__action_delay | 次のノードへの遷移を遅延させる秒数。 最大は15秒です。 |
定義済みパラメーター
AgentX Supportには、フロー設定を簡素化するための定義済みパラメーターがいくつか用意されています。
| パラメーター | 説明 |
|---|---|
__sys_userIp | ユーザーのIPアドレス。 |
__sys_userAgent | ブラウザーのユーザーエージェント文字列。 |
__sys_userAgentParsed | ユーザーエージェントの解析済み表現。 |
__sys_userCountry | Cloudflareによって識別されたユーザーの国。 |
__sys_conversationId | 一意の会話ID。 |
__sys_userAction | ユーザーが最後に実行したアクション。 |
__sys_channel | 会話に使用される通信チャネル。 |
__sys_activeIntent | 会話内で現在アクティブなインテント。 |
browser_path | AIエージェントが読み込まれたURLパス。 |
browser_hostname | ブラウザーのホスト名。 |
browser_referrer | Webページの参照元URL。 |
browser_isMobile | ユーザーがモバイルデバイスを使用しているかどうかを示します。 |
式
式を使用すると、データを変換し、その結果をパラメーターに保存できます。 これは、算術演算、文字列操作、または組み込みのプラットフォーム関数の使用などの操作に役立ちます。
演算子
会話パラメーターでは、次の演算子を使用できます。
| Operator | 説明 |
|---|---|
+ | 加算（x + y）または文字列連結（firstName + ' ' + lastName） |
- | 減算（x - y） |
/ | 除算（x / y） |
* | 乗算（x * y） |
** | べき乗（x ** y） |
% | 剰余（余り）（x % y） |
== | 等価比較（x == y） |
< | より小さい比較（x < y） |
> | より大きい比較（x > y） |
<= | 以下（x <= y） |
>= | 以上（x >= y） |
in | あるものが別のものに含まれているかどうかを確認（"spam" in "my breakfast"） |
ユーティリティ関数
パラメーターに対してさまざまな操作を実行するためのユーティリティ関数を使用できます。
| 機能 | 説明 |
|---|---|
DOUBLE | パラメーターを浮動小数点型に変換します。 |
MD5 | パラメーターのMD5ハッシュを生成します。 |
INT | パラメーターを整数型に変換します。 |
STR | パラメーターを文字列型に変換します。 |
SORT_LIST | 値のリストを昇順で並べ替えます。 |
REVERSE_LIST | 値のリストの順序を逆にします。 |
APPEND_LIST | リストに値を追加します。 |
SUBSTITUTE | 文字列の一部を置換します。 例：SUBSTITUTE(param1, '-', '_')。 |
FORMAT_DATE | 日付を書式設定します。 例：FORMAT_DATE(param1, <date_format>)。 日付形式については、strftimeを参照してください。 |
REGEX_EXTRACT | 正規表現を使用して部分文字列を抽出します。 例：REGEX_EXTRACT(param1, <pattern>)。 |
SPLIT_PART | 文字列を複数の部分に分割します。 例：SPLIT_PART('Alex Workato', ' ', 1)は"Workato"を抽出します。 |
CURRENT_DATE_BETWEEN | 現在の日付が指定された2つの日付またはタイムスタンプの間にあるかどうかを確認します。 |
未設定のパラメーター
未設定のパラメーターは、固定値または定義済みの値を持たないプレースホルダーです。 このパラメータータイプは、会話中のユーザーのコンテキストに基づいて動的に設定されます。
未設定のパラメーター
メッセージでのパラメーターの使用
テンプレートを使用して、メッセージ内でパラメーターを参照できます。 たとえば、AIエージェントがユーザーの名を収集してfirstNameというパラメーターに保存する場合、質問ノードを使用して次のメッセージを表示できます。
Hi, {{ firstName }}. How can I help you today?Last updated: