엔터티 기록 보기

메모

이 도구는 기본적으로 다음 MCP 서버에서 제공됩니다: Dynamics 365 Customer Service. 이 문서에 나오는 도구와 예제들은 현재의 역량을 보여줍니다. 도구명, 설명, 매개변수, 응답 형식, 사용 가능한 기능은 시간이 지남에 따라 변할 수 있습니다.
에이전트, 통합, 오케스트레이션 로직을 만들 때 특정 도구명, 매개변수 구조, 도구 메타데이터, 응답 스키마에 의존성을 하드코딩하지 마세요. 대신, 실행 가능한 도구를 발견하고 활용할 수 있도록 솔루션을 설계하세요.
플랫폼이 발전함에 따라 Microsoft는 도구와 도구 메타데이터를 추가, 삭제, 이름 변경 또는 수정할 수 있습니다. 특정 도구 식별자가 아닌 역량을 기준으로 설계하면 서비스 업데이트 간 호환성을 유지하는 데 도움이 됩니다.

전용 뷰 명령어가 없는 Dataverse 엔터티 유형에 대해 특정 레코드의 전체 세부 정보를 보고 싶을 때 이 기능을 사용할 수 있습니다.

용도

어시스턴트가 지정한 레코드의 상세 양식 뷰를 엽니다. 모든 레코드 필드를 볼 수 있고, 지원되는 필드를 인라인에서 편집하며, Dynamics 365에서 전체 폼으로 이동할 수 있습니다. 이 방법은 기회, 리드, 대기열 항목, 커스텀 테이블 등 모든 엔터티 유형에 적용됩니다.

계정, 연락처, 사건의 경우, 보조는 더 풍부한 행동을 가진 전문 도구를 사용합니다. 이 도구는 다른 모든 것의 백업 수단입니다.

예를 들어 다음과 같은 질문을 시도해 보세요

  • "콘토소 거래 기회 공개"
  • "마리아 가르시아의 리드 세부사항 보여줘"
  • "대기열 항목 레코드 보기"
  • "이 예약 기록을 열어라"
  • "커스텀 엔티티 기록을 보여줘"
  • "이 작업을 보기"

채팅에서 보게 될 내용

어시스턴트는 채팅 앱 내 구성 요소로 인터랙티브 기록 양식을 표시합니다. 폼은 Dynamics 365 시스템 폼 구성에 따라 정의된 레코드의 필드를 보여줍니다.

유용한 팁

  • 레코드 이름이나 GUID를 사용해 특정 레코드를 열 수 있습니다.
  • 예를 들어, "Project Alpha를 위한 오픈 오퍼튜니티"처럼 엔터티 유형을 지정해야 합니다.
  • 계좌는 대신 "콘토소 계좌 개설"이라고 하세요. 연락처는 "조던과 연락 열어"라고 하세요. 케이스는 "오픈 케이스 CAS-01010-A0A0A0"이라고 말하세요.

Tip

기록 양식이 나타나면 "이 기록을 업데이트"하거나 "이 기록을 삭제"와 같은 후속 질문을 할 수 있습니다.

다음에 수행되는 내용

기록 양식이 나타난 후에는 다음과 같은 프롬프트로 계속 진행할 수 있습니다:

  • "이 기록의 필드를 업데이트한다"
  • "이 기록을 삭제해"
  • "이런 기록을 더 많이 나열해라"
  • "관련 기록 검색

이게 데이터에 영향을 미치나요?

아니요, 기록을 본다고 해서 데이터가 변하지 않습니다.

레코드 형식은 기본적으로 읽기 전용입니다. 폼에서 인라인 편집을 하면 데이터가 변경될 수 있습니다. 조수는 변경을 하기 전에 확인을 요청합니다.

앱 내 채팅 구성 요소에서 할 수 있는 일들

채팅의 기록 양식에서 다음과 같은 기능을 할 수 있습니다:

  • 모든 기록 양식 필드를 검토하세요
  • 지원 필드 인라인 편집
  • Dynamics 365에서 전체 기록 양식을 열기
  • 후속 안내를 받아 채팅에서 레코드를 계속 작업하세요

Prerequisites

이 도구는 Dynamics 365 Customer Service MCP 서버에서 사용할 수 있습니다. 자세한 내용은 이 페이지 상단의 이용 가능 안내를 참고하세요. 추가 구성은 필요하지 않습니다.

도구 요약

재산 Value
사용자 이름 엔터티 기록 보기
내부 공구 명칭 get_entity_record
Purpose 인라인 편집이 가능한 폼 기반 세부 뷰에서 Dataverse 엔티티에 대해 단일 레코드를 가져옵니다

도구 동작

인라인 편집이 가능한 폼 기반 상세 뷰에서 Dataverse 엔터티에 대해 단일 레코드를 검색합니다. 기회, 리드get_case, 맞춤 테이블과 같이 , 로 다루get_accountget_contact지 않는 엔터티 유형에 사용됩니다.

Annotations

Annotation Value Meaning
readOnlyHint 설정 안 함 실제로는 읽기 전용; 이 도구는 데이터를 직접 수정하지 않습니다.
destructiveHint 설정 안 함 해당 없음 (읽기 전용 도구).
idempotentHint 설정 안 함 해당 없음 (읽기 전용 도구).
openWorldHint 설정 안 함 기본값(데이터버스 쿼리)을 사용합니다.

입력 개념

엔터티 유형

입력 Description 필수
entityLogicalName entityLogicalName (문자열, 필수). Dataverse 엔터티의 논리 이름입니다. 예

레코드 식별자

입력 Description 필수
recordId recordId (문자열, 필수). GUID 또는 기본 이름으로 검색하세요. 예

형태 선택

입력 Description 필수
formId formId (문자열, 선택 사항). 렌더링에 사용할 GUID 시스템 폼입니다. No

응답 및 UI 동작

이 도구는 대화형 앱 내 엔티티 폼을 렌더링합니다.

이 MCP 도구는 MCP 앱에서 지원됩니다.

응답 유형

인터랙티브 폼 (상세 뷰)

폼은 선택한 시스템 폼에서 정의한 레코드의 필드를 표시합니다.

라우팅 노트

다음 용도로 get_entity_record를 사용하십시오.

  • 전용 세부 도구가 없는 어떤 엔티티 유형이든
  • "[엔티티 유형] [이름]을 열기", "[엔티티 유형] 세부 정보 보기"

프롬프트에 명시적으로 다음과 같은 표현을 사용하지 get_entity_record 마세요:

  • 계정 - 경로 get_account
  • 연락처 - 경로 get_contact
  • 사례 - 경로 get_case
  • "목록" 기록 - 경로 list_entity_records
Tool 관계
list_entity_records 동일한 법인 유형에 대한 기록 목록
update_entity_record 모든 엔티티 레코드의 필드를 업데이트합니다
delete_entity_record 모든 엔티티 레코드를 삭제합니다
get_account 전용 계정 상세 도구
get_contact 전용 연락처 디테일 도구
get_case 전용 케이스 디테일 도구

데이터 돌연변이 분류

읽기 전용 진입점과 하류 돌연변이 가능성이 있습니다.

폼 뷰 자체는 데이터를 변경하지 않습니다. 인라인 편집은 .을 통해 update_entity_record쓰기 작업을 트리거합니다.

  • Last updated on