메모
이 도구는 기본적으로 다음 MCP 서버에서 제공됩니다: Dynamics 365 Customer Service.
이 문서에 나오는 도구와 예제들은 현재의 역량을 보여줍니다. 도구명, 설명, 매개변수, 응답 형식, 사용 가능한 기능은 시간이 지남에 따라 변할 수 있습니다.
에이전트, 통합, 오케스트레이션 로직을 만들 때 특정 도구명, 매개변수 구조, 도구 메타데이터, 응답 스키마에 의존성을 하드코딩하지 마세요. 대신, 실행 가능한 도구를 발견하고 활용할 수 있도록 솔루션을 설계하세요.
플랫폼이 발전함에 따라 Microsoft는 도구와 도구 메타데이터를 추가, 삭제, 이름 변경 또는 수정할 수 있습니다. 특정 도구 식별자가 아닌 역량을 기준으로 설계하면 서비스 업데이트 간 호환성을 유지하는 데 도움이 됩니다.
이 기능은 노트, 이메일, 작업 또는 기타 엔티티와 같이 Dynamics 365에서 레코드를 영구적으로 삭제해야 할 때 사용할 수 있습니다.
용도
어시스턴트는 Dynamics 365에서 특정 레코드를 삭제합니다. 이 방법은 메모, 이메일, 전화, 작업, 약속, 커스텀 엔티티 등 모든 엔티티 유형에 적용됩니다. 조수가 삭제하기 전에 확인을 요청합니다.
Important
이것은 하드 삭제입니다. 실행 취소가 없습니다. 한 번 기록이 삭제되면 복구할 수 없습니다.
예를 들어 다음과 같은 질문을 시도해 보세요
- "이 쪽지를 지워라"
- "이메일 기록을 삭제해라"
- "통화 기록 삭제"
- "이 임무를 제거해라"
- "예약 삭제해"
- "이 기록을 삭제해라"
채팅에서 보게 될 내용
어시스턴트가 채팅에서 확인 메시지와 함께 기록이 삭제되었다고 확인했습니다.
유용한 팁
- 어시스턴트는 항상 삭제 전에 확인을 요청합니다.
- 확인하기 전에 올바른 기록을 갖추세요. 삭제는 되돌릴 수 없습니다.
- Dynamics 365에서 엔티티 유형에 대해 삭제 권한이 있어야 합니다.
- 레코드를 삭제하는 대신 비활성화하고 싶다면, "이 레코드를 비활성화"라고 말하세요.
Tip
삭제에 대해 확신이 서지 않는다면, 먼저 "이 기록을 보여주세요"라고 표시하여 올바른 기록인지 확인하세요.
다음에 수행되는 내용
기록이 삭제된 후에는 다음과 같은 프롬프트로 계속 진행할 수 있습니다:
- "이 법인 유형의 기록 목록"
- "새 노트 작성"
- "내 가방을 보여줘"
이게 데이터에 영향을 미치나요?
네, 이 경우 데이터가 영구적으로 삭제됩니다.
이 기록은 Dynamics 365에서 삭제되며 복구할 수 없습니다. 조수는 진행하기 전에 확인을 요청합니다.
앱 내 채팅 구성 요소에서 할 수 있는 일들
삭제 후에는 컴포넌트가 확인 메시지를 보입니다. 삭제된 기록에 대한 추가 조치는 없습니다.
사전 요구 사항
이 도구는 Dynamics 365 Customer Service MCP 서버에서 사용할 수 있습니다. 자세한 내용은 이 페이지 상단의 이용 가능 안내를 참고하세요. 추가 구성은 필요하지 않습니다.
도구 요약
| 재산 | Value |
|---|---|
| 사용자 이름 | 엔터티 레코드 삭제 |
| 내부 공구 명칭 | delete_entity_record |
| Purpose | Dataverse 레코드를 엔티티 논리 이름과 레코드 ID로 삭제합니다 |
도구 동작
Dataverse 레코드를 엔티티 논리 이름과 레코드 ID로 삭제합니다. 메모, 이메일, 전화, 작업, 약속 등 모든 종류의 엔터티에 사용할 수 있습니다. 이건 되돌릴 수 없는 하드 삭제입니다. 사용자는 레코드의 소유 엔티티에 대해 삭제 권한을 가져야 합니다.
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
false |
이 도구는 데이터를 수정합니다. |
destructiveHint |
true |
이 도구는 하드 삭제를 수행합니다. |
idempotentHint |
true |
같은 입력으로 반복 호출하면 최종 효과는 동일합니다. |
openWorldHint |
설정 안 함 | 기본값(데이터버스 쿼리)을 사용합니다. |
입력 개념
엔터티 유형
| 입력 | Description | 필수 |
|---|---|---|
entityLogicalName |
entityLogicalName (문자열, 필수). Dataverse 엔터티 논리 이름(예: annotation, email, task, phonecall, ). appointment |
예 |
레코드 식별자
| 입력 | Description | 필수 |
|---|---|---|
recordId |
recordId (문자열, 필수). 삭제할 수 있는 레코드 GUID입니다. |
예 |
응답 및 UI 동작
이 도구는 앱 내 채팅 구성 요소에서 확인 메시지를 전달합니다.
이 MCP 도구는 MCP 앱에서 지원됩니다.
응답 유형
확인 메시지
답변에서는 해당 기록이 삭제되었다는 것을 확인해 줍니다. 삭제된 기록은 복구할 수 없습니다.
라우팅 노트
다음 용도로 delete_entity_record를 사용하십시오.
- 기록을 명시적으로 삭제, 삭제 또는 폐기하라는 모든 프롬프트
- 그리드나 폼 위젯에서 인라인 삭제 작업
사용하지 마세요 delete_entity_record :
-
사건 종료 - 경로
close_case -
레코드 비활성화 -
update_entity_record상태 코드 설정 사용 -
업데이트 또는 편집 - 경로
update_entity_record
관련 도구
| Tool | 관계 |
|---|---|
get_entity_record |
삭제 전에 레코드를 보기 |
update_entity_record |
레코드를 삭제하는 대신 업데이트하세요 |
create_note |
음표를 생성한다; delete는 이 동작을 되돌리면 됩니다 |
create_activity |
활동을 만들어; delete는 이 동작을 되돌리면 됩니다 |
데이터 돌연변이 분류
쓰기 연산(파괴적, 놪등성).
이 도구는 Dataverse 레코드에 대해 하드 삭제를 수행합니다. 실행 취소가 없습니다. 이 연산은 멪등법이며; 이미 삭제된 기록을 삭제해도 추가적인 효과는 없습니다.