애플리케이션의 파일 링크를 사용하여 이메일 초안 보강(프리뷰)

아티클
12/30/2024

중요

프로덕션 준비 미리 보기 기능입니다.
프로덕션 준비 미리 보기에는 추가 사용 약관이 적용됩니다.

[이 문서는 시험판 설명서이므로 변경될 수 있습니다.]

영업용 Copilot을 사용하여 이메일 초안을 작성하면 이메일의 의도를 고려하고 Salesforce 또는 Dynamics 365의 CRM 정보를 사용하여 초안을 만듭니다. 영업용 Copilot에서 제공하는 이메일 초안 작성 기능을 자체 애플리케이션의 권장 파일과 함께 확장할 수 있습니다.

참고

이 기능은 Outlook의 영업용 Copilot 측면 창을 사용하여 만든 이메일 초안에 대해서만 지원됩니다.

API 설명

작업에 다음 API 설명을 추가해야 합니다. 이러한 방식으로 영업용 Copilot은 기능을 보강하기 위해 호출해야 하는 올바른 API를 식별할 수 있습니다.

이 작업은 Outlook의 C4S 이메일 초안에 표시될 이메일 대화와 관련된 파일을 가져옵니다. 이 작업은 영업용 Copilot의 기존 기술을 향상시킵니다.

입력 페이로드

입력	데이터 유형	필수	세부 사항	작업에 추가할 설명
resourceData	Object	네	추천 콘텐츠를 가져오는 데 사용할 리소스 데이터입니다. 데이터 구조의 경우 확장성 이메일 데이터 모델로 이동합니다.	이 입력은 이메일 스레드, 제목 및 기타 세부 정보의 모음인 이메일 콘텐츠를 식별합니다.
resourceType	String	네	콘텐츠 제안을 가져올 리소스의 유형입니다. 예를 들어 'email-thread' 또는 'teams-chat'입니다.	이 입력은 제안된 파일 링크(이 경우 '이메일 스레드')를 가져오기 위해 공유되는 리소스 유형을 식별합니다.
recordType	String	없음	거래처 또는 영업 기회와 같은 CRM 레코드의 유형입니다.	이 입력은 이메일 스레드와 관련된 CRM의 레코드 종류를 식별합니다.
recordId	String	없음	추천 콘텐츠에 사용할 CRM 레코드의 고유 식별자입니다.	이 입력은 이메일 스레드와 관련된 CRM 레코드의 고유 식별자를 제공합니다.
crmType	String	없음	CRM 시스템의 유형(연결된 경우)입니다. 유효한 값은 Salesforce 및 Dynamics 365입니다.	이 입력은 이메일 스레드와 관련된 레코드가 있는 CRM 유형을 나타냅니다.
crmOrgUrl	String	없음	CRM 조직 URL입니다.	이 입력은 이메일 스레드와 관련된 레코드가 있는 CRM 환경의 URL을 나타냅니다.
inputPrompt	String	없음	이메일 초안을 생성하기 위해 사용자가 제공한 현재 사용 중인 추천 프롬프트입니다. 예를 들어, "Reply to a Concern" 또는 "Make a Proposal"이 있습니다.	이 입력은 이메일 초안을 작성하는 동안 사용자가 제공한 프롬프트를 나타냅니다.
최고	Integer	없음	가져올 항목의 수입니다.	이 입력은 가져올 파일 링크의 수를 나타냅니다.
skip	Integer	없음	건너뛸 항목의 수입니다.	이 입력은 추천 파일 링크를 가져올 때 건너뛸 항목 수를 나타냅니다.

확장성 이메일 데이터 모델

Property	Type	세부 사항	작업에 추가할 설명
plaintextBody	String	전체 이메일 본문에는 이메일 스레드의 이전 메시지가 모두 포함됩니다.	이 입력은 이메일 스레드의 모든 콘텐츠를 텍스트 형식으로 제공합니다.
fullHtmlBody	String	이메일 스레드의 모든 이전 메시지를 포함하는 이메일 본문의 전체 HTML 버전입니다.	이 입력은 이메일 스레드의 모든 콘텐츠를 HTML 형식으로 제공합니다.
주체	String	이메일 제목입니다.	이 입력은 이메일의 제목을 제공합니다.
발신	String	보낸 사람 이메일 주소.	이 입력은 보낸 사람의 이메일 주소를 제공합니다.
수신	문자열[]	수신자 이메일 주소.	이 입력은 수신자의 이메일 주소를 제공합니다.
참조	문자열[]	수신자의 이메일 주소가 이메일의 참조 필드에 추가되었습니다.	이 입력은 이메일의 참조 필드에 포함된 모든 수신자의 이메일 주소를 제공합니다.
숨은 참조	문자열[]	수신자의 이메일 주소가 이메일의 숨은 참조 필드에 추가되었습니다.	이 입력은 이메일의 숨은 참조 필드에 추가된 모든 수신자의 이메일 주소를 제공합니다.
sentDateTime	DateTimeOffset	Offset 속성과 함께 UTC 형식의 이메일 날짜 및 시간입니다. 자세한 내용은 DateTimeOffset 구조(System)를 참조하십시오	이 입력은 이메일의 타임스탬프를 제공합니다.
messageId	String	이메일의 Graph 메시지 ID입니다.	이 입력은 이메일의 메시지 ID를 제공합니다.
conversationId	String	이메일 스레드의 Graph 대화 ID입니다.	이 입력은 이메일 스레드의 대화 ID를 제공합니다.

출력 매개 변수

Property	데이터 유형	필수	세부 사항
value	배열	네	파일 또는 링크 콘텐츠 제안에 대한 스키마 응답에 설명된 대로 정의된 파일 링크(개체)의 목록입니다.
hasMoreResults	부울	없음	더 많은 결과를 사용할 수 있는지 여부를 나타내는 값입니다.

파일 또는 링크 콘텐츠 제안 응답에 대한 스키마

입력	데이터 유형 형식	필수	세부 사항	작업에 추가할 설명
contentType	string	네	표시할 콘텐츠의 유형입니다. 자세한 내용은 contentType에 대한 사전 정의된 값을 참조하세요	이 출력은 이메일 초안에 포함된 콘텐츠 유형을 나타냅니다.
콘텐츠	string	네	실제 콘텐츠가 포함되어 있습니다. 웹 페이지 또는 파일의 URL일 수 있습니다.	이 출력은 이메일 초안에 포함된 실제 콘텐츠를 나타냅니다. 웹 페이지 또는 URL일 수 있습니다.
contentTitle	string	네	사용자에게 표시되는 추천 콘텐츠의 제목입니다.	이 출력은 컨텐츠의 제목을 나타냅니다.
contentDescription	string	네	사용자에게 표시되는 추천 설명의 제목입니다.	이 출력은 파일을 설명할 때 포함할 텍스트를 나타냅니다.
contentIconUrl	string	없음	사용자에게 표시되는 추천 콘텐츠의 아이콘입니다. 제공되지 않으면 일반 아이콘이 사용됩니다.	이 출력은 콘텐츠에 포함할 아이콘을 나타냅니다.
additionalProperties	Object	없음	작업이 반환하는 관련 파일 링크의 추가 속성을 나타내는 이름-값 쌍 집합입니다.	이 출력은 작업에서 반환된 각 관련 링크의 이름-값 쌍으로 추가 속성을 나타냅니다.

contentType에 대해 미리 정의된 값

문자열 값	콘텐츠 유형
content-file	외부 파일(일반)
content-web	외부 웹 사이트
content-doc	Microsoft Word 문서
content-pdf	Microsoft PDF 문서
content-pptx	Microsoft Powerpoint 프레젠테이션
content-xlsx	Microsoft Excel 스프레드시트

예

{
  "value": [
    {
      "contentType": 0,
      "content": "https://www.bing.com",
      "contentTitle": "Purchase Contract",
      "contentDescription": "Purchase Contract Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Logan Edwards",
        "Sender Name": "Kenny Smith"
      }
    },
    {
      "contentType": 3,
      "content": "https://www.microsoft.com",
      "contentTitle": "Strategy Planning",
      "contentDescription": "Strategy Planning Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Gabriela Edwards",
        "Sender Name": "Maria Smith"
      }
    },
    {
      "contentType": 1,
      "content": "https://www.bing.com",
      "contentTitle": "Contoso Website",
      "contentDescription": "Contoso Website Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Total Views": "100",
        "Domain": "Contoso.com"
      }
    }
  ],
  "hasMoreResults": false
}

다음 이미지의 예에서는 API의 출력이 이메일 초안에 매핑되는 방법을 보여줍니다.

이메일 초안에 있는 파트너 앱의 파일 링크를 보여주는 스크린샷.

범례:

파트너 앱의 파일 링크입니다.

참조 항목

Outlook의 Copilot을 통해 영업 정보를 사용하여 이메일 스레드 요약
애플리케이션의 인사이트로 이메일 요약 보강
애플리케이션에서 얻은 인사이트로 주요 영업 정보 보강
애플리케이션에서 얻은 인사이트로 CRM 레코드 세부 정보 보강
애플리케이션에서 얻은 인사이트로 CRM 레코드 요약 보강
파트너 애플리케이션으로 Microsoft 365 영업용 Copilot 확장
영업용 Copilot 확장 빌드

다음을 통해 공유