Note
이 도구는 기본적으로 다음 MCP 서버에서 제공됩니다: Dynamics 365 Customer Service.
이 문서에 나오는 도구와 예제들은 현재의 역량을 보여줍니다. 도구명, 설명, 매개변수, 응답 형식, 사용 가능한 기능은 시간이 지남에 따라 변할 수 있습니다.
에이전트, 통합, 오케스트레이션 로직을 만들 때 특정 도구명, 매개변수 구조, 도구 메타데이터, 응답 스키마에 의존성을 하드코딩하지 마세요. 대신, 실행 가능한 도구를 발견하고 활용할 수 있도록 솔루션을 설계하세요.
플랫폼이 발전함에 따라 Microsoft는 도구와 도구 메타데이터를 추가, 삭제, 이름 변경 또는 수정할 수 있습니다. 특정 도구 식별자가 아닌 역량을 기준으로 설계하면 서비스 업데이트 간 호환성을 유지하는 데 도움이 됩니다.
이 기능을 사용하여 특정 지식 문서의 전체 내용을 볼 수 있습니다.
용도
어시스턴트는 전체 내용, 저자, 평점, 키워드, 메타데이터 등 단일 지식 문서의 전체 세부 정보를 조회합니다. 이는 이미 어떤 기사가 필요한지 알고 있을 때 유용합니다 - 예를 들어 검색 결과나 동료의 참고문헌 등에서요.
문서를 문서 번호(예: KA-01001)나 내부 GUID로 검색할 수 있습니다.
예를 들어 다음과 같은 질문을 시도해 보세요
- "오픈 지식 문서 KA-01001"
- "기사 KA-01001의 세부 사항을 보여줘"
- "지식 기사 KA-02050"
- "KA-01001 기사는 뭐라고 말하고 있지?"
- "KB 기사 KA-01001 읽어보세요"
- "이 지식 기사의 전체 내용을 보여줘"
채팅에서 보게 될 내용
어시스턴트는 채팅에서 직접 기사 정보를 반환합니다. 응답에는 기사 제목, 기사 번호, 출판 상태, 본문 내용, 메타데이터, 그리고 링크가 있을 경우 Dynamics 365에서 기사를 열 수 있는 링크가 포함되어 있습니다.
유용한 팁
- 가장 직접적인 조회를 위해 문서 번호(KA-XXXXX)를 사용하세요. 기사 번호는 검색 결과나 Dynamics 365 지식 베이스에서 확인할 수 있습니다.
- 기사 번호를 모른다면, 먼저 "search knowledge articles"를 사용해 찾아보세요.
- 기사 내용은 전체 내용으로 표시되어 있어 Dynamics 365를 열지 않고도 채팅에서 직접 읽을 수 있습니다.
- 기사 내용을 활용해 고객에게 "이 기사를 사용해 답변을 작성하세요"라고 요청하면 답변을 작성할 수 있습니다.
Tip
동료가 기사 번호를 언급했다면, 직접 검색할 수 있습니다: "기사 KA-01001을 보여주세요."
다음에 수행되는 내용
기사를 본 후에는 다음과 같은 질문을 계속 사용할 수 있습니다:
- "이 기사를 사용해 답변 초안을 작성하세요"
- "이 기사 링크를 고객에게 보내세요"
- "이 주제에 관한 더 많은 기사를 검색하세요"
- "이 기사를 요약하세요"
이게 데이터에 영향을 미치나요?
아니요, 이것은 데이터를 변경하지 않습니다.
지식 문서 보는 것은 읽기 전용입니다. 기록은 수정되지 않습니다.
앱 내 채팅 구성 요소에서 할 수 있는 일들
채팅의 지식 기사 뷰어를 통해 다음과 같은 것을 할 수 있습니다:
- 모든 섹션과 형식화된 내용을 포함한 전체 기사 본문을 읽어보세요
- 문서 메타데이터(문서 번호, 상태, 출판일)를 참조하세요.
- 편집 또는 공유를 위해 Dynamics 365에서 문서를 열어 보세요
- 기사 내용에 대해 질문할 때는 후속 질문을 활용하세요
사전 요구 사항
이 도구는 다음을 요구합니다:
- 지식 관리
지식 관리 구성 항목에서 더 알아보세요.
도구 요약
| 재산 | Value |
|---|---|
| 사용자 이름 | 지식 기사 세부 정보 |
| 내부 공구 명칭 | get_knowledge_article |
| Purpose | 문서 ID(GUID) 또는 문서 번호(예: |
도구 동작
문서 ID(GUID) 또는 문서 번호(예: )로 단일 지식 문서의 전체 상세 기록을 검색합니다. KA-01001 전체 기사 본문, 저자, 평점, 메타데이터, 그리고 Dynamics 365 딥링크를 반환합니다. 사용자가 특정 문서를 지정할 때 사용; 자유 텍스트 검색 search_knowledge_articles을 위해서는 .
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
설정 안 함 | 기본 행동 (한 편의 기사를 읽음). |
destructiveHint |
설정 안 함 | 적용할 수 없습니다. |
idempotentHint |
설정 안 함 | 적용할 수 없습니다. |
openWorldHint |
설정 안 함 | 기본값(데이터버스 쿼리)을 사용합니다. |
입력 개념
문서 식별자
| 입력 | Description | 필수 |
|---|---|---|
articleId, articleNumber |
(GUID, 최대 38자) 또는 articleNumber (예: KA-01001, 최대 64자) 중 articleId 최소 한 개가 필요합니다. 두 가지 모두 공급 articleId 되면 우선권이 됩니다. |
예 |
응답 및 UI 동작
이 MCP 도구는 MCP 앱에서 지원됩니다.
응답 유형
채팅에서 문자 전용 답변
응답은 본문 내용, 저자, 평가, 키워드, 메타데이터, 그리고 Dynamics 365 링크가 있을 경우 포함된 전체 기사를 반환합니다.
라우팅 노트
다음과 같은 경우 get_knowledge_article를 사용합니다.
- 사용자는 특정 문서에 번호(예:
KA-01001)로 이름을 붙입니다 - 사용자는 알려진 기사에 대한 모든 세부 정보를 원합니다
- 결과에서
search_knowledge_articles깊이 파고들기
사용하지 마세요 get_knowledge_article :
- 사용자가 문서를 넘나 들며 검색하고 싶어 합니다 - 경로
search_knowledge_articles - 사용자가 새 문서를 만들고 싶어 - 경로로
draft_knowledge_article
관련 도구
| Tool | 관계 |
|---|---|
search_knowledge_articles |
쿼리별로 지식 베이스를 검색합니다. 증거 개시를 위한 사용; 알려진 문서에 대한 사용 get_knowledge_article |
draft_knowledge_article |
새 초안 문서를 작성합니다 |
데이터 돌연변이 분류
읽기 전용입니다.
수정 없이 기사 데이터를 검색합니다.