Agentforce のコンテキスト パッシングの設定
Consumer Goods Cloudモバイル アプリケーションでコンテキスト データを分析することで、エージェントの作業時間を短縮し、精度を高めます。カスタマイズプロジェクトでプロセス契約とビジネスロジック契約を設定することで、アプリケーションでこのコンテキストを作成して送信する方法を定義できます。
必要なエディション
| 使用可能なエディション: Consumer Goods Cloud が有効になっている Enterprise Edition および Unlimited Edition |
| 必要なユーザー権限 | |
|---|---|
| Agentforce のコンテキスト パッシングを設定する | 開発者、カスタマイザー |
メモ コンテキスト パッシングは、物理的なモバイルデバイスの Consumer Goods Cloud モバイル アプリケーションで Agentforce を使用する場合に機能します。モデラーシミュレーターアプリケーションでは機能しません。
たとえば、店舗コックピットから訪問 ID を渡すには、次の手順を実行します。
- Visual Studio Code ベースのモデラーでカスタマイズプロジェクトを開きます。
-
必要に応じて、プロセス契約で
Actionロジックを定義します。- 関連するプロセス契約を開きます。
-
データを
Actionに渡すロジックを実装するか、すでに使用可能なオブジェクトからデータを取得します。この例では、カスタムビジネスロジックをコールするための入力パラメーターとしてオブジェクト名とレコード ID を使用するロジックActionを作成します。<Action actionType="LOGIC" name="LaunchAgentforce" call="ProcessContext::CardController.launchAgentforce"> <Parameters> <Input name="objectName" type="Literal" value="Visit" /> <Input name="recordId" type="Binding" value="ProcessContext::mainBO.PKey" /> </Parameters> </Action> -
agentforceLaunchEvent外部イベントを追加して、アクションにバインドします。<ExternalEvent name="agentforceLaunchEvent" action="LaunchAgentforce" />
プロセス契約設定の例を次に示します。
<!-- Define the Action to call the Business Logic function --> <Action actionType="LOGIC" name="LaunchAgentforce" call="ProcessContext::CardController.launchAgentforce"> <Parameters> <!-- Pass the Object API Name --> <Input name="objectName" type="Literal" value="Visit" /> <!-- Pass the Record ID dynamically from the current Business Object --> <Input name="recordId" type="Binding" value="ProcessContext::mainBO.PKey" /> </Parameters> </Action> <!-- Define the External Event to intercept the header button click --> <ExternalEvent name="agentforceLaunchEvent" action="LaunchAgentforce" /> -
ペイロードを作成してネイティブの正面をコールするロジックを実装します。
- プロセスアクションで参照されるビジネスロジック契約を開きます。
-
Actionコールで定義された名前と一致する関数を実装します。 -
objectApiNameと属性を含む JSON ペイロードを作成します。 -
Facade.launchAgentForce()関数を呼び出します。
ビジネスロジックの実装例を次に示します。
function launchAgentforce(objectName, recordId){ var me = this; ////////////////////////////////////////////////////////////////////////////// // Add your customizing javaScript code below. // ////////////////////////////////////////////////////////////////////////////// var promise; let payload = { "objectAPIName": objectName, "attributes": { "recordId": recordId } }; Facade.launchAgentForce(payload); promise = Promise.resolve(); ////////////////////////////////////////////////////////////////////////////// // Add your customizing javaScript code above. // ////////////////////////////////////////////////////////////////////////////// return promise; }
緊急としてマークされた特定の訪問レコードのサンプルペイロード構造。
{
"objectApiName": "Visit",
"attributes": {
"recordId": "a00xx0000012345AAA",
"pageType": "standard_recordPage",
"actionName": "view"
},
"additionalAttributes": [
{
"name": "customStatus",
"value": "urgent",
"type": "String"
}
]
}パラメーターの詳細:
objectApiName: (String) 必須。Salesforce オブジェクトコンテキストの API 参照名。attributes: (オブジェクト) 必須。レコード識別子 (具体的には recordId) のコンテナ。additionalAttributes: (配列) 省略可能。追加のコンテキスト用のキーと値のペア。
この記事で問題は解決されましたか?
ご意見をお待ちしております。
