Visualizza Account

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.

  • "Mostra dettagli dell'account Contoso"
  • "Avventura con conto aperto funziona"
  • "Visualizza l'account Fabrikam"
  • "Mostrami il conto dei Northwind Traders"
  • "Quali sono i dettagli dell'account Litware?"
  • "Apri questo conto"

Cosa vedrai in chat

L'assistente mostra un modulo interattivo dell'account come componente app-in-chat. Il modulo mostra campi dell'account come nome, settore, indirizzo, numero di telefono, email e qualsiasi campo personalizzato configurato nel modulo.

Suggerimenti utili

  • Puoi usare il nome dell'account o un GUID per aprire un account specifico.
  • Se l'assistente dice che più account corrispondono, prova "elenca account" e poi seleziona quello che vuoi.
  • Per un breve riassunto testuale invece del modulo completo, dici "riassumi questo racconto" o "informami su Contoso."

Tip

Dopo che il modulo dell'account appare, puoi porre domande di approfondimento come "mostra i contatti su questo account" o "elenca i casi per questo account."

Cosa succederà dopo

Dopo che il modulo dell'account è apparso, puoi continuare con prompt come:

  • "Riassumi questo racconto"
  • "Mostra i contatti su questo account"
  • "Aggiorna il numero di telefono su questo account"
  • "Elenca i casi per questo conto"

Questo cambia i dati?

No, visualizzare un account non cambia i dati.

Il modulo account è di sola lettura di default. Le modifiche in linea dal modulo possono modificare i dati. L'assistente chiede conferma prima di apportare modifiche.

Cosa puoi fare dalla componente app-in-chat

Dal modulo account in chat, puoi:

  • Consulta tutti i dettagli dell'account
  • Modifica i campi supportati in linea
  • Apri il modulo completo del conto in Dynamics 365
  • Continua a lavorare con l'account in chat usando i prompt di follow-up

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 Visualizza Account
Nome dello strumento interno get_account
Purpose Apre la visualizzazione completa di un singolo record CRM con l'editing in linea

Comportamento degli strumenti

Apre la visualizzazione completa di un singolo record CRM con la modifica in linea. Accetta un GUID o un nome account e risolve automaticamente i nomi unici. Restituisce un errore quando più account corrispondono al nome; Uso list_accounts per disambiguare.

Annotations

Annotation Value Meaning
readOnlyHint Non impostato In pratica solo lettura; Questo strumento non modifica direttamente i dati.
destructiveHint Non impostato Non applicabile (strumento di sola lettura).
idempotentHint Non impostato Non applicabile (strumento di sola lettura).
openWorldHint Non impostato Usa il predefinito (interroga Dataverse).

Concetti di input

Identificatore di record

Inserimento Description Obbligatorio
recordId recordId (stringa, richiesta). Un GUID o nome account da cercare. Quando viene fornito un nome, lo strumento lo risolve lato server. Se più account corrispondono, viene restituito un errore che indirizza l'utente a list_accounts per la disambiguazione. Sì

Selezione della forma

Inserimento Description Obbligatorio
formId formId (stringa, opzionale). Un sistema form GUID da utilizzare per il rendering. Di default passa alla forma principale principale quando viene omessa. No

Risposta e comportamento dell'interfaccia utente

Questo strumento genera una forma interattiva di app in chat per l'account.

Questo strumento MCP è supportato da un'app MCP.

Tipo di risposta

Forma interattiva (vista dettagliata)

Il modulo mostra i campi dell'account come definiti dal modulo di sistema selezionato, inclusi nome account, settore, indirizzo, telefono, email e campi personalizzati.

Note di instradamento

Utilizzo get_account per:

  • "apri account X", "mostra dettagli account", "visualizza Contoso"
  • Qualsiasi prompt che nomini un account specifico e voglia vedere la sua forma

Non usare get_account quando il prompt dice esplicitamente:

  • "Lista" o "mostra i miei account" - percorso verso list_accounts
  • "Riassumi" o "ribriefimi su" un'azienda - percorso verso summarize_account
  • Un'entità generica con nome logico - rotta verso get_entity_record
Tool Relazione
list_accounts Elenca i conti; Uso per disambiguare quando più persone corrispondono a un nome
summarize_account Riepilogo testuale AI del contesto dell'account
update_entity_record Campi di aggiornamento nel record dell'account
get_contact Apre un modulo di contatto; Spesso usato insieme ai dettagli dei conti
get_entity_record Dettagli generici delle entità per tipi di entità non concorrenti

Classificazione delle mutazioni dei dati

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

La vista del modulo in sé non modifica i dati. Le modifiche in linea attivano le operazioni di scrittura tramite update_entity_record.

  • Last updated on