Note
이 도구는 기본적으로 다음 MCP 서버에서 제공됩니다: Dynamics 365 Customer Service.
이 문서에 나오는 도구와 예제들은 현재의 역량을 보여줍니다. 도구명, 설명, 매개변수, 응답 형식, 사용 가능한 기능은 시간이 지남에 따라 변할 수 있습니다.
에이전트, 통합, 오케스트레이션 로직을 만들 때 특정 도구명, 매개변수 구조, 도구 메타데이터, 응답 스키마에 의존성을 하드코딩하지 마세요. 대신, 실행 가능한 도구를 발견하고 활용할 수 있도록 솔루션을 설계하세요.
플랫폼이 발전함에 따라 Microsoft는 도구와 도구 메타데이터를 추가, 삭제, 이름 변경 또는 수정할 수 있습니다. 특정 도구 식별자가 아닌 역량을 기준으로 설계하면 서비스 업데이트 간 호환성을 유지하는 데 도움이 됩니다.
이 기능을 사용하여 서비스 에이전트에 대한 개인 레이아웃 선호도를 확인할 수 있습니다.
용도
어시스턴트는 저장한 모든 개인 레이아웃 선호도를 나열합니다. 개인 선호도를 통해 격자, 양식, 타임라인이 다른 사용자에게 영향을 주지 않고 어떻게 보이는지 맞춤 설정할 수 있습니다.
각 선호 항목에는 범위, 이름, 레이아웃 패치 수, 그리고 마지막으로 수정된 시기가 표시됩니다.
예를 들어 다음과 같은 질문을 시도해 보세요
- "내 저장된 환경설정 보여줘"
- "내가 개인적으로 어떤 커스터마이징을 할 수 있지?"
- "내 레이아웃 선호도를 나열해"
- "내 커스텀 케이스 그리드 설정 보여줘"
채팅에서 보게 될 내용
어시스턴트는 각 항목의 엔터티, 범위, 패치 수를 포함한 개인 선호도를 텍스트로 요약해 보여줍니다.
유용한 팁
- 개인 선호도는 계정 단위 및 프로필 단위 설정 모두를 우선시합니다.
- 당신의 선호도는 세션과 기기 간에 동일하게 유지됩니다.
- 이 도구를 사용해 사용자 정의를 리셋하기 전에 점검하세요.
다음에 수행되는 내용
- 개인 레이아웃을 추가하거나 업데이트하려면 "새 선호도 저장"
- "케이스 그리드에 대한 내 선호도를 삭제하세요"라는 특정 커스터마이징을 제거하세요
- "조직 수준 구성 표시"를 통해 기본 레이아웃을 확인하세요
이게 데이터에 영향을 미치나요?
아니요, 이것은 데이터를 변경하지 않습니다.
사전 요구 사항
이 도구는 Dynamics 365 Customer Service MCP 서버에서 사용할 수 있습니다. 자세한 내용은 이 페이지 상단의 이용 가능 안내를 참고하세요. 추가 구성은 필요하지 않습니다.
도구 요약
| 재산 | Value |
|---|---|
| 사용자 이름 | 내 선호 목록 |
| 내부 공구 명칭 | list_user_prefs |
| Purpose | 현재 사용자의 모든 개인 레이아웃 선호도를 나열합니다 |
도구 동작
현재 사용자의 모든 개인 레이아웃 선호도를 나열합니다. 각 저장 환경의 범위, 이름, 패치 수, 마지막 수정 날짜를 보여줍니다. 개인적인 선호도는 대화와 기기 전반에 걸쳐 유지되어, 사용자가 다른 사람에게 영향을 주지 않으면서 자신의 상담원 경험을 맞춤화할 수 있습니다.
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
true |
이 도구는 데이터를 수정하지 않습니다. |
destructiveHint |
설정 안 함 | 해당 없음 (읽기 전용 도구). |
idempotentHint |
설정 안 함 | 해당 없음 (읽기 전용 도구). |
openWorldHint |
설정 안 함 | 기본값을 사용합니다. |
입력 개념
엔터티 필터
| 입력 | Description | 필수 |
|---|---|---|
entityLogicalName |
entityLogicalName (문자열, 선택 사항). 제공되면 해당 엔터티에 대한 선호도만 반환합니다. 모든 개인적 선호는 나열하지 않겠습니다. |
No |
응답 및 UI 동작
응답 유형
텍스트 전용
인터랙티브 컴포넌트는 렌더링되지 않습니다. 사용자의 개인 선호도를 스코프 키, 이름, 패치 수, 마지막 수정 타임스탬프와 함께 구조화된 목록을 반환합니다.
라우팅 노트
다음과 같은 경우 list_user_prefs를 사용합니다.
- 사용자는 자신의 저장 환경이나 개인 맞춤 설정에 대해 묻습니다
- 사용자는 "내 선호도", "내 레이아웃", 또는 "내 커스터마이징"이라고 말합니다.
- 사용자 선호 삭제 작업 전에 범위 키를 보여줘야 합니다
사용하지 마세요 list_user_prefs :
- 사용자가 조직 단위 구성에 대해 묻습니다.
list_agent_configs를 대신 사용하세요. - 사용자가 프로필 수준 설정에 대해 묻습니다.
list_profile_configs를 대신 사용하세요. - 사용자는 관리자로서 모든 사용자의 선호도(지원되지 않음, 각 사용자는 자신의 설정만 봅니다)를 묻는 관리자입니다.
관련 도구
| Tool | 관계 |
|---|---|
save_user_prefs |
개인적인 레이아웃 선호도를 절약해 줍니다 |
delete_user_prefs |
스코프 키에 의한 개인 레이아웃 선호도를 제거합니다 |
list_agent_configs |
조직 단위 구성 목록 (관리자 뷰) |
browse_agent_config_options |
구성 옵션을 탐색하는 인터랙티브 가이드 |
데이터 돌연변이 분류
읽기 전용입니다.