Crea attività

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 funzione quando vuoi registrare una telefonata, creare un compito o fissare un appuntamento su un caso o un altro documento.

Funzionamento

L'assistente crea un'attività di timeline sul record che specifichi. I tipi di attività supportati includono:

  • Compiti - to-do elementi con argomento, scadenza e priorità
  • Telefonate - chiamate registrate con indicazioni (in arrivo/uscita), durata e note
  • Appuntamenti - incontri programmati con orario di inizio, fine e luogo
  • Email - email rapide (per una revisione completa di composizione e revisione, usa invece "redigi un'email")

L'attività appare nella timeline del registro insieme a appunti, email e altre attività.

Prova con prompt come

  • "Crea un compito di follow-up su questo caso"
  • "Registra una telefonata con il cliente"
  • "Prenota un appuntamento per martedì prossimo"
  • "Aggiungi un compito per richiamare il cliente entro venerdì"
  • "Registra una chiamata in arrivo - 15 minuti, discusso problema di fatturazione"
  • "Crea un compito per rivedere l'escalation"
  • "Fissa un incontro con il cliente alle 14:00 di domani"
  • "Registra una chiamata in uscita riguardo alla richiesta di rimborso"

Quello che vedi in chat

L'assistente mostra la timeline dell'attività come un componente app-in-chat, aggiornata per mostrare la nuova attività nel contesto.

Suggerimenti utili

  • Per i compiti, basta indicare l'argomento e la scadenza - ad esempio, "crea un compito da seguire entro venerdì."
  • Per le chiamate, specifica la direzione (in entrata o in uscita). L'assistente chiede la durata della chiamata se non la menzioni.
  • Per gli appuntamenti, indica data e ora. Puoi anche aggiungere una location.
  • Se vuoi aggiungere una nota in testo semplice (non un'attività), dì invece "aggiungi una nota".
  • Le attività sono sempre collegate al record attuale. L'assistente utilizza il contesto del caso attivo.

Tip

Puoi creare più attività in sequenza. Dopo aver creato un compito, dì "registra anche una chiamata telefonica" per aggiungere un'altra attività.

Cosa succederà dopo

Dopo aver creato l'attività, puoi continuare con prompt come:

  • "Mostra la linea temporale"
  • "Crea un altro compito"
  • "Redige un'email per il cliente"
  • "Quali compiti sono aperti su questo caso?"
  • "Aggiorna lo stato del caso"

Questo cambia i dati?

Yes. Questo crea un'attività.**

Un nuovo record di attività (compito, telefonata, appuntamento o email) viene creato in Dynamics 365 e collegato al record. L'assistente chiede conferma prima di creare l'attività.

Cosa puoi fare dalla componente app-in-chat

Dalla timeline dell'attività in chat, puoi:

  • Consulta la nuova attività creata insieme ad altre attività recenti del caso
  • Sfoglia la cronologia delle attività in ordine cronologico
  • Espandi un'attività per visualizzare i dettagli
  • Apri l'attività in Dynamics 365 per ulteriori modifiche

Prerequisiti

Questo strumento è disponibile sul server MCP di Dynamics 365 Customer Insights - Journeys. Consulta la nota di disponibilità in cima a questa pagina per i dettagli. Non è necessaria alcuna configurazione aggiuntiva.

Riepilogo degli strumenti

Proprietà Value
Nome rivolto all'utente Crea attività
Nome dello strumento interno create_activity
Purpose Crea un'attività della timeline (email, compito, appuntamento o telefonata) associata a un record Dynamics 365

Comportamento degli strumenti

Crea un'attività della timeline (email, compito, appuntamento o telefonata) associata a un record Dynamics 365. Supporta tutti i tipi di attività standard di Dataverse più tipi di attività personalizzati forniti dal tenant. Associa sempre l'attività al record attualmente attivo tramite entityId/entityType.

Annotations

Annotation Value Meaning
readOnlyHint false Questo strumento crea dati - Microsoft 365 Copilot richiede la conferma.
destructiveHint false Creare un'attività è additivo, non distruttivo.
idempotentHint false Ogni chiamata crea una nuova attività - non è sicuro riprovare.
openWorldHint Non impostato Usa il predefinito (interroga Dataverse).

Concetti di input

Contesto del record

Inserimento Description Obbligatorio
entityId, regardingId, entityType, regardingType, incident entityId oppure regardingId (record GUID, richiesto - passare sempre dal caso attivo), entityType oppure regardingType (nome logico dell'entità come incident). Entrambe le coppie di denominazione sono accettate.

Tipo di attività

Inserimento Description Obbligatorio
activityType activityType (obbligatorio - ad esempio phonecall, task, appointment, email, o qualsiasi nome logico di attività Dataverse fornito dal tenant fornito).

Campi comuni

Inserimento Description Obbligatorio
subject, description subject (oggetto dell'attività), description (corpo/descrizione). No

Specifico per compito

Inserimento Description Obbligatorio
dueDate, priority, low, normal, high dueDate (ISO 8601), priority (low, normal, high). No

Chiamate specifiche per telefonate

Inserimento Description Obbligatorio
phoneNumber, direction, incoming, outgoing, duration phoneNumber, direction (incoming o outgoing), duration (minuti - confermare sempre con l'utente se non specificato). No

Specifico per la nomina

Inserimento Description Obbligatorio
scheduledStart, scheduledEnd, location scheduledStart e scheduledEnd (ISO 8601), location. No

Specifico per email

Inserimento Description Obbligatorio
to, cc, bccsend to, cc, bcc (array di riferimenti di entità o stringhe di email), send (vero inviare immediatamente, falso per bozza). No

Aggiornamento del draft

Inserimento Description Obbligatorio
activityId, fieldValues activityId (GUID di attività esistente per aggiornamenti), fieldValues (valori aggiuntivi dei campi da quick-create modul). No

Risposta e comportamento dell'interfaccia utente

Questo strumento visualizza la timeline dell'attività per confermare che l'attività è stata creata.

Questo strumento MCP è supportato da un'app MCP.

Tipo di risposta

Componente interattivo (app-in-chat)

Il widget della timeline si aggiorna per mostrare l'attività appena creata nel feed.

Note di instradamento

Utilizzo create_activity per:

  • "Crea un compito", "registra una chiamata", "fissa un appuntamento"
  • Qualsiasi creazione di attività nella timeline (telefonata, compito, appuntamento, email)
  • Tipi di attività personalizzati provisionati nel tenant

Non usare create_activity quando:

  • L'utente vuole aggiungere una nota in testo semplice - usa create_note (note non è un typeAttività valido)
  • L'utente vuole comporre e revisionare un'email prima di inviare - usa draft_email
  • L'utente vuole inviare un'email immediatamente - usa send_email
Tool Relazione
create_note Crea una nota (annotazione) - non un'attività di timeline
get_activity_timeline Recupera la timeline completa dell'attività per un record
get_activity_quick_create_form I ritorni formano metadati per i tipi di attività
draft_email Apre la scrittura email per la revisione (preferito per i flussi email)
send_email Invia un'email immediatamente

Classificazione delle mutazioni dei dati

Scrittura / mutazione.

Questo strumento crea un nuovo record di attività in Dataverse. Microsoft Copilot chiede all'utente di confermare prima dell'esecuzione.