Note
이 도구는 기본적으로 다음 MCP 서버에서 제공됩니다: Dynamics 365 Customer Service.
이 문서에 나오는 도구와 예제들은 현재의 역량을 보여줍니다. 도구명, 설명, 매개변수, 응답 형식, 사용 가능한 기능은 시간이 지남에 따라 변할 수 있습니다.
에이전트, 통합, 오케스트레이션 로직을 만들 때 특정 도구명, 매개변수 구조, 도구 메타데이터, 응답 스키마에 의존성을 하드코딩하지 마세요. 대신, 실행 가능한 도구를 발견하고 활용할 수 있도록 솔루션을 설계하세요.
플랫폼이 발전함에 따라 Microsoft는 도구와 도구 메타데이터를 추가, 삭제, 이름 변경 또는 수정할 수 있습니다. 특정 도구 식별자가 아닌 역량을 기준으로 설계하면 서비스 업데이트 간 호환성을 유지하는 데 도움이 됩니다.
이 기능을 사용하여 특정 애플리케이션 프로필에서 레이아웃 구성을 제거하고 조직 수준의 기본값으로 되돌릴 수 있습니다.
용도
어시스턴트는 스코프 키로 프로필 스코프 레이아웃 구성을 제거합니다. 제거 후, 해당 프로필에 할당된 에이전트는 조직 수준의 구성(존재하는 경우)이나 시스템 기본값을 확인합니다. 이 행동은 명시적 확인이 필요합니다.
예를 들어 다음과 같은 질문을 시도해 보세요
- "L1 케이스 그리드 커스터마이징 제거"
- "2단계 요원의 프로필 레이아웃을 재설정하세요"
- "프로필 수준의 케이스 폼 구성을 삭제하세요"
- "이 프로필을 조직 기본값으로 되돌리세요"
채팅에서 보게 될 내용
어시스턴트는 설정을 제거하기 전에 확인을 요청합니다. 확인 후에는 어떤 프로필 설정이 제거되었는지 알려줍니다.
유용한 팁
- 우선 설정과 그 범위 키를 보려면 활성화 설정을 사용
list_profile_configs하세요. - 제거는 영구적입니다. 이 구성은 삭제 후에는 복구할 수 없습니다.
- 조직 단위 및 개인 선호도 구성에는 영향을 받지 않습니다.
다음에 수행되는 내용
- 제거 여부를 확인하기 위해 "프로필 구성 표시"
- "이 프로필에 새 레이아웃을 설정하세요" 대신 교체 파일을 생성하세요
- "조직 단위 구성 표시"를 통해 에이전트가 어떤 것으로 전환할지 확인할 수 있습니다
이게 데이터에 영향을 미치나요?
네, 이로 인해 데이터가 바뀔 수 있습니다.
사전 요구 사항
이 도구는 다음을 요구합니다:
- 시스템 관리자 또는 Copilot 서비스 관리자 역할
도구 요약
| 재산 | Value |
|---|---|
| 사용자 이름 | 프로필 구성 제거 |
| 내부 공구 명칭 | delete_profile_config |
| Purpose | 범위 키에 의해 애플리케이션 프로필에서 에이전트 구성을 제거합니다 |
도구 동작
범위 키에 의해 애플리케이션 프로필에서 에이전트 구성을 제거합니다. 사용자가 프로필 수준의 커스터마이징을 제거하거나 재설정할 때(예: "L1 그리드 레이아웃 재설정") 사용할 수 있습니다. 실수로 삭제되는 것을 방지하기 위해 명시적 확인이 필요합니다.
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
false |
이 도구는 데이터를 수정합니다. |
destructiveHint |
true |
이 도구는 구성 데이터를 영구적으로 제거합니다. |
idempotentHint |
true |
이미 제거된 스코프를 삭제해도 추가 효과는 없습니다. |
openWorldHint |
설정 안 함 | 기본값을 사용합니다. |
입력 개념
프로필 ID
| 입력 | Description | 필수 |
|---|---|---|
profileId |
profileId (UUID 문자열, 필수). 대상 애플리케이션 프로필의 경우 msdyn_appconfigurationid . |
예 |
스코프 키
| 입력 | Description | 필수 |
|---|---|---|
scope |
scope (문자열, 필수). 제거할 수 있는 스코프 키(예: grid:incident:*). 기존 스코프 키를 찾기 위해 사용 list_profile_configs 하세요. |
예 |
확인
| 입력 | Description | 필수 |
|---|---|---|
confirm, true |
confirm (문자 그대로 true, 필수). 삭제를 확인하려면 명시적으로 설정 true 되어야 합니다. |
예 |
응답 및 UI 동작
응답 유형
텍스트 전용
인터랙티브 컴포넌트는 렌더링되지 않습니다. 설정이 프로필에서 제거되었음을 확인하거나, 스코프 키를 찾지 못하면 오류가 표시됩니다.
라우팅 노트
다음과 같은 경우 delete_profile_config를 사용합니다.
- 사용자가 명시적으로 프로필 수준 구성을 제거해 달라고 요청합니다
- 사용자가 레이아웃 재설정을 요청할 때 특정 프로필이나 에이전트 등급을 언급합니다
- 사용자가 스코프 키를 지정하지 않았다면 항상 먼저 호출
list_profile_configs하세요
사용하지 마세요 delete_profile_config :
- 사용자는 조직 수준의 구성을 제거하고 싶어 합니다.
delete_agent_config를 대신 사용하세요. - 사용자가 개인적인 선호를 제거하고 싶어 합니다.
delete_user_prefs를 대신 사용하세요. - 사용자는 프로필 구성을 삭제하는 것이 아니라 수정하고 싶어 합니다.
save_profile_config를 대신 사용하세요.
관련 도구
| Tool | 관계 |
|---|---|
list_profile_configs |
스코프 키를 식별하기 위한 기존 프로필 구성을 나열합니다 |
save_profile_config |
프로필 수준 구성을 생성하거나 업데이트합니다 |
delete_agent_config |
조직 단위 구성을 제거합니다 |
delete_user_prefs |
개인 레이아웃 선호도를 제거함 |
데이터 돌연변이 분류
쓰기 (파괴적).
애플리케이션 프로필에서 에이전트 구성을 영구적으로 제거합니다. 해당 프로필에 배정된 모든 요원에게 영향을 미칩니다. 조수는 실행 전에 확인을 요청합니다.