Modifica bozza email

Note

Questo strumento è disponibile di default sui seguenti server MCP: Dynamics 365 Customer Insights - Journeys. Gli strumenti ed esempi presenti in questa documentazione illustrano le capacità attuali. Nomi degli strumenti, descrizioni, parametri, formati di risposta e funzionalità disponibili possono cambiare nel tempo.
Quando costruisci agenti, integrazioni o logiche di orchestrazione, non codificare dipendenze su nomi specifici di strumenti, strutture di parametri, metadati degli strumenti o schemi di risposta. Invece, progetta la tua soluzione per scoprire e utilizzare gli strumenti disponibili in runtime.
Con l'evoluzione della piattaforma, Microsoft potrebbe aggiungere, rimuovere, rinominare o modificare strumenti e metadati degli strumenti. Progettare in base alle capacità piuttosto che a specifici identificatori di strumenti aiuta a mantenere la compatibilità tra gli aggiornamenti dei servizi.

Usa questa funzionalità quando hai una bozza di email iniziata prima e vuoi riprendere da dove avevi lasciato. L'assistente apre la bozza esistente in un modulo di composizione così puoi continuare a modificare, poi salvarla o inviarla.

Funzionamento

L'assistente trova la tua ultima bozza di email su un caso (o una bozza specifica a cui fai riferimento) e la apre nel modulo di composizione. Soggetto, corpo, destinatario e carico contestuale del caso dalla bozza salvata. Qualsiasi modifica che apporti aggiorna lo stesso record di bozze - non vengono create bozze duplicate.

Prova con prompt come

  • "Apri la mia bozza di email"
  • "Modifica la bozza di questo caso"
  • "Riprendi la mia bozza via email"
  • "Apri l'ultima bozza"
  • "Modifica la mia bozza per il caso CAS-01010-A0A0A0"
  • "Continua a lavorare sulla mia bozza"

Cosa vedrai in chat

L'assistente visualizza il modulo di composizione email come un componente app-in-chat, precompilato con l'oggetto già esistente della bozza, il corpo e i destinatari. Puoi continuare a modificare da dove avevi lasciato.

Suggerimenti utili

  • Se hai più bozze, specifica quale menzionando il caso o l'argomento.
  • Vengono mostrate solo le tue bozze - non puoi modificare la bozza di un altro agente.
  • Solo le bozze non inviate possono essere aperte in questo modo. Se l'email è già stata inviata, usa invece "visualizza email".
  • Salvare aggiorna lo stesso record di bozza - non crea un duplicato.

Tip

Se vuoi iniziare una nuova email invece di modificare una bozza esistente, dì invece "redige una nuova email".

Cosa succederà dopo

Dopo l'apertura della draft, puoi continuare con prompt come:

  • "Mandalo ora"
  • "Risparmia la leva"
  • "Aggiungi un paragrafo sulla risoluzione"
  • "Cambia argomento"

Questo cambia i dati?

Questo passaggio apre una bozza esistente ma non modifica i dati da solo.

Salvare o inviare l'email dal modulo di composizione aggiorna il record di bozza in Dynamics 365.

Cosa puoi fare dalla componente app-in-chat

Dal modulo di composizione in chat, puoi:

  • Modifica l'oggetto e il corpo dell'email
  • Aggiungi o rimuovi i destinatari
  • Salva la bozza aggiornata
  • Invia direttamente l'email
  • Apri il modulo email completo in Dynamics 365

Prerequisiti

Questo strumento richiede quanto segue:

  • Funzionalità email di Copilot

Scopri di più in Gestione delle funzionalità di Copilot nel Servizio Clienti.

Riepilogo degli strumenti

Proprietà Valore
Nome rivolto all'utente Modifica bozza email
Nome dello strumento interno edit_email_draft
Purpose Apre una bozza di email esistente nel modulo di composizione così l'utente può riprendere la modifica

Comportamento degli strumenti

Apre una bozza di email esistente nel modulo di composizione così l'utente può riprendere la modifica. Carica l'oggetto, il corpo, i destinatari e il registro riguardante da Dataverse e precompila il modulo. Le operazioni di salvataggio e invio aggiornano lo stesso record di bozza — non vengono create bozze duplicate. Rifiuta le email non bozze (codice statale != 0).

Annotations

Annotation Valore Meaning
readOnlyHint true Microsoft 365 Copilot salta il prompt di conferma. Il widget gestisce la perseveranza.
destructiveHint Non impostato Non applicabile (apre la bozza esistente per la revisione).
idempotentHint Non impostato Non applicabile (ogni chiamata apre una sessione di composizione).
openWorldHint Non impostato Usa il predefinito (interroga Dataverse).

Concetti di input

Bozza specifica

Inserimento Description Obbligatorio
activityId activityId (email attività GUID della bozza per aperre). Usalo quando l'utente fa riferimento a una bozza specifica, ad esempio cliccando sul pulsante Modifica su una riga della bozza nella timeline. Applica il controllo di uguaglianza dei proprietari. No

Ultima bozza registrata

Inserimento Description Obbligatorio
entityId, entityType, incident entityId (GUID del record genitore, tipicamente un caso), entityType (nome logico dell'entità, predefinito su incident). Restituisce la bozza più recentemente modificata posseduta dall'utente attuale su quel record. No

Esclusività reciproca

Inserimento Description Obbligatorio
activityId, entityId activityId e entityId sono mutuamente esclusivi — superare entrambi viene rifiutato dal gestore. Esattamente uno deve essere impostato. No

Risposta e comportamento dell'interfaccia utente

Questo strumento genera un modulo interattivo di composizione email.

Questo strumento MCP è supportato da un'app MCP.

Tipo di risposta

Componente interattivo (app-in-chat)

Il modulo di composizione carica il contenuto esistente della bozza — soggetto, corpo, destinatari e contesto riguardante — per la revisione continua.

Note di instradamento

Utilizzo edit_email_draft per:

  • "Apri la mia bozza", "riprendi la mia bozza", "modifica la bozza"
  • Cliccando il pulsante Modifica con la matita su una riga di bozza nella timeline
  • "Apri l'ultima bozza sul caso X"

Non usare edit_email_draft quando:

  • L'utente vuole comporre una nuova email — usa draft_email
  • L'utente vuole visualizzare un'email ricevuta o inviata (non una bozza) — usa view_email
  • L'utente vuole inviare un'email immediatamente — usa send_email
Tool Relazione
draft_email Crea una nuova bozza email (nuova sessione di composizione)
send_email Invia un'email immediatamente senza revisione del composizione
view_email Mostra un'email ricevuta o inviata in sola lettura
get_activity_timeline Mostra la timeline dell'attività dove compaiono le bozze

Classificazione delle mutazioni dei dati

Punto di ingresso di sola lettura con potenziale mutazione a valle.

Lo strumento è contrassegnato readOnlyHint: true. Il widget compose gestisce le operazioni di salvataggio e invio — gli aggiornamenti vengono applicati allo stesso record di bozza in Dataverse quando l'utente seleziona Salva o Invia.

  • Last updated on