Note
이 도구는 기본적으로 다음 MCP 서버에서 제공됩니다: Dynamics 365 Customer Service.
이 문서에 나오는 도구와 예제들은 현재의 역량을 보여줍니다. 도구명, 설명, 매개변수, 응답 형식, 사용 가능한 기능은 시간이 지남에 따라 변할 수 있습니다.
에이전트, 통합, 오케스트레이션 로직을 만들 때 특정 도구명, 매개변수 구조, 도구 메타데이터, 응답 스키마에 의존성을 하드코딩하지 마세요. 대신, 실행 가능한 도구를 발견하고 활용할 수 있도록 솔루션을 설계하세요.
플랫폼이 발전함에 따라 Microsoft는 도구와 도구 메타데이터를 추가, 삭제, 이름 변경 또는 수정할 수 있습니다. 특정 도구 식별자가 아닌 역량을 기준으로 설계하면 서비스 업데이트 간 호환성을 유지하는 데 도움이 됩니다.
이 기능을 활용할 때, 전용 리스트 명령이 없는 Dataverse 엔티티 유형의 레코드를 탐색하고 싶을 때 활용하세요. 예를 들어 기회, 리드, 큐 항목, 커스텀 테이블 등이 있습니다.
용도
조수는 지정한 사업체 유형에 대한 기록 목록을 보여줍니다. 이름으로 검색하고 결과 수를 제한할 수 있습니다. 이 도구는 Dynamics 365 환경에서 모든 엔티티 유형에 적용되는 범용 레코드 목록 도구입니다.
계정, 연락처, 사건의 경우, 어시스턴트는 더 풍부한 필터링을 제공하는 전문 도구를 사용합니다. 이 도구는 다른 모든 것의 백업 수단입니다.
예를 들어 다음과 같은 질문을 시도해 보세요
- "모든 대기 항목 보여줘"
- "기회 목록"
- "리드 목록"
- "내 커스텀 엔티티 기록을 보여줘"
- "열린 기회를 탐색하기"
- "모든 임명 목록"
- "작업 기록 보여줘"
채팅에서 보게 될 내용
어시스턴트는 채팅 앱 구성 요소로 인터랙티브 레코드 목록을 표시합니다. 목록은 기본 이름과 키 열을 포함한 일치하는 레코드를 보여줍니다.
유용한 팁
- 예를 들어 "기회 목록"이나 "리드 표시" 같은 법인 유형을 명시해야 합니다.
- 특정 기록을 검색할 때는 이름을 사용하세요. 예를 들어 "Project Alpha를 위한 기회 목록"과 같이
- 계정은 "계정 목록"이라고 하세요. 연락처는 "연락처 목록"이라고 하세요. 사례는 "사례 목록"이라고 말하세요.
- 최대 결과는 200개입니다.
Tip
기록 목록이 나타난 후에는 표시된 기록에 대해 후속 질문을 할 수 있습니다. 예를 들어, "첫 번째 레코드를 열기" 또는 "이 레코드를 업데이트하세요."
다음에 수행되는 내용
목록이 나타난 후에는 다음과 같은 프롬프트로 계속 진행할 수 있습니다:
- "첫 번째 레코드를 열어라"
- "이 음반의 세부 정보 보여줘"
- "이 기록의 필드를 업데이트한다"
- "이 기록을 삭제해"
이게 데이터에 영향을 미치나요?
아니요, 기록을 나열한다고 해서 데이터가 바뀌지 않습니다.
기록 목록은 읽기 전용입니다. 목록에서의 후속 조치, 예를 들어 레코드의 업데이트 또는 삭제는 데이터를 변경할 수 있습니다. 조수는 변경을 하기 전에 확인을 요청합니다.
앱 내 채팅 구성 요소에서 할 수 있는 일들
채팅의 기록 목록에서 다음과 같은 것을 할 수 있습니다:
- 정렬 가능한 그리드에서 일치하는 기록을 스캔하고 검토하세요
- 자세한 내용을 보려면 기록을 선택하세요
- Dynamics 365에서 전체 기록 양식을 열기
- 후속 안내를 받아 채팅에서 레코드를 계속 작업하세요
사전 요구 사항
이 도구는 Dynamics 365 Customer Service MCP 서버에서 사용할 수 있습니다. 자세한 내용은 이 페이지 상단의 이용 가능 안내를 참고하세요. 추가 구성은 필요하지 않습니다.
도구 요약
| 재산 | Value |
|---|---|
| 사용자 이름 | 목록 엔터티 기록 |
| 내부 공구 명칭 | list_entity_records |
| Purpose | 정렬 가능하고 필터링 가능한 그리드 내에서 Dataverse 엔티티의 레코드를 검색합니다 |
도구 동작
정렬 가능하고 필터링 가능한 격자에서 Dataverse 엔티티의 레코드를 검색합니다. 기회, 리드, 큐 항목, 커스텀 테이블 등 전용 리스트 도구가 없는 엔티티 유형에 사용하세요. 핵심 법인 유형(계정, 연락처, 케이스, 지식)의 경우, 이름 목록 도구를 사용하세요.
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
설정 안 함 | 실제로는 읽기 전용; 이 도구는 데이터를 수정하지 않습니다. |
destructiveHint |
설정 안 함 | 해당 없음 (읽기 전용 도구). |
idempotentHint |
설정 안 함 | 해당 없음 (읽기 전용 도구). |
openWorldHint |
설정 안 함 | 기본값(데이터버스 쿼리)을 사용합니다. |
입력 개념
엔터티 유형
| 입력 | Description | 필수 |
|---|---|---|
entityLogicalName |
entityLogicalName (문자열, 필수). Dataverse 엔터티 논리 이름(예: opportunity, lead, queueitem). |
예 |
Search
| 입력 | Description | 필수 |
|---|---|---|
search |
search (문자열, 선택 사항). 사업체의 기본 이름 속성에 대한 자유 텍스트 검색. |
No |
결과 제한
| 입력 | Description | 필수 |
|---|---|---|
top |
top (정수, 선택 사항). 최대 기록 반환. 기본적으로 조직 페이지 크기 설정(관리자가 변경하지 않는 한 25)으로 설정되어 있고, 최대 200입니다. |
No |
응답 및 UI 동작
이 도구는 대화형 앱 내 엔티티 그리드를 렌더링합니다.
이 MCP 도구는 MCP 앱에서 지원됩니다.
응답 유형
인터랙티브 그리드(리스트 뷰)
그리드는 레코드의 기본 이름과 키 열을 표시합니다. 사용자는 .를 통해 get_entity_record기록 세부 정보를 드릴링할 행을 선택할 수 있습니다.
라우팅 노트
다음 용도로 list_entity_records를 사용하십시오.
- 전용 리스트 도구가 없는 모든 엔터티 유형(기회, 리드, 큐 항목, 커스텀 테이블)
- "List [Entity Type]"([Entity Type])는 계정, 연락처, 사례, 지식 또는 평가가 아닌 경우에 해당합니다
프롬프트에 명시적으로 다음과 같은 표현을 사용하지 list_entity_records 마세요:
-
회계 - 경로
list_accounts -
연락처 - 경로
list_contacts -
케이스 - 경로
list_cases -
지식 문서 - 경로
search_knowledge_articles -
평가 - 경로
list_evaluations -
엔티티를 가로지르는 자유 텍스트 검색 - 경로
search_entities -
단일 레코드의 폼 뷰 - 경로
get_entity_record
관련 도구
| Tool | 관계 |
|---|---|
get_entity_record |
그리드에서 단일 레코드의 폼 뷰를 엽니다 |
update_entity_record |
모든 엔티티 레코드의 필드를 업데이트합니다 |
delete_entity_record |
모든 엔티티 레코드를 삭제합니다 |
search_entities |
법인 유형 간 자유 텍스트 검색 |
list_accounts |
전용 계정 목록과 계정별 필터 |
list_contacts |
전용 연락처 목록과 연락처별 필터 |
list_cases |
전용 케이스 목록과 케이스별 필터 |
데이터 돌연변이 분류
읽기 전용 진입점과 하류 돌연변이 가능성이 있습니다.
목록 자체는 데이터를 변경하지 않습니다. 그리드에서 추가 작업(업데이트, 삭제)은 별도의 도구를 통해 쓰기 작업을 촉발할 수 있습니다.