메모
이 도구는 기본적으로 다음 MCP 서버에서 제공됩니다: Dynamics 365 Customer Service.
이 문서에 나오는 도구와 예제들은 현재의 역량을 보여줍니다. 도구명, 설명, 매개변수, 응답 형식, 사용 가능한 기능은 시간이 지남에 따라 변할 수 있습니다.
에이전트, 통합, 오케스트레이션 로직을 만들 때 특정 도구명, 매개변수 구조, 도구 메타데이터, 응답 스키마에 의존성을 하드코딩하지 마세요. 대신, 실행 가능한 도구를 발견하고 활용할 수 있도록 솔루션을 설계하세요.
플랫폼이 발전함에 따라 Microsoft는 도구와 도구 메타데이터를 추가, 삭제, 이름 변경 또는 수정할 수 있습니다. 특정 도구 식별자가 아닌 역량을 기준으로 설계하면 서비스 업데이트 간 호환성을 유지하는 데 도움이 됩니다.
- "내 조직 목록"
- "다른 환경과 연결되고 싶어"
- "어떤 환경에 접근할 수 있지?"
- "조직 변경"
채팅에서 보게 될 내용
어시스턴트는 앱 내 채팅 구성 요소로 인터랙티브 환경 선택기를 표시합니다. 선택기는 모든 사용 가능한 환경과 그 이름, URL을 보여줍니다.
유용한 팁
- 여러 환경(프로덕션, 샌드박스, 테스트)이 있다면, 이 기능을 이용해 전환하세요.
- 환경을 선택한 후에는 모든 후속 작업(케이스 보기, 계정 보기)이 해당 조직의 데이터를 사용합니다.
- 전환 전에 분리할 필요는 없습니다. 그냥 '환경 전환'이라고 말하고 새 환경을 선택하면 됩니다.
Tip
어떤 환경을 사용할지 확신이 없다면, 팀의 생산 조직에 맞는 친근한 이름을 찾아보세요.
다음에 수행되는 내용
환경을 선택한 후에는 다음과 같은 프롬프트를 계속 사용할 수 있습니다:
- "내 가방을 보여줘"
- "내 계좌를 나열해라"
- "내 현재 환경은 어때?" (전환 확인)
이게 데이터에 영향을 미치나요?
아니요, 환경을 나열한다고 해서 데이터가 변경되지 않습니다.
피커에서 환경을 선택하면 세션 연결이 업데이트되지만 Dynamics 365 데이터는 변경되지 않습니다.
앱 내 채팅 구성 요소에서 할 수 있는 일들
채팅의 환경 선택기에서 다음과 같은 기능을 할 수 있습니다:
- 테넌트 내 모든 이용 가능한 환경을 둘러보세요
- 환경을 클릭하면 연결됩니다
- 환경 이름과 URL을 확인하여 올바른 조직을 식별하세요
Prerequisites
이 도구는 Dynamics 365 Customer Service MCP 서버에서 사용할 수 있습니다. 자세한 내용은 이 페이지 상단의 이용 가능 안내를 참고하세요. 추가 구성은 필요하지 않습니다.
도구 요약
| 재산 | Value |
|---|---|
| 사용자 이름 | 환경 목록 |
| 내부 공구 명칭 | list_environments |
| Purpose | 사용자가 테넌트에서 접근 가능한 모든 Dynamics 365 환경을 나열하고, 조직 선택 위젯을 렌더링합니다 |
도구 동작
사용자가 테넌트에서 접근 권한이 있는 모든 Dynamics 365 환경을 나열하고, 조직 선택 위젯을 렌더링합니다. 사용자가 조직 변경을 명시적으로 요청하거나, 모든 사용 가능한 환경을 확인하거나, 활성 조직이 없다고 할 때 get_environment 이 도구를 사용하세요.
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
true |
이 도구는 데이터를 수정하지 않습니다. |
destructiveHint |
설정 안 함 | 해당 없음 (읽기 전용 도구). |
idempotentHint |
설정 안 함 | 해당 없음 (읽기 전용 도구). |
openWorldHint |
설정 안 함 | 기본값(쿼리, 테넌트 발견)을 사용합니다. |
입력 개념
이 도구는 입력 매개변수를 전혀 받지 않습니다.
응답 및 UI 동작
이 MCP 도구는 MCP 앱에서 지원됩니다.
응답 유형
인터랙티브 위젯 (조직 선택기)
조직 선택 위젯은 모든 사용 가능한 환경을 친근한 이름과 URL로 표시합니다. 사용자는 환경을 클릭해 선택하고, 위젯에서 트리거가 작동합니다 select_environment .
라우팅 노트
다음과 같은 경우 list_environments를 사용합니다.
- 사용자가 명시적으로 환경을 바꾸거나 모든 사용 가능한 조직을 보고 싶다고 요청합니다
-
get_environment반환selectedOrg: null후 사용자는 하나를 선택해야 합니다 - 사용자가 "조직 변경", "환경 변경", "내 환경 보여줌"이라고 말합니다.
사용하지 마세요 list_environments :
- 현재 활성화된 환경만 확인하면 됩니다.
get_environment를 대신 사용하세요. - 사용자는 다시 연결하지 않고 연결을 끊고 싶어 합니다.
disconnect_environment를 대신 사용하세요.
관련 도구
| Tool | 관계 |
|---|---|
get_environment |
피커를 보여주지 않고 현재 활성 환경을 반환합니다 |
select_environment |
선택한 환경을 구합니다. org picker 위젯에 의해 호출됨 |
disconnect_environment |
활성 환경을 정리하고 조직 선택자를 보여줍니다 |
데이터 돌연변이 분류
읽기 전용입니다.