移行クレジットエージェントの設定
認証されていないゲストユーザーの移行可能なクレジットの推定を提供するように移行クレジットエージェントを設定します。
必要なエディション
| 使用可能なインターフェース: Lightning Experience |
| 使用可能なエディション: Education Cloudおよび該当するAgentforceアドオン ライセンスが付属するEnterprise Edition、Unlimited Edition、Developer Edition |
| 必要なユーザー権限 | |
|---|---|
| クレジットエージェントを移行する | Education Cloud の完全なアクセス権 および Agentforce サービスエージェントの管理 および AI エージェントの管理 および Data Cloud アーキテクト および プロンプトテンプレートマネージャー |
転送クレジットエージェント設定の前提条件
- 組織を移行クレジット用に設定します。
- Transfer Credits のデータを準備します。
- Transfer Credit Agent フローを設定します。
- Data 360 for Education Cloud を設定します。
- Agentforce for Education Cloudを設定します。
転送クレジットエージェントの Data 360 リソースの設定
-
Salesforce CRM データを Data 360 に取り込むために、アカウント、外部学習、学習プログラムの各オブジェクトのデータストリームを作成します。
Account データストリームの場合、Is Person Account フィールドを含めます。External Learning データストリームの場合、[Provider] 項目と [Active] 項目を含めます。
-
外部学習データストリームで数式フィールドを作成します。
この数式フィールドは、[有効] テキストフィールドを Boolean フィールドに変換します。詳細を提供する場合、
- 項目に個別の表示ラベルを付けます。たとえば、有効な数式です。
- [数式の戻り値のデータ型] で、[Boolean] を選択します。
- [属性] タブで、[有効] を選択します。
- [変換数式] で、数式を更新して [有効] テキストフィールドを Boolean フィールドにします。
-
作成した数式フィールドを外部学習データモデルオブジェクトの [有効] フィールドに対応付けます。
- [データストリーム] タブで、作成した外部学習データストリームを見つけて選択します。
- [データマッピングを開始] をクリックします。
- [データモデルエンティティ] キャンバスで、[オブジェクトを選択] をクリックします。
- [外部学習] を追加して、[完了] をクリックします。
- 外部学習データストリームキャンバスで、作成した数式項目を選択します。
-
Data Model entities キャンバスの [Is Active (有効)] フィールドをクリックして、マッピング接続を確立します。
項目を接続する矢印と共に確認メッセージが表示されます。
- 変更内容を保存します。
- [外部学習] データストリームページで、[今すぐ更新] をクリックしてデータをデータモデルオブジェクトに取り込みます。
-
Account データストリームの Is Person Account フィールドを Account データモデルオブジェクトのカスタム Is Person Account フィールドにマッピングします。
- [データストリーム] タブで、作成した Account データストリームを見つけて選択します。
- [データマッピングを開始] をクリックします。
- [データモデルエンティティ] キャンバスで、[オブジェクトを選択] をクリックします。
- Account を追加し、[完了] をクリックします。
- [データモデルエンティティ] キャンバスで、[Unmapped] を展開し、[Add New Field] をクリックします。
- 項目の表示ラベルと API 参照名として「Is Person Account」 (個人取引先) と入力し、データ型として [テキスト] を選択します。
- 変更内容を保存します。
- Account データストリームの Is Person Account を Account データモデルオブジェクトの Is Person Account に対応付けます。
- Account データストリームを更新して、データをデータモデルオブジェクトに取り込みます。
-
アカウント、外部学習、学習プログラムの各オブジェクトに対してハイブリッド検索インデックスを作成します。
-
[チャンク] では、次の項目を取引先と外部学習に追加します。
- Account (取引先): Is Person Account (個人取引先)
- 外部学習: 提供者、名前、状況、専門分野
必要に応じて、検索と絞り込みに使用する項目を追加します。 -
[絞り込みの項目] で、次の項目を取引先と外部学習に追加します。
- Account (取引先): Is Person Account (個人取引先)
- 外部学習: プロバイダーと有効
必要に応じて、絞り込みに使用する項目を追加します。
-
[チャンク] では、次の項目を取引先と外部学習に追加します。
-
アカウント、外部学習、および学習プログラムオブジェクトごとに個別のデータ取得機能を作成します。
-
[Define Retriever Results (取得者結果を定義)] で、取引先と外部学習の検索結果を絞り込む検索条件を定義します。
- [取引先] で、次の条件を追加します。
動的 項目 演算子 値 選択解除 個人取引先 次の値と等しい False - 外部学習の場合、次の条件を追加します。
動的 項目 演算子 値 選択解除 有効 次の値と等しい True 選択済み 提供者 次の値と等しい {$Provider}
- [取引先] で、次の条件を追加します。
-
[Configure Retriever Results (取得者の結果を設定)] で、取引先と外部学習で返される次の項目を指定します。
- [取引先]、[取引先 ID]。
- [External Learning (外部学習)] で、[Name (名前)]、[External Learning Id (外部学習 ID)]、[Learning (学習)]、[Status (状況)]、[Provider (プロバイダー)]、[Is Active (有効)] を指定します。
より多くの情報をユーザーに表示するには、返す項目を追加します。
-
[Define Retriever Results (取得者結果を定義)] で、取引先と外部学習の検索結果を絞り込む検索条件を定義します。
振替クレジットエージェントのプロンプトテンプレートの更新
-
データ取得を使用して、[Get External Learning Data (外部学習データを取得)] プロンプトテンプレートを更新します。
- [設定] から、[プロンプトビルダー] を見つけて選択します。
- [Prompt Templates (プロンプトテンプレート)] で、[Get External Learning Data (外部学習データを取得)] を選択します。
- [別名で保存] をクリックし、[新しいバージョンとして保存] をクリックします。
- プロンプトの最後までスクロールし、[PLACEHOLDER_FOR_DATA_RETRIEVER] を見つけて、プレースホルダーテキストを削除します。
- [リソースの挿入] をクリックし、[アクション] で [検索] を選択します。
- [検索を設定] をクリックし、外部学習用に作成した取得者を選択します。
- [検索テキスト] に「Input:externalLearningNames」と入力します。
- [出力項目] で、外部学習データ取得で返すように指定した項目を選択します。
- [pre-filter (事前条件)] で、[input:institutionID] を選択します。
- リソースを適用して挿入します。
- プロンプトテンプレートを保存して有効化します。
-
同様に、[Get Institution Data (機関データを取得)] および [Get Learning Programs (学習プログラムを取得)] プロンプトテンプレートを更新します。
- [機関データを取得] では、[検索テキスト] 項目のみを更新します。「Input:institutionName」と入力します。
- [Get Learning Programs (学習プログラムを取得)] では、[検索テキスト] 項目のみを更新します。「Input:learningProgramName」と入力します。
振替クレジットエージェントの作成
-
[クレジットエージェントを移行] を有効にします。
- [設定] から、[Set Up Education Cloud] を見つけて選択します。
- [Set Up Agentforce for Education Cloud]で、[Student Recruitment and Transfer Credit Agent]を有効にします。
- ゲストユーザー用の Agentforce サービスエージェントを作成し、[Transfer Credit Equivalency (クレジット等価性を転送)] サブエージェントを追加します。
-
Einstein エージェントユーザーのメールアドレスを更新します。
デフォルトのメールアドレスをアクセス可能なメールアドレスに置き換えます。
-
Einstein エージェントユーザーのメールアドレスを確認します。「Requirements to Send Email from Salesforce」を参照してください。
重要 転送クレジットエージェントでゲストユーザーにメール確認コードを送受信するには、ドメインレベルとユーザーレベルのメール確認が必要です。Einstein エージェントユーザーのメールアドレスまたはメール送信ドメインが検証されていない場合、メールの送信は失敗します。 -
「Education Cloud AIエージェント アクセス」権限セットをコピーしてカスタマイズし、Einsteinエージェント ユーザーに割り当てます。
-
権限セットで次のオブジェクトおよび項目権限を設定します。
オブジェクト オブジェクト権限 項目権限 取引先 「参照」、「作成」、「編集」 次の項目に対する「参照」: - 取引先名
- アカウント所有者
Contact 参照 次の項目に対する「参照」: - 名前
- メール
科目単位互換申請 「参照」、「作成」、「編集」 次の項目の「参照」および「編集」。 - 学習名
- 学習識別子
- リクエストされた学習
- 提供者
- 学習レターグレード
- 学習数値グレード
- タイプ
- 学習アカデミックシーズン
- 学習年度
- 学習期間
- 事前学習評価
- 所有者名
- 見積用
外部学習 既読 次の項目に対する「参照」: - 名前
- 学習
- 提供者
- 有効
学習 既読 次の項目に対する「参照」: - 名前
- 種類
- 以前の学習バージョン
- 改訂済み学習バージョン
- 学習システム ID
- バージョン
学習実績 既読 次の項目に対する「参照」: - 名前
- レコードタイプ
学習科目 既読 次の項目に対する「参照」: - 名前
- 学習
- 提供者
- 有効な開始日
- 有効な終了日
- CIP コード
- 学術レベル
- 有効
- 説明
- リンクのみ
- コース種別
- 以前の学習バージョン
- 改訂済み学習バージョン
- 学習システム ID
- バージョン
学習等価性 既読 次の項目に対する「参照」: - 名前
- 有効
- 公開済み
- 開始日
- 終了日
- タイプ
- カテゴリ
- 状況
学習等価性学習 既読 次の項目に対する「参照」: - 学習
- 学習等価性
学習同等性達成度マッピング 既読 次の項目に対する「参照」: - 学習等価性
- ソース
- 目標
学習結果項目 既読 次の項目に対する「参照」: - 名前
- 学習
- 学習実績
- 期間
- 期間単位
- カテゴリ
- 最小数値グレード
- 最小レターグレード
- 主
- 作成日
学習プログラム 既読 次の項目に対する「参照」: - 名前
- 学術レベル
- 有効
事前学習評価 「参照」、「作成」、「編集」 次の項目の「参照」および「編集」。 - 名前
- 取引先
- 取引先責任者
- 所有者名
- 親の事前学習評価
- 要求
- 結果
商品 参照 デフォルトの選択を使用します。 -
次のレコードタイプを取引先オブジェクトに割り当てます。
- ビジネス
- カレッジ
- 軍事
- 個人取引先
- 中等学校
-
次のシステム権限を選択します。
- Education Cloud コンポーネントへのアクセス
- Education Cloud オブジェクトへのアクセス
- アクションプラン機能にアクセスする権限
-
内部共有の場合、組織の共有設定を更新して、これらのオブジェクトへの「公開/参照のみ」アクセス権を付与します。
- 学習
- 学習等価性
-
権限セットで次のオブジェクトおよび項目権限を設定します。
転送クレジットエージェントの設定
ゲストユーザーに関するデータを作成する前に、これらのエージェントアクションを変更してゲストユーザーの ID を検証します。これらの設定により、エージェントがデータを生成し、ゲストユーザーと安全に共有できます。
-
Agent Builder で、フィルタを作成して [Create Prior Learning Evaluation (事前学習評価を作成)] アクションに追加します。
フィルタは、
isVerified変数の値をチェックします。エージェントは、検索条件が満たされた場合にのみ [事前学習評価を作成] アクションをコールします。フィルタに「isVerified」という名前を付け、フィルタ条件を設定します。リソース 演算子 値 isVerified 次の文字列と一致する True -
カスタム変数を作成して、ゲストユーザーの検証用メールアドレス、アカウント ID、取引先責任者 ID、検証用メールアドレスを保存および再利用します。従来のビルダーを使用している場合は、「従来のビルダーでのエージェントのカスタム変数の作成」を参照してください。
各変数にわかりやすい名前を付けます。次に例を示します。
名前 API 参照名 データ型 API による値の設定を許可 LLM に値の使用を許可 確認用メールアドレス verificationEmailAddress テキスト 選択済み 選択解除 検証済みアカウント ID verifiedAccountId テキスト 選択済み 選択解除 検証済み取引先責任者 ID verifiedContactId テキスト 選択済み 選択解除 検証済みメールアドレス verifiedEmailAddress テキスト 選択済み 選択解除 -
作成した
authenticationKey変数とverificationEmailAddress変数を [EDU Cloud: Send Email Verification (EDU Cloud: メール送信確認)] アクションの出力に対応付けます。これらの対応付けにより、ユーザーの ID の検証に使用される 2 つの値が EDU Cloud の [メールコードを検証] アクションに渡されます。つまり、認証キーと確認コードの組み合わせと、ユーザーが指定したメールアドレスです。-
Agentforce Builder のエージェントで、サイドバーから [サブエージェント] を選択します。
エージェントが有効な場合は、無効化します。
- [このサブエージェントのアクション] から、[EDU Cloud: Send Email Verification (EDU Cloud: メール検証を送信)] を選択します。
- アクション出力で、[認証キー] を見つけます。
- [Map to Variable (変数に対応付け)] ドロップダウンから、[authenticationKey] を選択します。
-
同様に、作成した
verificationEmailAddress変数を [検証メールアドレス] 出力に対応付けます。
-
Agentforce Builder のエージェントで、サイドバーから [サブエージェント] を選択します。
-
次の変数を [EDU Cloud: メールコードを検証] アクションの入力に対応付けます。
これらの対応付けにより、[EDU Cloud: メールコードを検証] アクションで認証キーと確認コードの組み合わせと確認メールアドレスが取得されます。
変数 入力 authenticationKey 認証キー verificationEmailAddress 確認用メールアドレス -
次の変数を [EDU Cloud: メールコードを検証] アクションの出力に対応付けます。
変数 出力 isVerified 検証済み verifiedEmailAddress 検証済みメールアドレス verifiedContactId 検証済み取引先責任者 ID verifiedAccountId 検証済みアカウント ID -
サイドバーのタブを使用して、[クレジット同等性を移行] サブエージェントの手順をカスタマイズします。
カスタマイズにより、エージェントが学術ポリシーと用語に一致する機関に関する正確な情報を提供できます。
Experience Cloud ユーザーのクレジット移行エージェントの設定
- Experience Cloud サイトのポータルにエージェントを追加します。
-
移行クレジットエージェントには、事前学習の同等性に加えてアクションからの JSON 出力がユーザーに表示されます。Experience Cloud サイトをカスタマイズして、ユーザーエクスペリエンスを改善し、エージェントに表示する内容を制御します。
-
このスクリプトを入力して、ページ
<head>にマークアップを追加します 。<script type='text/javascript'> window.addEventListener("onEmbeddedMessagingReady", () => { // Embedded Messaging app ready embeddedservice_bootstrap.settings.disableStreamingResponses = true; }); </script> -
[セキュリティとプライバシー] で、セキュリティレベルを選択します。
[セキュリティレベル] で、[緩和された CSP: インラインスクリプトおよび許可されたホストへのアクセスを許可] を選択します。(Relaxed CSP: Permit Access to Inline Scripts and Allowed Hosts)
-
Experience Cloud サイトをスクリプトの信頼済みサイトとして追加します。「Where to Allow Hosts of Script Resources (スクリプトリソースのホストを許可する場所)」を参照してください。
サイトの URL を見つけるには、[設定] から [デジタルエクスペリエンス] を見つけて選択し、[すべてのサイト] をクリックします。[すべてのサイト] リストビューでサイトの URL を見つけます。
- サイトを公開します。
-
このスクリプトを入力して、ページ
この記事で問題は解決されましたか?
ご意見をお待ちしております。

