Note
이 도구는 기본적으로 다음 MCP 서버에서 제공됩니다: Dynamics 365 Customer Service.
이 문서에 나오는 도구와 예제들은 현재의 역량을 보여줍니다. 도구명, 설명, 매개변수, 응답 형식, 사용 가능한 기능은 시간이 지남에 따라 변할 수 있습니다.
에이전트, 통합, 오케스트레이션 로직을 만들 때 특정 도구명, 매개변수 구조, 도구 메타데이터, 응답 스키마에 의존성을 하드코딩하지 마세요. 대신, 실행 가능한 도구를 발견하고 활용할 수 있도록 솔루션을 설계하세요.
플랫폼이 발전함에 따라 Microsoft는 도구와 도구 메타데이터를 추가, 삭제, 이름 변경 또는 수정할 수 있습니다. 특정 도구 식별자가 아닌 역량을 기준으로 설계하면 서비스 업데이트 간 호환성을 유지하는 데 도움이 됩니다.
오타를 수정하거나 정보를 추가하거나 사건이나 기타 기록의 기존 메모를 수정하고 싶을 때 이 기능을 활용하세요.
용도
어시스턴트는 기존 노트의 식별자를 찾아 새로운 내용으로 텍스트를 업데이트합니다. 업데이트된 노트는 이전 버전의 레코드 타임라인을 대체합니다. 이것은 실수를 수정하거나 이전에 작성한 메모에 세부사항을 추가할 때 유용합니다.
예를 들어 다음과 같은 질문을 시도해 보세요
- "내 쪽지의 오타 고쳐줘"
- "고객이 우회 방법을 확인했다고 메모를 업데이트하세요"
- "이 사건에 대한 노트를 바꿔라"
- "내 마지막 노트를 수정해줘"
- "메모 텍스트에 새 전화번호를 포함시키기"
채팅에서 보게 될 내용
어시스턴트는 앱 내 채팅 구성 요소로 활동 타임라인을 표시하며, 업데이트된 노트 내용을 새로고침합니다.
유용한 팁
- 어시스턴트는 어떤 노트를 업데이트해야 하는지 알아야 합니다. 여러 개의 노트가 있다면 내용이나 제목으로 명시하세요.
- "노트를 업데이트하세요"라고 말하고 새 텍스트를 제공하거나, 모든 내용을 한 번에 포함시킬 수 있습니다.
- 소장한 노트만 업데이트할 수 있습니다.
- 기존 노트를 편집하는 대신 완전히 새로운 노트를 추가하고 싶다면, "노트 추가"라고 하세요.
Tip
먼저 타임라인을 확인해 기존 노트를 확인한 후, 어떤 노트를 업데이트할지 어시스턴트에게 알려주세요.
다음에 수행되는 내용
노트가 업데이트된 후에는 다음과 같은 프롬프트를 계속 사용할 수 있습니다:
- "타임라인 보여줘"
- "메모 하나 더"
- "고객에게 보내는 이메일 초안 작성"
- "이 사건에서 더 해야 할 일은 뭐야?"
이게 데이터에 영향을 미치나요?
네, 기존 노트를 업데이트합니다.
노트 텍스트는 제공하신 새로운 콘텐츠로 대체됩니다. 조수는 변경 전에 확인을 요청합니다.
앱 내 채팅 구성 요소에서 할 수 있는 일들
채팅의 타임라인에서 다음과 같은 정보를 얻을 수 있습니다:
- 업데이트된 노트를 맥락에서 확인하세요
- 전체 활동 타임라인을 둘러보기
- 세부 정보를 보려면 아무 활동이든 선택하세요
- Dynamics 365에서 전체 기록 양식을 열기
사전 요구 사항
이 도구는 Dynamics 365 Customer Service MCP 서버에서 사용할 수 있습니다. 자세한 내용은 이 페이지 상단의 이용 가능 안내를 참고하세요. 추가 구성은 필요하지 않습니다.
도구 요약
| 재산 | Value |
|---|---|
| 사용자 이름 | 업데이트 노트 |
| 내부 공구 명칭 | update_note |
| Purpose | Dynamics 365에서 기존 노트(주석)의 텍스트를 GUID로 업데이트합니다 |
도구 동작
Dynamics 365에서 기존 노트(주석)의 텍스트를 GUID로 업데이트합니다. 사용자가 오타를 수정하거나 기존 노트를 수정하거나 수정하고 싶을 때 사용하세요. 응답 annotationId 에서 get_activity_timeline 얻을 수 있습니다.
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
false |
이 도구는 데이터를 수정하며, Microsoft 365 Copilot은 확인을 요청합니다. |
destructiveHint |
false |
노트 업데이트는 내용을 대체하지만 파괴적이지는 않습니다. |
idempotentHint |
true |
같은 입력으로 호출해도 같은 결과가 나오며, 다시 시도해도 안전합니다. |
openWorldHint |
설정 안 함 | 기본값(데이터버스 쿼리)을 사용합니다. |
입력 개념
노트 식별자
| 입력 | Description | 필수 |
|---|---|---|
annotationId |
annotationId (업데이트용 주석 GUID, 필수). 에서 get_activity_timeline얻습니다. |
예 |
업데이트된 콘텐츠
| 입력 | Description | 필수 |
|---|---|---|
notetext, subject |
notetext (업데이트된 주석 본문 필수), subject (선택적으로 업데이트된 제목). |
다릅니다 |
응답 및 UI 동작
이 도구는 노트가 업데이트되었는지 확인하기 위해 활동 타임라인을 렌더링합니다.
이 MCP 도구는 MCP 앱에서 지원됩니다.
응답 유형
인터랙티브 컴포넌트 (앱-인-채팅)
타임라인 위젯이 새로고침되어 업데이트된 노트 내용을 보여줍니다.
라우팅 노트
다음 용도로 update_note를 사용하십시오.
- "음표를 고쳐라", "음표를 업데이트해라", "음표를 수정해라"
- 기존 주석의 텍스트나 제목에 대한 모든 수정
사용하지 마세요 update_note :
- 사용자가 새 노트를 만들고 싶어 - 다음을 사용하세요
create_note - 사용자가 타임라인 활동(작업, 전화 통화 등)을 업데이트하고 싶어 하는데,
create_activityactivityId
관련 도구
| Tool | 관계 |
|---|---|
create_note |
레코드에 새 노트를 생성합니다 |
get_activity_timeline |
노트를 포함한 타임라인 검색 (주석 출처) |
create_activity |
타임라인 활동 생성(주석 아님) |
데이터 돌연변이 분류
쓰기 / 돌연변이.
이 도구는 Dataverse의 기존 주석 레코드를 업데이트합니다. M365 Copilot은 실행 전에 사용자에게 확인을 요청합니다. 이 연산은 멼등원(멪등)으로, 같은 입력으로 재시도해도 같은 결과가 나옵니다.