Configurazioni degli agenti di lista

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à per vedere quali personalizzazioni di layout a livello di organizzazione sono attualmente attive per tutti gli agenti della tua organizzazione.

Funzionamento

L'assistente elenca tutte le configurazioni degli agenti a livello di organizzazione configurate da un amministratore. Queste configurazioni influenzano ogni utente dell'organizzazione e includono personalizzazioni di griglie, moduli, timeline e altri elementi di layout. Ogni configurazione mostra il proprio ambito (a quale entità e tipo si applica), il suo nome, quante modifiche include e quando è stata modificata l'ultima volta.

Prova con prompt come

  • "Elenca le configurazioni dei nostri agenti"
  • "Quali personalizzazioni a livello di organizzazione sono attive?"
  • "Mostrami tutti i layout delle organizzazioni"
  • "Elenca configurazioni per casse"
  • "Quali personalizzazioni della griglia esistono?"
  • "Mostra configurazioni agenti"

Cosa vedrai in chat

L'assistente risponde con una lista testuale di tutte le configurazioni attive a livello di organizzazione. Ogni voce mostra la chiave scope (ad esempio, grid:incident:*), un nome leggibile dall'uomo, il numero di patch applicate e la data dell'ultima modifica.

Suggerimenti utili

  • Questo mostra solo configurazioni a livello di organizzazione. Per preferenze specifiche del profilo o personali, chiedi separatamente.
  • Le chiavi di ambito seguono il pattern type:entity:target (ad esempio, grid:incident:* significa "configurazione della griglia per casi, tutte le viste").
  • Se vuoi filtrare per entità, specificalo nel prompt: "elenca configurazioni per casi" o "mostra configurazioni dell'account."
  • Sono necessari permessi amministrativi per modificare queste configurazioni, ma chiunque può visualizzarle.

Cosa succederà dopo

Dopo aver visto la lista:

  • "Mostrami i dettagli su [nome configurazione]"
  • "Rimuovi la configurazione della griglia per i casi" (solo amministratore)
  • "Quali sono le mie preferenze personali?" (separato dalle configurazioni dell'organizzazione)
  • "Aiutami a configurare una nuova configurazione"

Questo cambia i dati?

No, elencare le configurazioni non cambia i dati.

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 Configurazioni degli agenti di lista
Nome dello strumento interno list_agent_configs
Purpose Elenca tutte le configurazioni di agenti a livello di organizzazione

Comportamento degli strumenti

Elenca tutte le configurazioni di agente a livello di organizzazione. Mostra ambito, nome, conteggio delle patch e ultima data di modifica per ogni personalizzazione applicata a griglie, moduli e timeline. Da usare quando un amministratore di organizzazione chiede di rivedere quali personalizzazioni a livello di organizzazione sono attualmente attive.

Annotations

Annotation Value Meaning
readOnlyHint true 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 valore predefinito.

Concetti di input

Filtro entità

Inserimento Description Obbligatorio
entityLogicalName entityLogicalName (stringa, opzionale). Quando fornito, restituisce solo le configurazioni per quell'entità (ad esempio, incident, account). Ometti di elencare tutte le configurazioni su tutte le entità. No

Risposta e comportamento dell'interfaccia utente

Tipo di risposta

Solo testo

Non viene renderizzato alcun componente interattivo. Restituisce un elenco strutturato di configurazioni con le loro chiavi di scopo (ad esempio, grid:incident:*), nomi leggibili dall'uomo, conteggio delle patch e timestamp delle ultime modifiche.

Note di instradamento

Usare list_agent_configs quando:

  • L'utente chiede "quali configurazioni di organizzazione esistono" o "elenca le nostre personalizzazioni"
  • Devi mostrare le chiavi dell'ambito prima di un'operazione di cancellazione
  • L'utente vuole auditare i layout esistenti a livello di organizzazione

Non usare list_agent_configs quando:

  • L'utente chiede delle configurazioni a livello di profilo. Utilizzare invece list_profile_configs.
  • L'utente chiede quali sono le proprie preferenze personali. Utilizzare invece list_user_prefs.
  • L'utente vuole esplorare ciò che è possibile. Utilizzare invece browse_agent_config_options.
Tool Relazione
save_agent_config Crea o aggiorna una configurazione a livello di organizzazione
delete_agent_config Rimuove una configurazione a livello di organizzazione per chiave di ambito
list_profile_configs Elenca le configurazioni con ambito di un Profilo Applicazione
list_user_prefs Elenca le preferenze personali dell'utente attuale
browse_agent_config_options Guida interattiva alle opzioni di configurazione disponibili

Classificazione delle mutazioni dei dati

Di sola lettura.

  • Last updated on