Nota de actualización

Note

Esta herramienta está disponible por defecto en los siguientes servidores MCP: Dynamics 365 Customer Service. Las herramientas y ejemplos de esta documentación ilustran las capacidades actuales. Los nombres de las herramientas, descripciones, parámetros, formatos de respuesta y funcionalidades disponibles pueden cambiar con el tiempo.
Cuando construyas agentes, integraciones o lógica de orquestación, no codees dependencias en nombres específicos de herramientas, estructuras de parámetros, metadatos de herramientas o esquemas de respuesta. En su lugar, diseña tu solución para descubrir y utilizar las herramientas disponibles en tiempo de ejecución.
A medida que la plataforma evoluciona, Microsoft podría añadir, eliminar, renombrar o modificar herramientas y metadatos de herramientas. Diseñar según capacidades en lugar de identificadores específicos de herramientas ayuda a mantener la compatibilidad entre actualizaciones de servicio.

Utiliza esta capacidad cuando quieras corregir un error tipográfico, añadir información o revisar una nota existente en un caso u otro registro.

Qué hace

El asistente encuentra una nota existente por su identificador y actualiza el texto con tu nuevo contenido. La nota actualizada reemplaza a la versión anterior en la línea temporal del disco. Esto es útil para corregir errores o añadir detalles a una nota que hayas creado antes.

Prueba con prompts como

  • "Correge el error tipográfico en mi nota"
  • "Actualiza la nota para decir que el cliente confirmó la solución alternativa"
  • "Cambia la nota sobre este caso"
  • "Revisa mi última nota"
  • "Actualiza el texto de la nota para incluir el nuevo número de teléfono"

Lo que verás en el chat

El asistente muestra la línea de tiempo de la actividad como un componente de aplicación en el chat, actualizada para mostrar el contenido actualizado de las notas.

Sugerencias útiles

  • El asistente necesita saber qué nota actualizar. Si hay varias notas, especifica por contenido o título.
  • Puedes decir "actualiza la nota" y luego proporcionar el nuevo texto, o incluir todo en un solo prompt.
  • Solo se pueden actualizar las notas que poseas.
  • Si quieres añadir una nota completamente nueva en lugar de editar una existente, di "añadir una nota".

Tip

Consulta primero la línea de tiempo para ver las notas existentes y luego dile al asistente cuál actualizar.

Qué sucede a continuación

Después de actualizar la nota, puedes continuar con prompts como:

  • "Mostrar la línea temporal"
  • "Añade otra nota"
  • "Redactar un correo electrónico para el cliente"
  • "¿Qué más hay que hacer en este caso?"

¿Esto cambia los datos?

Sí, esto actualiza una nota existente.

El texto de la nota se reemplaza por el nuevo contenido que proporcionas. La asistente pide confirmación antes de hacer el cambio.

Qué puedes hacer desde el componente app-in-chat

Desde la línea temporal del chat, puedes:

  • Consulta la nota actualizada en contexto
  • Consulta la línea temporal completa de la actividad
  • Selecciona cualquier actividad para ver sus detalles
  • Abre el formulario completo de registro en Dynamics 365

Prerequisites

Esta herramienta está disponible en el servidor MCP de Dynamics 365 Customer Service. Consulta la nota de disponibilidad en la parte superior de esta página para más detalles. No se requiere ninguna configuración adicional.

Resumen de herramientas

Propiedad Value
Nombre orientado al usuario Nota de actualización
Nombre interno de la herramienta update_note
propósito Actualiza el texto de una nota existente (anotación) en Dynamics 365 mediante su anotación GUID

Comportamiento de la herramienta

Actualiza el texto de una nota existente (anotación) en Dynamics 365 mediante su guía de anotación. Utilízalo cuando el usuario quiera corregir un error tipográfico, revisar o modificar una nota existente. Se annotationId puede obtener de la get_activity_timeline respuesta.

Annotations

Anotación Value Meaning
readOnlyHint false Esta herramienta modifica los datos: Microsoft 365 Copilot solicita confirmación.
destructiveHint false Actualizar una nota reemplaza el contenido pero no es destructivo.
idempotentHint true Llamar con las mismas entradas produce el mismo resultado: es seguro intentarlo de nuevo.
openWorldHint Sin establecer Usa el predeterminado (consulta Dataverse).

Conceptos de entrada

Identificador de nota

Entrada Description Obligatorio
annotationId annotationId (GUID de anotación para actualizar, necesario). Obtén de get_activity_timeline. Sí

Contenido actualizado

Entrada Description Obligatorio
notetext, subject notetext (nota actualizada texto del cuerpo, obligatorio), subject (título opcional actualizado). Varía

Respuesta y comportamiento de la interfaz de usuario

Esta herramienta muestra la línea de tiempo de la actividad para confirmar que la nota fue actualizada.

Esta herramienta MCP está soportada por una aplicación MCP.

Tipo de respuesta

Componente interactivo (app-in-chat)

El widget de la línea de tiempo se actualiza para mostrar el contenido actualizado de la nota.

Notas de enrutamiento

Use update_note para:

  • "Arreglar la nota", "actualizar la nota", "revisar la nota"
  • Cualquier edición del texto o título de una anotación existente

No uses update_note cuando:

  • El usuario quiere crear una nueva nota - usar create_note
  • El usuario quiere actualizar una actividad de la línea de tiempo (tarea, llamada telefónica, etc.) - úsalo create_activity con activityId
Herramienta Relación
create_note Crea una nueva nota en un disco
get_activity_timeline Recupera la línea temporal incluyendo notas (fuente de la anotaciónId)
create_activity Crea actividades de línea de tiempo (no anotaciones)

Clasificación de mutaciones de datos

Escritura / mutación.

Esta herramienta actualiza un registro de anotación existente en Dataverse. M365 Copilot solicita al usuario confirmación antes de la ejecución. La operación es idempotente: intentar de nuevo con las mismas entradas produce el mismo resultado.

  • Last updated on