アプリケーションからの分析情報を活用して CRM レコードのサマリーを充実させる (プレビュー)
重要
- これは運用に対応したプレビュー機能です。
- 運用に対応したプレビューには 追加使用条件 が適用されます。
[この記事はプレリリース ドキュメントであり、変更されることがあります。]
営業担当者は、準備中の会議や読んでいる電子メールのコンテキストをよりよく理解するために、顧客からの問い合わせ、懸念事項、メモなど、関連する顧客関係管理 (CRM) 情報を求めています。 Copilot for Sales は、AI を使用して各 CRM レコードのサマリーを生成します。 この要約では、営業のフェーズ、予算、契約完了予定日などの重要な詳細が強調されています。 Copilot for Sales が提供する CRM レコード サマリー機能を、独自のアプリケーションの分析情報で拡張できます。
API の説明
次の API の説明をアクションに追加する必要があります。 このようにして、Copilot for Sales は、機能を充実させるために呼び出す必要のある正しい API を特定できます。
このアクションにより、CRM レコードに関連する Sales Insights が追加され、C4S レコードのサマリー カードに表示されます。 このアクションにより、Copilot for Sales の既存のスキルが強化されます。
入力パラメーター
Copilot for Sales は、API に次の入力パラメータを提供するように設計されています。
| 件名 | データ型 / 形式 | Required | Details | アクションに追加する説明 |
|---|---|---|---|---|
| レコード タイプ | String | 可 | アクティビティなどの関連分析情報が要求される CRM のエンティティまたはオブジェクトのタイプです。 値には、ローカライズ可能な表示名ではなく、エンティティまたはオブジェクト タイプの言語に依存しない一意の名前が含まれます。 例としては 取引先企業 と 営業案件 が含まれます。 | この入力は、分析情報が要求される CRM 内のエンティティまたはオブジェクト タイプを示します。 |
| recordId | String | 可 | CRM レコードの一意識別子です。 | この入力は、分析情報が要求される CRM レコードの一意識別子を示します。 |
| startDateTime | 'date-time' 形式の文字列 | いいえ | 分析情報を検索する開始日時です。 形式は OpenAPI の仕様に従います。 例: 2017-07-21T17:32:28Z. | この入力は、要求された分析情報の開始日時を示します。 |
| endDateTime | 'date-time' 形式の文字列 | いいえ | 分析情報を検索する終了日時です。 形式は OpenAPI の仕様に従います。 例: 2017-07-21T17:32:28Z. | この入力は、要求された分析情報の終了日時を示します。 |
| 上部 | 整数 | いいえ | 取得する分析情報の数です。 | この入力は、取得する分析情報の数を示します。 |
| skip | 整数 | いいえ | スキップする分析情報の数です。 | この入力は、スキップする分析情報の数を示します。 |
| crmType | String | いいえ | 有効な値は Dynamics 365 と Salesforce です。 | この入力は、分析情報が要求される既存の CRM レコードの CRM のタイプを示します。 |
| crmOrgUrl | String | いいえ | CRM 組織のホスト名 ( contoso.crm.dynamics.com など)。 | この入力は、分析情報が要求される既存の CRM レコードの CRM 環境の URL を示します。 |
出力パラメーター
Copilot for Sales は、API から分析情報 (オブジェクト) のリストを受け取ることを想定しており、各分析情報には特定のパラメーターがあることを想定しています。 Copilot for Sales が出力を正しく解析できるように、応答構造は次の表のガイドラインに従う必要があります。
| パラメーター | データ型 | Required | Details |
|---|---|---|---|
| 価値 | Array | 可 | 分析情報のスキーマ セクションの説明に従って定義された分析情報 (オブジェクト) のリスト。 |
| hasMoreResults | ブール値 | いいえ | より多くの結果が利用可能かどうかを示す値です。 |
分析情報のためのスキーマ
| 件名 | データ型 / 形式 | Required | Details | アクションに追加する説明 |
|---|---|---|---|---|
| 肩書き | String | 可 | 引用カードに記載の分析情報のタイトルです。 これは、Accept-Language リクエスト ヘッダで指定された言語による、分析情報の自然言語のタイトルです。 たとえば 契約の締結 などです。 |
この出力は、引用カード内のアクティビティのタイトルを示します。 |
| プロパティ | String | 可 | 分析情報の説明です。 これはレコード サマリーの箇条書きで表示され、Accept-Language ヘッダーで指定された言語による分析情報の自然言語記述です。 例: ケニー、ローガン、他 2 名が 2023 年 9 月 7 日に Contoso 2023 年の更新契約に署名。 |
この出力は、分析情報の説明を示します。 |
| dateTime | 'date-time' 形式の文字列 | 可 | UTC 形式でのアクティビティの日付と時刻です。 アクティビティに開始時刻と終了時刻の両方がある場合、アプリケーションはどちらの時刻を表示するかを決定する必要があります。 形式は OpenAPI の仕様に従います。 例: 2017-07-21T17:32:28Z. | この出力は、分析情報に関連付けられた時間を示します。 |
| url | String | いいえ | パートナー アプリケーションでアクティビティを開くための有効な URL です。 | この出力は、分析情報を開くための URL を示します。 |
| additionalProperties | String 型の プロパティ名 と プロパティ値 の値を持つオブジェクト | いいえ | 詳細ビューに表示される追加プロパティです。 プロパティ名と値は、 { |
この出力は、分析情報の詳細ビューに表示される追加のプロパティを示します。 |
ヒント
電子メールの要約機能とレコードの要約機能を拡張するための API 要件は似ているように見えますが、コネクター内の別のアクションとして追加する必要があります。
例
{
"value": [
{
"title": "Contract signed",
"description": "You have 5 connections in Fourth Coffee Inc",
"dateTime": "2024-05-07T03:28:38.0667701Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
},
{
"title": "Contract signed",
"description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
"dateTime": "2024-05-07T03:28:38.0669445Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
}
],
"hasMoreResults": false
}
次の画像の例は、API の出力がレコード サマリーにどのようにマッピングされるかを示しています。
凡例:
- パートナー アプリケーションからの分析情報を示すセクションです。 セクション タイトルは、Microsoft Power Platform コネクタの名前から派生します。
- API レスポンスからの分析情報の説明です。
- 分析情報の詳細を表示するために選択できる引用番号です。
- 分析情報の詳細を示す引用カードです。
- 分析情報のアイコンとタイトル。 アイコンは Microsoft Power Platform コネクタのメタデータから取得されます。 タイトル テキストは、API 応答からの分析情報のタイトルです。
- API 応答からの分析情報の追加プロパティです。
- パートナーのアプリケーション名。 表示される名前は Microsoft Power Platform コネクターの名前です。
- パートナー アプリケーションで分析情報の詳細を表示するために選択できるリンクです。 これは、API 応答の分析情報の URL に基づいています。
関連情報
レコードの概要を表示する
アプリケーションからの分析情報でメールの概要を充実させる
アプリケーションからのファイル リンクを使用してメールの下書きを充実させる
アプリケーションからの分析情報で重要な営業情報を充実させる
アプリケーションからの分析情報を活用して CRM レコードの詳細を充実させる
Microsoft 365 Copilot for Sales をパートナー アプリケーションで拡張する
Copilot for Sales 拡張子のビルド