Agentic Journey でジャーニーを作成し、キャンバスでオーケストレーションを行い、公開してオンラインにし、公開後に管理します。
Agentic Journey の仕組み
Agentic Journey の使用には、4 つのステップが含まれます。
ジャーニーの作成：トリガータイプと作成方法を選択し、ジャーニーの基本情報を設定します。
キャンバスのオーケストレーション：AI モードまたはパラメーターモードでジャーニーをオーケストレーションし、コンポーネントとビジネスロジックを設定します。
公開：ジャーニーを保存および公開してバージョン番号を生成し、ジャーニーをオンラインにします。
ジャーニーの管理：ジャーニーの編集、オンライン/オフラインの切り替え、削除、およびバージョンの管理を行います。
前提条件
Alibaba Cloud アカウントの登録と企業実名認証が完了していること。
Chat App Message Service がアクティベートされていること。
メッセージチャネル (WhatsApp、Viber、Messenger、Instagram、Telegram、LINE、または SMS) を使用するには、事前にメッセージチャネルを設定し、マーチャントアカウントをバインドするか認証する必要があります。
ジャーニーの作成
ジャーニー作成パネルの表示
Chat App Message Service コンソールで、[Solutions] > [Agentic Journey] を選択してジャーニーリストページに移動し、[Create Agentic Journey] をクリックします。
ジャーニー情報の設定
ジャーニー作成パネルで、次の情報を設定します。
ジャーニー名
必須。ジャーニーを識別します。
トリガータイプ
ジャーニーのトリガー方法を選択します。次の表に、サポートされている 4 つのトリガータイプを示します。
トリガータイプ | 説明 | 設定項目 |
API イベントトリガー | OpenAPI の呼び出しによってジャーニーをトリガーします。 | 追加の設定は不要です。ジャーニーを公開すると、システムが呼び出しエントリポイントを生成します。ジャーニーをトリガーするには、TriggerChatFlow API を呼び出します。 |
受信メッセージトリガー | エンドユーザーがメッセージを送信したときにジャーニーをトリガーします。 | [Channel type] (必須)：WhatsApp、Viber、Messenger、Instagram、Telegram、または LINE。[Bound accounts] (オプション)：作成した送信者アカウントを選択します。複数選択が可能です。[WhatsApp merchant numbers] (オプション、WhatsApp 送信者アカウントのみ利用可能)：トリガーする WABA マーチャント番号を選択します。複数選択が可能です。 |
オーディエンスプランのトリガー | オーディエンスプランに基づき、スケジュールに従ってジャーニーをバッチでトリガーします。 | [Audience group] (必須)：オーディエンス管理で作成したグループを選択します。[Effective and expiration dates] (必須)：プランの有効期間を設定します。[Execution plan] (必須)：日次や週次など、トリガーの頻度を設定します。 |
ジャーニー呼び出しトリガー | 別のジャーニーがこのジャーニーを参照したときにトリガーされます。 | 送信者アカウントは不要です。このタイプのジャーニーには独自のトリガーがなく、別のジャーニーからのみ呼び出すことができます。 |
チャネルタイプは選択後に変更できません。他の設定項目は、ジャーニーの編集時に変更できます。
[Journey invocation trigger] タイプのジャーニーだけでなく、どのジャーニーもキャンバス上で他のジャーニーを参照できます。
作成方法
ジャーニーの作成方法を選択します。次の表に、サポートされている 4 つの作成方法を示します。
作成方法 | 説明 | 設定項目 |
AI による作成 | AI との対話を通じてジャーニーを自動的に生成します。 | ジャーニーの作成後、AI モードで開かれます。 |
テンプレートの使用 | プリセットのジャーニーテンプレートから迅速にジャーニーを作成します。 | 現在のトリガータイプに一致するテンプレートを選択します。 |
カスタム | 空白のキャンバスから手動でジャーニーを構築します。 | ジャーニーの作成後、パラメーターモードで開かれます。 |
ジャーニーのインポート | JSON ファイルをインポートしてジャーニーを作成します。 | 別のジャーニーからエクスポートされた JSON ファイルをアップロードします。 |
異なるトリガータイプを選択すると、[Use template] のテンプレートリストが自動的にフィルタリングされ、一致するテンプレートが表示されます。
作成方法によって、編集ページのデフォルトモードが決まります。[AI-powered creation]、[Use template]、および [Import journey] は AI モードで開かれます。[Custom] はパラメーターモードで開かれます。
備考
オプション。ジャーニーの備考を入力します。最大 100 文字まで入力できます。
作成の完了
設定が完了したら、[Confirm] をクリックします。システムによってジャーニー編集ページが開かれます。
キャンバスのオーケストレーション
ジャーニーを作成すると、キャンバスのオーケストレーションページが開かれます。Agentic Journey は、AI モードとパラメーターモードの 2 つのオーケストレーションモードをサポートしています。
AI モード
AI モードは、自然言語による AI との対話を通じて、ジャーニーを自動的に生成および編集します。
スコープ
AI モードには 2 つのスコープがあります。
キャンバス全体：コンポーネントが選択されていない場合、AI は複数のコンポーネントと接続を含む完全なジャーニーを生成できます。
単一コンポーネント：キャンバスでコンポーネントを選択すると、AI はそのコンポーネントのみを変更し、他のコンポーネントは変更しません。
手順
AI モードへの切り替え：右側の設定パネルで、[AI mode] タブをクリックします。
スコープの確認：入力ボックスの上に AI の現在のスコープが表示されます。
コンポーネントが選択されていない場合：
Current scope: Entire canvasコンポーネントが選択されている場合：
Current scope: {component name}。AI は選択されたコンポーネントのみを変更します。
要件の入力：
キャンバス全体：完全なビジネスプロセスを記述します。例：「物流業界向けの荷物追跡および返品プロセスを設計する」。
単一コンポーネント：コンポーネントへの変更を記述します。例：「待機時間を 48 時間に変更する」。
ジャーニーの生成：
AI は複数回の対話を通じて要件を理解し、詳細を明確にするために質問することがあります。
生成が完了すると、キャンバスは自動的に更新されます。
調整の続行：生成後、AI との対話を続けて調整を行うか、パラメーターモードに切り替えて詳細な設定を行います。
入力ボックスは最大 1,000 文字まで入力できます。
AI がジャーニーを生成している間、入力ボックスは淡色表示され使用できなくなり、生成が完了すると再び利用可能になります。
コンポーネントを選択すると、手動で終了するか別のコンポーネントを選択するまで、AI のスコープは維持されます。
クイックテンプレート
初めて AI モードを開くと、3 つのクイックテンプレートボタンが表示されます。
Design a welcome and onboarding process for new users
Design a package tracking and return process for the logistics industry
Design a coupon push process for a marketing campaign
テンプレートをクリックすると、その内容が要件として AI に送信されます。
パラメーターモード
パラメーターモードでは、コンポーネントをキャンバスにドラッグし、そのパラメーターを手動で設定することでジャーニーをオーケストレーションします。
手順
コンポーネントライブラリを開く：左側の [Component library] アイコンをクリックして、利用可能なコンポーネントを表示します。各コンポーネントにはクエスチョンマークアイコンがあります。アイコンをクリックすると、そのコンポーネントのヘルプドキュメントが表示されます。
コンポーネントの追加：
コンポーネントライブラリからキャンバスにコンポーネントをドラッグし、開始コンポーネントと終了コンポーネントの間に配置します。
または、開始コンポーネントと終了コンポーネントの間にある [+] アイコンをクリックして、コンポーネントを選択します。
コンポーネントの設定：
キャンバス上のコンポーネントをクリックします。右側の設定パネルがパラメーターモードに切り替わります。
パラメーターモードタブで、メッセージ内容、条件、待機時間など、コンポーネントのパラメーターを設定します。
詳細については、「Agentic Journey コンポーネントの説明」をご参照ください。
コンポーネントの接続：コンポーネント間の接続は自動的に生成され、実行順序を示します。
ジャーニーの保存：オーケストレーションが完了したら、ページ上部の [保存] アイコンをクリックします。手動保存と自動保存の詳細については、「ジャーニーの保存」をご参照ください。
オーケストレーション中は、データの損失を防ぐために定期的に保存してください。
モードの切り替え
編集中は、いつでも AI モードとパラメーターモードを切り替えることができます。
コンポーネントを選択すると、右側の設定パネルに [AI mode] タブと [Parameter mode] タブの両方が表示されます。
タブをクリックしてモードを切り替えます。
どちらのモードで行った変更も、リアルタイムでキャンバスに同期されます。
公開
ジャーニーの保存
編集中は、いつでもページ上部の [保存] アイコンをクリックして、ジャーニーを手動で保存できます。手動で保存するたびに、操作記録に Manual save エントリが作成され、後でロールバックボタンを使用してこの状態にロールバックできます。
また、システムは 5 分ごとにジャーニーを自動的に保存します。自動保存のエントリには System auto-save というラベルが付けられます。
ジャーニーの公開
新しく作成または編集したジャーニーを公開してオンライン化します。公開が成功するたびに、バージョン番号が生成されます。
公開前チェック：ページ上部の [Publish] をクリックします。システムは次の項目を検証し、いずれかのチェックに失敗した場合、公開操作はブロックされます。
このジャーニーによって参照されるすべてのジャーニーがオンラインであること。参照先のジャーニーがオフラインの場合、ジャーニーを公開することはできません。
参照の深さが 5 階層を超えていないこと。
ジャーニーに循環参照が含まれていないこと。
すべての必須コンポーネントパラメーターが設定されていること。
公開の確認：チェックに合格したら、公開操作を確定します。
バージョン生成：
初回公開：バージョン V1.0 が生成され、ジャーニーステータスが
Onlineに変わります。その後の公開：バージョン番号が V2.0、V3.0 のように増加し、以前のバージョンのステータスは
Offlineに変わります。
自動運用：ジャーニーが公開されると、24時間365日自動的に実行されます。ランタイムデータはジャーニー詳細ページで確認できます。
公開操作が失敗した場合は、「よくある質問」で一般的な原因をご参照ください。
ジャーニーのオンライン/オフライン化
ジャーニーリストページで、[Bring online] を使用してオフラインのジャーニーをオンラインにし、[Take offline] を使用して実行中のジャーニーを停止します。
ジャーニーのオンライン化
ジャーニーのオフライン化
オンラインステータスのジャーニーに適用されます。
[操作] 列の [Take offline] をクリックします。
ジャーニーがオフラインになる前に、システムは他のオンラインジャーニーから参照されていないかを確認します。参照されている場合、ジャーニーをオフラインにすることはできず、システムはそれを参照しているジャーニーを一覧表示します。
操作を確定すると、ジャーニーの実行が停止し、ステータスが
Offlineに変わります。
ジャーニーの管理
ジャーニーの編集
ジャーニーリストページで、[操作] 列の [Edit] をクリックして、ジャーニー編集ページに移動します。
編集ロジック
ジャーニーステータス | 編集時の動作 |
ドラフト | ドラフトを直接開いて編集します。 |
オンライン | オンラインバージョンに基づいてドラフトを作成します。オンラインバージョンは影響を受けずに実行を続けます。すでに編集中のドラフトがある場合は、保存されているドラフトが開きます。 |
オフライン | オフラインバージョンに基づいてドラフトを作成します。すでに編集中のドラフトがある場合は、保存されているドラフトが開きます。 |
編集状態はオンラインバージョンから分離されているため、ジャーニーの編集が実行中のジャーニーに影響することはありません。
編集が完了したら、ジャーニーを再度公開して新しいバージョンを生成し、オンライン化します。
トリガー設定の変更
トリガー情報の一部を変更するには、ジャーニー編集ページで [Trigger configuration] をクリックします。変更できるフィールドはトリガータイプによって異なります。
API イベントトリガー：ジャーニー名を変更できます。
受信メッセージトリガー：ジャーニー名、バインドされたアカウント、マーチャント番号を変更できます。チャネルタイプは変更できません。
オーディエンスプランのトリガー：ジャーニー名、オーディエンスグループ、プランの日付を変更できます。
ジャーニー呼び出しトリガー：ジャーニー名を変更できます。
バージョン管理
Agentic Journey はバージョン管理をサポートしています。履歴バージョンを表示し、それらのバージョンにロールバックすることができます。
バージョニングルール
ドラフトステータス：新しいジャーニーにはバージョン番号がなく、ドラフトステータスになります。
初回公開：バージョン V1.0 が生成され、ステータスは
Onlineになります。オンラインまたはオフラインのジャーニーの編集：新しいバージョンは生成されません。変更はドラフト内でのみ行われます。
その後の公開：編集したジャーニーが再度正常に公開されると、新しいバージョンが生成され、バージョン番号が V2.0、V3.0 のように増加します。以前のバージョンのステータスは
Offlineに変わります。
履歴バージョンの表示
編集ページの右上隅にある [Historical versions] アイコンをクリックします。
ダイアログボックスで、バージョン番号、ジャーニーステータス、更新時刻など、すべての履歴バージョンを表示します。
バージョン操作
利用可能な操作 | 説明 |
詳細の表示 | バージョンをクリックすると、そのバージョンの全情報が表示される読み取り専用の詳細ページが開かれます。 |
ドラフトとして同期 | [Sync as draft] をクリックすると、編集中のキャンバスがそのバージョンの内容で上書きされます。慎重に操作してください。同期を元に戻すには、操作記録内の最新の保存記録にロールバックします。 |
[Sync as draft] 操作は、現在のドラフトのすべての内容を上書きします。操作の前に、確認を求めるプロンプトが表示されます。
同期後、ジャーニーを再度公開して新しいバージョンを生成します。
変更記録
変更記録はジャーニーの編集履歴を追跡し、任意の履歴記録にロールバックすることができます。
操作記録の表示
編集ページで、右側の設定パネルにある [Operation records] アイコンをクリックして、すべての保存記録を表示します。
記録タイプ
タイプ | 説明 | 記録番号 |
手動保存 | [Save] アイコンをクリックしたときに作成されます。 | #1、#2、#3 のように、新しい記録番号が生成されます。 |
自動保存 | システムが 5 分ごとにジャーニーを自動保存したときに作成されます。 | 新しい記録番号が生成されます。 |
ジャーニーのロールバック
変更記録リストで、ロールバックしたい記録を見つけます。
[Roll back] をクリックします。
操作を確定すると、現在のキャンバスの内容がその記録の内容で上書きされます。
ロールバックは元に戻せません。実行する前に操作を慎重に確認してください。
ロールバックでは新しい記録番号は生成されません。
間違った記録にロールバックした場合は、別の記録を選択して再度ロールバックします。
ジャーニーの削除
ジャーニーリストページで、[操作] 列の [削除] をクリックしてジャーニーを削除します。
削除の制限：
オフラインステータスのジャーニーのみ削除できます。
オンラインステータスのジャーニーは削除できません。まずジャーニーをオフラインにしてください。
削除は元に戻せません。削除されたジャーニーは使用できなくなります。慎重に操作してください。
ジャーニーのコピー
ジャーニー詳細ページで、ページ上部の [Copy as new journey] アイコンをクリックして、現在のジャーニーを新しいジャーニーにコピーします。
[Copy as new journey] アイコンをクリックします。
ダイアログボックスで、新しいジャーニーの名前を入力します。デフォルト名は
{current journey name} copyです。[Confirm] をクリックします。システムは新しいジャーニーを作成し、その編集ページを開きます。
コピーは、現在のバージョンのすべての設定とコンポーネントを保持します。
新しいジャーニーは、元のジャーニーと同じトリガータイプと作成方法を持ちます。
ジャーニーのダウンロード
ジャーニー詳細ページで、ページ上部の [Download] をクリックして、現在のバージョンを JSON ファイルとしてコンピューターにエクスポートします。
ダウンロードした JSON ファイルは、ジャーニー作成時に [Import journey] の作成方法を使用してインポートできます。
データ分析パネル
ジャーニー詳細ページで、ジャーニーのランタイムデータを表示します。
ジャーニーリストページでジャーニー名をクリックして、ジャーニー詳細ページに移動します。
[Data Panel] タブをクリックして、ジャーニーのランタイムデータを表示します。
オンラインのジャーニーのみがランタイムデータを持ちます。
データパネルは、ジャーニーのパフォーマンスを理解するのに役立ち、設定を適時に調整および最適化できます。
よくある質問
Agentic Journey は自動返信の頻度制限をサポートしていますか？
Agentic Journey では、自動返信の頻度制限を直接設定することはできません。顧客がジャーニーをトリガーするメッセージを送信するたびに、システムはそのジャーニーの自動返信ロジックを実行します。システムは、顧客がその日に何回ジャーニーをトリガーしたか、または過去のインタラクション状態を識別できないため、「1 日に 1 回だけ返信する」や「顧客が何通のメッセージを送っても 1 回だけ返信する」といったロジックを実装できません。
同様の頻度制御には、顧客のトリガー回数を記録するデータベースなどの外部システムを OpenAPI と組み合わせて使用し、ビジネスレイヤーで動作を管理してください。
ジャーニーをオンラインにできないのはなぜですか？
ジャーニーがオンラインにできない場合、次の理由が考えられます。
ジャーニーが別のジャーニーを参照しているが、参照先のジャーニーがオフラインである。
ジャーニーの参照の深さが 5 階層を超えている。
トリガー設定が不完全である。たとえば、受信メッセージトリガーにチャネルアカウントが設定されていない。
上記の設定を確認して、もう一度お試しください。
オンラインのジャーニーを編集すると、実行中のバージョンに影響しますか？
いいえ。編集状態はオンラインバージョンから分離されているため、編集が実行中のジャーニーに影響することはありません。新しいバージョンは、ジャーニーを再度公開した後にのみオンラインになり、以前のバージョンは自動的にオフラインになります。
ジャーニーの参照関係はどのように表示しますか？
ジャーニーリストページの [Referenced by] 列と [Journey references] 列には、参照数が表示されます。数字をクリックすると、詳細な参照関係と参照先ジャーニーの情報を示すダイアログボックスが開かれます。
関連ドキュメント
Agentic Journey の詳細については、次のトピックをご参照ください。