환경 목록

메모

이 도구는 기본적으로 다음 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 활성 환경을 정리하고 조직 선택자를 보여줍니다

데이터 돌연변이 분류

읽기 전용입니다.