Rimuovi la configurazione del profilo

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 rimuovere una configurazione di layout da un profilo applicativo specifico e tornare al valore predefinito a livello di organizzazione.

Funzionamento

L'assistente rimuove una configurazione di layout con ambito di profilo tramite la sua chiave di scopo. Dopo la rimozione, gli agenti assegnati a quel profilo vedono la configurazione a livello di organizzazione (se esiste) o la configurazione predefinita di sistema. Questa azione richiede una conferma esplicita.

Prova con prompt come

  • "Rimuovi la personalizzazione della griglia L1"
  • "Reset del layout del profilo per gli agenti di livello 2"
  • "Elimina la configurazione del modulo a livello di profilo"
  • "Ripristina questo profilo al valore predefinito dell'org"

Cosa vedrai in chat

L'assistente chiede conferma prima di rimuovere la configurazione. Dopo aver confermato, segnala quale configurazione del profilo è stata rimossa.

Suggerimenti utili

  • Usa list_profile_configs prima per vedere le configurazioni attive e le loro tasti di scopo.
  • La rimozione è permanente. La configurazione non può essere recuperata dopo la cancellazione.
  • Le configurazioni a livello di organizzazione e le preferenze personali non sono influenzate.

Cosa succederà dopo

  • "Mostra configurazioni del profilo" per verificare la rimozione
  • "Imposta un nuovo layout per questo profilo" per creare un sostituto
  • "Mostra configurazioni a livello di organizzazione" per vedere a quali agenti torneranno

Questo cambia i dati?

Sì, questo può cambiare i dati.

Prerequisiti

Questo strumento richiede quanto segue:

  • Ruolo di Amministratore di Sistema o Amministratore del Servizio Copilot

Riepilogo degli strumenti

Proprietà Value
Nome rivolto all'utente Rimuovi la configurazione del profilo
Nome dello strumento interno delete_profile_config
Purpose Rimuove una configurazione di agente da un Profilo Application per chiave di ambito

Comportamento degli strumenti

Rimuove una configurazione di agente da un Profilo Application tramite chiave di scopo. Da usare quando l'utente chiede di rimuovere o resettare una personalizzazione a livello di profilo (ad esempio, "resettare la disposizione della griglia L1"). Richiede una conferma esplicita per prevenire cancellazioni accidentali.

Annotations

Annotation Value Meaning
readOnlyHint false Questo strumento modifica i dati.
destructiveHint true Questo strumento rimuove permanentemente i dati di configurazione.
idempotentHint true Eliminare un telescopio già rimosso non ha alcun effetto aggiuntivo.
openWorldHint Non impostato Usa il valore predefinito.

Concetti di input

ID profilo

Inserimento Description Obbligatorio
profileId profileId (Stringa UUID, obbligatoria). Il msdyn_appconfigurationid profilo dell'applicazione target. Sì

Chiave di ambito

Inserimento Description Obbligatorio
scope scope (stringa, richiesta). Il tasto scope da rimuovere (ad esempio, grid:incident:*). Usalo list_profile_configs per scoprire le chiavi di scope esistenti. Sì

Confirmation

Inserimento Description Obbligatorio
confirm, true confirm (letteralmente true, richiesto). Deve essere impostato esplicitamente come true per confermare la cancellazione. Sì

Risposta e comportamento dell'interfaccia utente

Tipo di risposta

Solo testo

Non viene renderizzato alcun componente interattivo. Restituisce conferma che la configurazione è stata rimossa dal profilo, oppure un errore se la chiave scope non è stata trovata.

Note di instradamento

Usare delete_profile_config quando:

  • L'utente chiede esplicitamente di rimuovere una configurazione a livello di profilo
  • L'utente menziona un profilo o un livello di agente specifico quando chiede di resettare i layout
  • Chiama list_profile_configs sempre prima se l'utente non ha specificato una chiave di scopo

Non usare delete_profile_config quando:

  • L'utente vuole rimuovere una configurazione a livello di organizzazione. Utilizzare invece delete_agent_config.
  • L'utente vuole eliminare una preferenza personale. Utilizzare invece delete_user_prefs.
  • L'utente vuole modificare (non rimuovere) una configurazione di profilo. Utilizzare invece save_profile_config.
Tool Relazione
list_profile_configs Elenca le configurazioni di profilo esistenti per identificare le chiavi di ambito
save_profile_config Crea o aggiorna configurazioni a livello di profilo
delete_agent_config Rimuove configurazioni a livello di organizzazione
delete_user_prefs Rimuove le preferenze di layout personale

Classificazione delle mutazioni dei dati

Scrivi (distruttivo).

Rimuove permanentemente una configurazione di agente da un Profilo Applicazione. Influisce su tutti gli agenti assegnati a quel profilo. L'assistente chiede conferma prima di eseguire.

  • Last updated on