메모
이 도구는 기본적으로 다음 MCP 서버에서 제공됩니다: Dynamics 365 Customer Service.
이 문서에 나오는 도구와 예제들은 현재의 역량을 보여줍니다. 도구명, 설명, 매개변수, 응답 형식, 사용 가능한 기능은 시간이 지남에 따라 변할 수 있습니다.
에이전트, 통합, 오케스트레이션 로직을 만들 때 특정 도구명, 매개변수 구조, 도구 메타데이터, 응답 스키마에 의존성을 하드코딩하지 마세요. 대신, 실행 가능한 도구를 발견하고 활용할 수 있도록 솔루션을 설계하세요.
플랫폼이 발전함에 따라 Microsoft는 도구와 도구 메타데이터를 추가, 삭제, 이름 변경 또는 수정할 수 있습니다. 특정 도구 식별자가 아닌 역량을 기준으로 설계하면 서비스 업데이트 간 호환성을 유지하는 데 도움이 됩니다.
이 기능을 활용해 케이스, 계정 또는 기타 데이터를 다루기 전에 현재 어떤 Dynamics 365 환경에 연결되어 있는지 확인하세요.
용도
어시스턴트가 현재 세션을 확인하고 어떤 Dynamics 365 환경이 활성화되어 있는지 알려줍니다. 이 과정은 대화 시작 시 자동으로 이루어집니다. 만약 환경이 연결되어 있지 않으면, 어시스턴트가 하나를 선택하라고 안내합니다.
예를 들어 다음과 같은 질문을 시도해 보세요
- "어떤 환경에 연결되어 있나요?"
- "내가 쓰는 조직은 뭐야?"
- "내가 Dynamics와 연결되어 있나?"
- "내 현재 환경을 보여줘"
채팅에서 보게 될 내용
어시스턴트는 연결된 환경의 이름과 세부 정보를 보여주는 문자 메시지로 응답합니다. 어떤 환경에도 연결되어 있지 않다면, 어시스턴트가 알려주고 환경 선택자에게 보여줄 수 있습니다.
유용한 팁
- 이 검사는 새 대화를 시작할 때 자동으로 이루어집니다. 보통 명확하게 물어볼 필요는 없습니다.
- 만약 어시스턴트가 환경이 선택되지 않았다고 하면, "내 환경을 보여줘"라고 말하면 선택자를 볼 수 있습니다.
- 응답에 표시되는 환경 이름은 올바른 조직에서 일하고 있는지 확인하는 데 도움이 됩니다(예: 프로덕션과 테스트 중 하나).
다음에 수행되는 내용
- "내 환경을 보여주세요" (전환이 필요하면)
- "내 사례를 나열하세요" (연결된 환경에서 일하기 위해)
- "이 환경과 단절" (조직을 바꾸고 싶을 때)
이게 데이터에 영향을 미치나요?
아니요, 이것은 데이터를 변경하지 않습니다.
사전 요구 사항
이 도구는 Dynamics 365 Customer Service MCP 서버에서 사용할 수 있습니다. 자세한 내용은 이 페이지 상단의 이용 가능 안내를 참고하세요. 추가 구성은 필요하지 않습니다.
도구 요약
| 재산 | Value |
|---|---|
| 사용자 이름 | 활발한 환경 확보 |
| 내부 공구 명칭 | get_environment |
| Purpose | 이 세션에서 현재 선택된 Dynamics 365 환경을 반환합니다 |
도구 동작
이 세션에서 현재 선택된 Dynamics 365 환경을 반환합니다. 이 도구는 다른 어떤 도구보다 먼저 세션 시작 시 호출되어 사용자가 어떤 조직에 연결되어 있는지 확인합니다. 환경이 선택되지 않으면, 응답은 사용자가 를 통해 list_environments하나를 선택하도록 안내해야 함을 나타냅니다.
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
true |
이 도구는 데이터를 수정하지 않습니다. |
destructiveHint |
설정 안 함 | 해당 없음 (읽기 전용 도구). |
idempotentHint |
설정 안 함 | 해당 없음 (읽기 전용 도구). |
openWorldHint |
설정 안 함 | 기본값(쿼리 세션 상태)을 사용합니다. |
입력 개념
이 도구는 입력 매개변수를 전혀 받지 않습니다.
응답 및 UI 동작
응답 유형
텍스트 전용
인터랙티브 컴포넌트는 렌더링되지 않습니다. 응답은 선택한 조직의 friendlyName, , id연결 정보를 구조화된 JSON 형식으로 반환합니다. 조직이 선택되지 않으면 는 selectedOrg null입니다.
라우팅 노트
세션 초기화자로 사용 get_environment 하세요. 다른 어떤 도구보다 먼저 모든 대화 시작 시 자동으로 호출되어야 합니다.
-
selectedOrg응답에서 null이라면, 조직 선택 위젯을 보여주기 위해 후속 조치list_environments하세요. - 사용자가 명시적으로 환경 전환을 요청하거나 모든 환경을 보라고 요청할 때 는 사용하지
get_environment마세요.list_environments를 대신 사용하세요.
관련 도구
| Tool | 관계 |
|---|---|
list_environments |
모든 사용 가능한 환경이 포함된 조직 선택 위젯을 보여줍니다 |
select_environment |
세션 중 선택한 환경을 저장합니다 |
disconnect_environment |
활성 환경을 정리하고 조직 선택자를 보여줍니다 |
데이터 돌연변이 분류
읽기 전용입니다.