Uppdateringsnot

Note

Detta verktyg är tillgängligt som standard på följande MCP-servrar: Dynamics 365 Customer Service. Verktygen och exemplen i denna dokumentation illustrerar nuvarande kapaciteter. Verktygsnamn, beskrivningar, parametrar, svarsformat och tillgänglig funktionalitet kan förändras över tid.
När du bygger agenter, integrationer eller orkestreringslogik, hårdkoda inte beroenden på specifika verktygsnamn, parameterstrukturer, verktygsmetadata eller svarsscheman. Designa istället din lösning för att upptäcka och använda tillgängliga verktyg vid körning.
När plattformen utvecklas kan Microsoft lägga till, ta bort, byta namn på eller ändra verktyg och verktygsmetadata. Att designa utifrån kapabiliteter istället för specifika verktygsidentifierare hjälper till att upprätthålla kompatibilitet mellan tjänsteuppdateringar.

Använd denna funktion när du vill rätta ett stavfel, lägga till information eller revidera en befintlig anteckning i ett ärende eller annan post.

Vad det gör

Assistenten hittar en befintlig anteckning via dess identifierare och uppdaterar texten med ditt nya innehåll. Den uppdaterade noten ersätter den tidigare versionen på skivans tidslinje. Detta är användbart för att rätta misstag eller lägga till detaljer i en anteckning du gjort tidigare.

Prova prompts som

  • "Rätta stavfelet i min lapp"
  • "Uppdatera lappen så att kunden bekräftade lösningen"
  • "Ändra anteckningen i det här fallet"
  • "Revidera min sista ton"
  • "Uppdatera lapptexten för att inkludera det nya telefonnumret"

Vad du kommer att se i chatten

Assistenten visar aktivitetstidslinjen som en app-i-chatt-komponent, uppdaterad för att visa det uppdaterade annoteringsinnehållet.

Användbara tips

  • Assistenten måste veta vilken anteckning som ska uppdateras. Om det finns flera anteckningar, ange efter innehåll eller titel.
  • Du kan säga "uppdatera anteckningen" och sedan ange den nya texten, eller inkludera allt i en prompt.
  • Endast anteckningar du äger kan uppdateras.
  • Om du vill lägga till en helt ny anteckning istället för att redigera en befintlig, säg "lägg till en anteckning."

Tip

Titta först på tidslinjen för att se befintliga anteckningar, och berätta sedan för assistenten vilken som ska uppdateras.

Vad händer härnäst

Efter att anteckningen har uppdaterats kan du fortsätta med prompts som:

  • "Visa tidslinjen"
  • "Lägg till en ton till"
  • "Skriv ett mejl till kunden"
  • "Vad mer behöver göras i det här fallet?"

Ändrar detta data?

Ja, detta uppdaterar en befintlig lapp.

Anmärkningstexten ersätts med det nya innehållet du tillhandahåller. Assistenten ber om bekräftelse innan hon gör ändringen.

Vad du kan göra från appen-i-chatt-komponenten

Från tidslinjen i chatten kan du:

  • Se den uppdaterade notisen i sitt sammanhang
  • Bläddra i hela aktivitetstidslinjen
  • Välj vilken aktivitet som helst för att se dess detaljer
  • Öppna hela postformuläret i Dynamics 365

Prerequisites

Detta verktyg finns tillgängligt på Dynamics 365 Customer Service MCP-servern. Se tillgänglighetsanmärkningen högst upp på denna sida för detaljer. Ingen ytterligare konfiguration krävs.

Verktygssammanfattning

Property Value
Användarvänligt namn Uppdateringsnot
Internt verktygsnamn update_note
Purpose Uppdaterar texten i en befintlig anmärkning (anmärkning) i Dynamics 365 med dess annotations-GUID

Verktygsbeteende

Uppdaterar texten i en befintlig anteckning (anmärkning) i Dynamics 365 med dess annotations-GUID. Använd när användaren vill rätta ett stavfel, revidera eller ändra en befintlig anteckning. Det annotationId kan erhållas från svaret get_activity_timeline .

Annotations

Anteckning Value Meaning
readOnlyHint false Detta verktyg ändrar data – Microsoft 365 Copilot ger bekräftelseprompter.
destructiveHint false Att uppdatera en anteckning ersätter innehållet men är inte destruktivt.
idempotentHint true Att anropa med samma indata ger samma resultat – säkert att försöka igen.
openWorldHint Inte angivet Använder standard (söker Dataverse).

Inmatningskoncept

Notidentifierare

Input Description Obligatoriskt
annotationId annotationId (annoterings-GUID för uppdatering, krävs). Hämta från get_activity_timeline. Ja

Uppdaterat innehåll

Input Description Obligatoriskt
notetext, subject notetext (uppdaterad anteckningstext, obligatorisk), subject (valfri uppdaterad titel). Varies

Respons och UI-beteende

Detta verktyg renderar aktivitetstidslinjen för att bekräfta att anteckningen har uppdaterats.

Detta MCP-verktyg stöds av en MCP-app.

Svarstyp

Interaktiv komponent (app i chatt)

Tidslinjewidgeten uppdateras för att visa det uppdaterade anteckningsinnehållet.

Ruttnoteringar

Användning update_note för:

  • "Fixa noten", "uppdatera noten", "revidera noten"
  • Varje redigering av en befintlig annoterings text eller titel

Använd inte update_note när:

  • Användaren vill skapa en ny anteckning - använd create_note
  • Användaren vill uppdatera en tidslinjeaktivitet (uppgift, telefonsamtal, etc.) – använda create_activity med activityId
Tool Förhållande
create_note Skapar en ny anteckning på en post
get_activity_timeline Hämtar tidslinje inklusive anteckningar (källa till annotationId)
create_activity Skapar tidslinjeaktiviteter (inte anteckningar)

Datamutationsklassificering

Skriv / mutation.

Detta verktyg uppdaterar en befintlig annoteringspost i Dataverse. M365 Copilot ber användaren om bekräftelse innan exekvering. Operationen är idempotent – om man försöker om med samma indata ger man samma resultat.

  • Last updated on