에이전트를 게시하고 Microsoft Teams에서 사용자가 에이전트를 사용할 수 있도록 설정한 후에는 사전 메시지를 통해 Microsoft Teams의 사용자("수신자")에게 알릴 수 있습니다. 사전 메시지는 Power Automate 흐름을 사용하여 콘텐츠를 전달하며 다음을 포함한 많은 시나리오에서 유용합니다.
- 수신자에게 이전 요청이 완료되었음을 알립니다. 예를 들어, 사용자의 휴가 요청이 승인되었습니다.
- 알림 또는 뉴스 업데이트를 제공합니다. 예를 들어 에이전트는 온라인 교육을 완료하라는 알림 메시지를 보낼 수 있습니다.
중요
Copilot Studio에서 생성 및 사용자 지정된 에이전트 및 클래식 챗봇에 대해 사전 예방적 메시지를 구성할 수 있습니다.
에이전트는 다음과 같은 경우 메시지를 배달할 수 없습니다.
- Microsoft Teams에 에이전트가 설치되어 있지 않습니다.
- 에이전트를 제거했습니다.
- 에이전트를 차단했습니다.
- 에이전트와 채팅할 수 있는 권한이 없습니다. 이 경우 다른 사용자와 에이전트를 공유해야 합니다.
사전 요구 사항
알려진 제한 사항
- 에이전트의 연결이 끊어졌다가 Microsoft Teams에 다시 연결되면 사용자는 에이전트를 다시 설치할 때까지 사전 메시지를 받지 않습니다.
- Copilot Studio의 모든 사전 메시지는 Power Automate의 한도과 Microsoft Teams 커넥터의 제한 한도가 적용됩니다.
- 사전 메시지는 대화 내용이나 분석 세션에 기록되지 않습니다.
- 사전 메시지는 Power Automate 흐름과 동일한 환경에 있어야 합니다.
- 사전 메시지는 에이전트와의 개인 채팅에만 게시할 수 있습니다.
사전 메시지 보내기
Power Automate에서 사전 메시지를 보낼 흐름을 엽니다.
Microsoft Teams 커넥터 작업 채팅 또는 채널에 메시지 게시를 추가합니다.
다음으로 게시에서 Power Virtual Agents(프리뷰)를 선택합니다.
게시 대상의 경우 봇과 채팅을 선택합니다.
봇의 경우 메시지를 보낼 에이전트를 선택하세요.
수신자에는 수신자의 이름 또는 이메일 주소를 입력합니다. 수신자 정보가 흐름의 이전 단계에서 가져온 경우 동적 콘텐츠를 사용할 수도 있습니다.
메시지에는 보낼 메시지를 입력합니다.
흐름이 실행되면 수신자는 Microsoft Teams의 에이전트에서 사전 메시지를 수신합니다.
사전 적응형 카드 보내기
중요
이 섹션에서는 Power Automate 흐름과 함께 사전 적응형 카드를 보내는 방법을 자세히 설명합니다. 사전 적응형 카드를 사용하면 사용자는 에이전트와의 비활성 대화에서 정보를 받을 수 있습니다. 활성 대화 중에 적응형 카드를 보내는 방법을 알아보려면 Copilot Studio에서 적응형 카드 표시를 참조하세요.
사전 메시지를 보내는 것 외에도 사전 적응형 카드를 보낼 수도 있습니다.
적응형 카드는 개발자가 공통적이고 일관된 방식으로 UI 콘텐츠를 교환할 수 있도록 하는 개방형 카드 교환 형식입니다. JSON에서 수동으로 적응형 카드를 작성하거나 드래그 앤 드롭 인터페이스를 선호하는 경우 적응형 카드 디자이너를 사용할 수 있습니다.
노트
Power Automate는 템플릿 기능을 사용하는 적응형 카드를 지원하지 않습니다.
이 예에서는 사용자가 검토할 수 있도록 주문 요약 카드를 보냅니다.
Power Automate에서 흐름에서 카드를 보내려는 단계에서 Microsoft Teams 커넥터 작업 채팅 또는 채널에 적응형 카드 게시를 추가합니다.
다음으로 게시에서 Power Virtual Agents(프리뷰)를 선택합니다.
게시 대상의 경우 봇과 채팅을 선택합니다.
봇의 경우 메시지를 보낼 에이전트를 선택하세요.
수신자에는 수신자의 이름 또는 이메일 주소를 입력합니다. 수신자 정보가 흐름의 이전 단계에서 가져온 경우 동적 콘텐츠를 사용할 수도 있습니다.
적응형 카드에 다음 템플릿 JSON을 입력합니다.
{ "type": "AdaptiveCard", "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "version": "1.5", "body": [ { "type": "TextBlock", "text": "Order summary", "wrap": true, "style": "heading" }, { "type": "FactSet", "facts": [ { "title": "Name", "value": "John Doe" }, { "title": "Phone number", "value": "(000) 000-0000" } ] }, { "type": "Container", "items": [ { "type": "FactSet", "facts": [ { "title": "1x", "value": "Steak" }, { "title": "2x", "value": "Side Rice" }, { "title": "1x", "value": "Soft Drink" } ], "spacing": "Small" } ], "spacing": "Small" } ] }
흐름이 실행되면 수신자는 Microsoft Teams의 에이전트에서 적응형 카드를 수신합니다.
사용자 응답을 기다립니다
중요
이 섹션에서는 Power Automate 흐름과 함께 사전 적응형 카드를 보내는 방법을 자세히 설명합니다. 사전 적응형 카드를 사용하면 사용자는 에이전트와의 비활성 대화에서 정보를 받을 수 있습니다. 활성 대화 중에 적응형 카드를 보내는 방법을 알아보려면 Copilot Studio에서 적응형 카드 표시를 참조하세요.
적응형 카드는 사용자 입력 수집을 지원합니다. 이러한 시나리오에서는 흐름이 계속되기 전에 사용자의 응답을 기다려야 합니다.
노트
Power Automate는 템플릿 기능을 사용하는 적응형 카드를 지원하지 않습니다.
이 예에서는 주문이 제출되기 전에 사용자가 변경할 수 있도록 하는 주문 확인 카드를 보냅니다.
Power Automate에서 흐름에서 카드를 보내려는 단계에서 Microsoft Teams 커넥터 작업 적응형 카드 게시 및 응답 대기를 추가합니다.
다음으로 게시에서 Power Virtual Agents(프리뷰)를 선택합니다.
게시 대상의 경우 봇과 채팅을 선택합니다.
메시지에 다음 템플릿 JSON을 입력합니다.
actions섹션의 속성은 사용자에게 제공되는 옵션을 결정합니다.{ "type": "AdaptiveCard", "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "version": "1.0", "body": [ { "type": "TextBlock", "text": "Order confirmation", "wrap": true, "style": "heading" }, { "type": "FactSet", "facts": [ { "title": "Name", "value": "John Doe" }, { "title": "Phone number", "value": "(000) 000-0000" } ] }, { "type": "Container", "items": [ { "type": "FactSet", "facts": [ { "title": "1x", "value": "Steak" }, { "title": "2x", "value": "Side Rice" }, { "title": "1x", "value": "Soft Drink" } ], "spacing": "Small" } ], "spacing": "Small" } ], "actions": [ { "type": "Action.Submit", "title": "Submit Order" }, { "type": "Action.Submit", "title": "Edit Order" } ] }업데이트 메시지에 수신자가 응답을 제공한 후 보게 될 업데이트 메시지를 입력하세요.
수신자에는 수신자의 이름 또는 이메일 주소를 입력합니다. 수신자 정보가 흐름의 이전 단계에서 가져온 경우 동적 콘텐츠를 사용할 수도 있습니다.
봇의 경우 카드를 보낼 에이전트를 선택하세요.
흐름이 실행되면 수신자는 Microsoft Teams의 에이전트에서 응답을 제공할 수 있는 적응형 카드를 받습니다.
수신자의 응답을 사용하려면 동적 콘텐츠 플라이아웃 메뉴에서 submitActionId를 선택합니다. 이 변수의 값은 사용자가 선택한 작업의 title이 됩니다.
여러 수신자에게 사전 메시지 보내기
일부 시나리오에서는 여러 받는 사람에게 동일한 자동 관리 메시지를 보낼 수 있습니다.
이 섹션에는 여러 수신자에게 메시지를 보내는 예가 포함되어 있습니다.
중요
이 토픽에 설명된 전제 조건은 각 수신자에게 적용됩니다.
예를 들어 한 작업에서 수신자 10명게게 동일한 메시지를 보낼 수 있습니다. 10명의 수신자 중 3명이 에이전트를 설치하지 않은 경우 해당 3명의 수신자는 메시지를 수신하지 않습니다.
팀원에게 보내기
이 예에서 에이전트는 팀 구성원에게 온라인 교육을 완료하라는 알림을 보냅니다.
Microsoft Teams 커넥터를 추가하고 Power Automate 흐름에서 팀 구하기 작업을 선택합니다.
팀에는 메시지를 보낼 구성원이 있는 팀을 선택합니다.
Office 365 그룹 커넥터를 추가하고 그룹 구성원 나열 작업을 선택합니다.
그룹 ID에 사용자 지정 값을 선택합니다.
팀 구하기 작업의 동적 콘텐츠에서 팀 ID 를 선택합니다.
Microsoft Teams 커넥터를 추가하고 채팅 또는 채널에 메시지 게시 작업을 선택합니다.
다음으로 게시에서 Power Virtual Agents(프리뷰)를 선택합니다.
게시 대상의 경우 봇과 채팅을 선택합니다.
봇의 경우 메시지를 보낼 에이전트를 선택하세요.
수신자에는 그룹 구성원 나열 작업에서 동적 콘텐츠 사용자 원칙 이름을 선택합니다.
메시지에는 보낼 메시지를 입력합니다.
흐름이 실행되면 팀의 각 사용자는 에이전트와의 비공개 채팅에서 사전 메시지를 받습니다.
보안 그룹에 보내기
이 예에서 에이전트는 보안 그룹에 온라인 교육을 완료하라는 미리 알림을 보냅니다.
Microsoft Entra ID 커넥터를 추가하고 Power Automate 흐름에서그룹 구성원 가져오기 작업을 선택합니다.
그룹 ID에 보안 그룹의 GUID를 입력합니다.
Microsoft Teams 커넥터를 추가하고 채팅 또는 채널에 메시지 게시 작업을 선택합니다.
다음으로 게시에서 Power Virtual Agents(프리뷰)를 선택합니다.
게시 대상의 경우 봇과 채팅을 선택합니다.
봇의 경우 메시지를 보낼 에이전트를 선택하세요.
수신자에는 그룹 구성원 가져오기 작업에서 동적 콘텐츠 그룹 구성원 사용자 원칙 이름을 선택합니다.
메시지에는 보낼 메시지를 입력합니다.
흐름이 실행되면 보안 그룹의 각 사용자는 에이전트와의 비공개 채팅에서 사전 메시지를 받습니다.
동시에 여러 수신자에게 사전 메시지 보내기
일반적으로 여러 수신자에게 사전 메시지를 보낼 때 에이전트은 메시지를 차례로 보냅니다. 그러나 어떤 상황에서는 동시에 여러 수신자에게 메시지를 보내는 것이 더 나을 수도 있습니다.
경고
Copilot Studio의 모든 사전 메시지는 Power Automate의 한도과 Microsoft Teams 커넥터의 제한 한도가 적용됩니다.
대규모 수신자 그룹에 메시지를 보내는 경우 제한에 도달하면 오류가 표시됩니다. 병렬 처리 수준을 낮추거나 그룹의 수신자 수를 줄일 수 있습니다.
각각에 적용 작업에서 세 개의 가로 점(. . .)을 선택한 다음 설정을 선택합니다.
동시성 제어를 켜고 병렬도를 설정합니다.
사전 메시지에 대한 고급 옵션 구성
Copilot Studio를 통해 Microsoft Teams 커넥터의 고급 옵션 표시에서 에이전트의 세부 동작을 제어할 수 있습니다.
보낸 메시지에 알림으로 레이블 지정
알림으로 레이블 지정은 메시지의 에이전트 이름 앞에 "알림 방법"이라는 텍스트가 있는지 여부를 제어합니다. 에이전트의 응답에 레이블을 지정하면 수신자가 문의에 대한 에이전트의 응답을 식별할 수 있습니다.
수신자가 현재 에이전트와 활성 채팅 중인 경우
수신자가 에이전트와 대화 중일 때 에이전트가 사전 메시지나 카드를 보내는 경우가 있습니다.
대화 흐름을 방해하지 않기 위해 대화가 끝날 때까지 사전 메시지 전송을 연기할 수 있습니다.
채팅이 활성인 경우 상자를 사용하면 동작을 제어할 수 있습니다.
보내기: 에이전트는 평소와 같이 사전 메시지를 보냅니다.
전송 안 함 및 성공: 에이전트는 수신자가 활성 대화에 있을 때 자동 관리 메시지를 보내지 않습니다. 상태 코드 300이 반환됩니다.
전송 안 함 및 실패: 에이전트는 수신자가 활성 대화에 있을 때 자동 관리 메시지를 보내지 않습니다. 흐름 실행은 실패로 표시됩니다.
수신자가 에이전트를 설치하지 않은 경우
에이전트는 Microsoft Teams에 에이전트를 설치한 받는 사람에게만 메시지를 전달할 수 있습니다. 수신자가 에이전트 설치를 원하지 않거나 에이전트를 제거했을 수 있습니다.
중요도가 낮은 메시지의 경우 받는 사람이 에이전트를 설치하지 않은 경우에도 흐름 실행이 성공한 것으로 표시되도록 설정할 수 있습니다.
봇이 설치되지 않은 경우 상자를 사용하면 동작을 제어할 수 있습니다.
실패: 수신자가 Microsoft Teams에 에이전트를 설치하지 않은 경우 흐름 실행은 실패로 표시됩니다.
상태 코드로 성공: 받는 사람이 에이전트를 설치하지 않았기 때문에 메시지를 받을 수 없더라도 흐름 실행은 성공한 것으로 표시됩니다. 상태 코드 100이 반환됩니다.
상태 코드 정의
반환된 상태 코드를 사용하여 흐름에서 다양한 후속 동작을 정의할 수 있습니다. 예를 들어 흐름이 일정 기간 동안 다시 시도하거나 실패에 대한 레코드를 로그하도록 지정할 수 있습니다.
| 상태 코드 | 성공(부울) | Description |
|---|---|---|
| 200 | 참 | 메시지가 성공적으로 전달되었습니다. |
| 100 | False | 수신자에게 에이전트가 설치되어 있지 않아 메시지를 전달할 수 없습니다. |
| 300 | False | 수신자가 에이전트와 대화 중이기 때문에 메시지를 전달할 수 없습니다. |