메모
이 도구는 기본적으로 다음 MCP 서버에서 제공됩니다: Dynamics 365 Customer Service.
이 문서에 나오는 도구와 예제들은 현재의 역량을 보여줍니다. 도구명, 설명, 매개변수, 응답 형식, 사용 가능한 기능은 시간이 지남에 따라 변할 수 있습니다.
에이전트, 통합, 오케스트레이션 로직을 만들 때 특정 도구명, 매개변수 구조, 도구 메타데이터, 응답 스키마에 의존성을 하드코딩하지 마세요. 대신, 실행 가능한 도구를 발견하고 활용할 수 있도록 솔루션을 설계하세요.
플랫폼이 발전함에 따라 Microsoft는 도구와 도구 메타데이터를 추가, 삭제, 이름 변경 또는 수정할 수 있습니다. 특정 도구 식별자가 아닌 역량을 기준으로 설계하면 서비스 업데이트 간 호환성을 유지하는 데 도움이 됩니다.
이 기능은 세션을 특정 Dynamics 365 환경에 연결하여 이후 모든 작업이 해당 조직의 데이터를 사용하게 합니다.
용도
환경 선택기에서 환경을 클릭하면 어시스턴트가 당신의 세션을 그 조직에 연결합니다. 이후 모든 동작(사례 보기, 계정, 연락처 등)은 선택한 환경의 데이터를 자동으로 사용합니다. 보통 이 명령을 직접 발동할 필요는 없습니다; 피커에서 환경을 클릭할 때 발생합니다.
예를 들어 다음과 같은 질문을 시도해 보세요
보통 프롬프트를 타이핑할 필요는 없습니다. 선택기에서 환경을 클릭하면 자동으로 발생합니다. 환경을 바꿔야 한다면:
- "스위치 환경" (피커 표시)
- "내 환경을 보여줘" (피커 표시)
채팅에서 보게 될 내용
어시스턴트가 연결된 환경을 확인하며 환경 이름을 보여줍니다. 이 확인 후에는 해당 조직의 데이터를 다루기 시작할 수 있습니다.
유용한 팁
- 환경 ID를 수동으로 입력할 필요는 없습니다. 대신 환경 선택기를 사용하세요.
- 연결 후에는 어시스턴트가 답변에 환경 이름을 포함시켜 항상 자신이 어떤 조직에서 일하는지 알 수 있게 합니다.
- 만약 실수로 잘못된 환경에 접속했다면, "환경 전환"이라고 말하면 다시 선택할 수 있습니다.
다음에 수행되는 내용
환경에 접속한 후:
- "내 가방을 보여줘"
- "내 계좌를 나열해라"
- "내 받은 편지함에는 뭐가 있지?"
- "어떤 환경에 연결되어 있나요?" (확인 위해)
이게 데이터에 영향을 미치나요?
아니요, 이 변경은 Dynamics 365 데이터를 변경하지 않습니다.
세션 연결만 업데이트합니다. Dynamics 365의 레코드는 수정되지 않습니다.
Prerequisites
이 도구는 Dynamics 365 Customer Service MCP 서버에서 사용할 수 있습니다. 자세한 내용은 이 페이지 상단의 이용 가능 안내를 참고하세요. 추가 구성은 필요하지 않습니다.
도구 요약
| 재산 | Value |
|---|---|
| 사용자 이름 | 선택 환경 |
| 내부 공구 명칭 | select_environment |
| Purpose | 현재 세션을 위한 Dynamics 365 환경을 선택합니다 |
도구 동작
현재 세션을 위한 Dynamics 365 환경을 선택합니다. 이후 모든 도구 호출(케이스, 지식, 계정 등)은 자동으로 이 환경으로 라우팅됩니다. 이 도구는 일반적으로 사용자가 환경을 클릭할 때 모델이 직접 호출하는 대신 조직 선택 위젯에서 호출됩니다.
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
false |
이 도구는 세션 상태를 수정합니다. |
destructiveHint |
false |
환경을 선택하는 것이 데이터를 파괴하지 않습니다. |
idempotentHint |
true |
같은 환경을 두 번 선택해도 추가적인 영향은 없습니다. |
openWorldHint |
설정 안 함 | 기본값을 사용합니다. |
입력 개념
환경 ID
| 입력 | Description | 필수 |
|---|---|---|
environmentId |
environmentId (문자열, 필수). 환경을 선택하는 조직 GUID. 이것은 또는 list_environments에 의해 get_environment 반환되는 id 필드입니다. |
예 |
응답 및 UI 동작
응답 유형
텍스트 전용
인터랙티브 컴포넌트는 렌더링되지 않습니다. 조직 선택 위젯은 이 도구를 호출한 후 자신의 상태를 긍정적으로 업데이트합니다. 응답은 선택한 환경명과 ID를 확인합니다.
라우팅 노트
select_environment 백엔드 작업 도구입니다. 이 기능은 거의 항상 직접 모델 라우팅이 아니라 조직 선택 위젯에서 호출됩니다.
- "조직 전환"
select_environment같은 사용자 프롬프트를 . 대신 피커를 보여주는 데 사용list_environments하세요. - 이전 응답에서 확인된 환경 GUID가 있을 때만 직접 전화
select_environment하세요.
관련 도구
| Tool | 관계 |
|---|---|
get_environment |
현재 활동 중인 환경을 반환합니다 |
list_environments |
사용자가 선택할 수 있는 조직 선택 위젯을 보여줍니다 |
disconnect_environment |
활동적인 환경을 정리합니다 |
데이터 돌연변이 분류
Write (세션 상태).
세션의 능동적 환경을 수정합니다. Dynamics 365 데이터는 변경되지 않습니다.