Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 vuoi sfogliare i record per qualsiasi tipo di entità Dataverse che non abbia un comando di lista dedicato, come opportunità, lead, elementi in coda o tabelle personalizzate.
Funzionamento
L'assistente mostra un elenco di record per il tipo di entità che specifichi. Puoi cercare per nome e limitare il numero di risultati. Questo è lo strumento generico di elenco dei record che funziona per qualsiasi tipo di entità nel tuo ambiente Dynamics 365.
Per account, contatti e casi, l'assistente utilizza strumenti specializzati che offrono filtri più ricchi. Questo strumento è il backup per tutto il resto.
Prova con prompt come
- "Mostra tutti gli elementi della coda"
- "Liste delle opportunità"
- "Indicazioni di elenco"
- "Mostra i miei record personalizzati di entità"
- "Sfoglia le opportunità aperte"
- "Elenca tutti gli appuntamenti"
- "Mostra i registri dei compiti"
Cosa vedrai in chat
L'assistente mostra una lista di registri interattiva come componente app-in-chat. L'elenco mostra i record corrispondenti con il loro nome principale e le colonne chiave.
Suggerimenti utili
- Devi specificare il tipo di entità, ad esempio "elenca opportunità" o "mostra contatti".
- Usa un nome per cercare registri specifici, ad esempio "elenca opportunità per Project Alpha."
- Per gli account, dì invece "lista account". Per i contatti, di' "elenca contatti". Per i casi, si dice "lista casi".
- Il numero massimo di risultati è 200.
Tip
Dopo che appare la lista dei record, puoi fare domande di approfondimento su qualsiasi record mostrato. Ad esempio, "apri il primo record" o "aggiorna questo record."
Cosa succederà dopo
Dopo che la lista appare, puoi continuare con prompt come:
- "Apri il primo disco"
- "Dettagli dello show per questo disco"
- "Aggiorna un campo su questo record"
- "Cancella questo registro"
Questo cambia i dati?
No, i registri di inserzione non modificano i dati.
La lista dei record è in sola lettura. Azioni successive dalla lista, come aggiornare o cancellare un record, possono modificare i dati. L'assistente chiede conferma prima di apportare modifiche.
Cosa puoi fare dalla componente app-in-chat
Dalla lista dei record in chat, puoi:
- Scansiona e rivedi i record corrispondenti in una griglia ordinabile
- Seleziona un record per vedere maggiori dettagli
- Apri il modulo completo del record in Dynamics 365
- Continua a lavorare con il record 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 | Registri dell'Entità Elenco |
| Nome dello strumento interno | list_entity_records |
| Purpose | Recupera i record di qualsiasi entità Dataverse in una griglia sortibile e filtrabile |
Comportamento degli strumenti
Recupera i record di qualsiasi entità Dataverse in una griglia sortabile e filtrabile. Da utilizzare per tipi di entità che non dispongono di uno strumento di elenco dedicato, come opportunità, lead, elementi in coda o tabelle personalizzate. Per i tipi di entità core (account, contatt, caso, conoscenza), usa invece lo strumento di lista nominata.
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
Non impostato | In pratica solo lettura; Questo strumento non modifica 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
Tipo di entità
| Inserimento | Description | Obbligatorio |
|---|---|---|
entityLogicalName |
entityLogicalName (stringa, richiesta). Il nome logico dell'entità Dataverse (ad opportunityesempio , lead, queueitem). |
Yes |
Search
| Inserimento | Description | Obbligatorio |
|---|---|---|
search |
search (stringa, opzionale). Ricerca in testo libero attraverso l'attributo principale del nome dell'entità. |
No |
Limite dei risultati
| Inserimento | Description | Obbligatorio |
|---|---|---|
top |
top (intero, opzionale). Massimo record da restituire. Impostazione predefinita sulla dimensione della pagina dell'organizzazione (25 a meno che un amministratore non l'abbia cambiata), massimo 200. |
No |
Risposta e comportamento dell'interfaccia utente
Questo strumento genera una griglia interattiva di entità app-in-chat.
Questo strumento MCP è supportato da un'app MCP.
Tipo di risposta
Griglia interattiva (vista lista)
La griglia mostra i record con il loro nome principale e le colonne chiave. Gli utenti possono selezionare una riga da approfondire nei dettagli dei record tramite get_entity_record.
Note di instradamento
Utilizzo list_entity_records per:
- Qualsiasi tipo di entità senza uno strumento di elenco dedicato (opportunità, lead, elementi in coda, tabelle personalizzate)
- "Lista [Tipo di Entità]" dove [Tipo di Entità] non è account, contatto, caso, conoscenza o valutazione
Non usare list_entity_records quando il prompt dice esplicitamente:
-
Conti - percorso verso
list_accounts -
Contatti - rotta verso
list_contacts -
Casi - via verso
list_cases -
Articoli di conoscenza - percorso verso
search_knowledge_articles -
Valutazioni - percorso verso
list_evaluations -
Ricerca in testo libero tra entità - percorso verso
search_entities -
Vista forma di un singolo registro - percorso verso
get_entity_record
Strumenti correlati
| Tool | Relazione |
|---|---|
get_entity_record |
Apre la vista form per un singolo record dalla griglia |
update_entity_record |
Aggiorna i campi su qualsiasi record di entità |
delete_entity_record |
Elimina qualsiasi record di entità |
search_entities |
Ricerca in testo libero tra i tipi di entità |
list_accounts |
Elenco account dedicato con filtri specifici per conto |
list_contacts |
Elenco dei contatti dedicato con filtri specifici per contatto |
list_cases |
Lista dei casi dedicata con filtri specifici per caso |
Classificazione delle mutazioni dei dati
Punto di ingresso di sola lettura con potenziale mutazione a valle.
L'annuncio stesso non modifica i dati. Le azioni successive dalla griglia (aggiornare, eliminare) possono attivare operazioni di scrittura tramite strumenti separati.