Salva la registrazione dell'agente MCS

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.

Questa funzionalità funziona dietro le quinte quando aggiungi o modifichi la registrazione di un agente Copilot Studio dal widget di gestione delle registrazioni.

Funzionamento

Quando compili il modulo di registrazione nel widget di gestione agenti di Copilot Studio e selezioni Salva, questo strumento mantiene la registrazione nel tuo ambiente Dynamics 365. Si occupa sia della creazione di nuove registrazioni sia dell'aggiornamento di quelle esistenti.

Lo strumento valida l'identità del bot e il nome dello schema, applica il limite di registrazione (10 per ambiente) e previene la duplicazione di ID o nomi di schema di bot. In caso di successo, memorizza la registrazione e aggiorna la lista degli strumenti dell'Agente di Servizio in modo che la nuova delega di agenti diventi disponibile.

Prova con prompt come

Non applicabile. Questo strumento viene chiamato automaticamente quando salvi una registrazione dal widget di gestione. Non viene invocato digitando un prompt.

Cosa vedrai in chat

Il widget di registrazione si aggiorna per confermare che il salvataggio è riuscito, mostrando l'ID di registrazione e se è stato creato o aggiornato. Se la validazione fallisce (ad esempio, un ID o nome di schema duplicato del bot), il widget mostra un messaggio di errore che spiega cosa correggere.

Suggerimenti utili

  • Devi eseguire Test Connection prima di salvare una nuova registrazione. I metadati del bot del test vengono utilizzati per popolare i campi richiesti.
  • Ogni bot può essere registrato solo una volta. Rimuovi prima la registrazione esistente se devi riregistrare lo stesso bot.
  • La descrizione che fornisci è ciò che l'Agente di Assistenza vede quando decide se delegare una domanda a questo agente. Rendilo chiaro e specifico.
  • I nomi degli schemi devono essere unici in tutte le registrazioni di Copilot Studio nel tuo ambiente.

Cosa succederà dopo

Dopo aver salvato, il widget di registrazione torna alla vista lista. È possibile:

  • "Prova di nuovo la connessione"
  • "Modifica la registrazione che ho appena salvato"
  • "Aggiungi un altro agente Copilot Studio"

Questo cambia i dati?

Sì, questo cambia i dati.

Salvare una registrazione crea o aggiorna un record di configurazione nel tuo ambiente Dynamics 365 e aggiorna la lista degli strumenti disponibili dell'Agente di Servizio.

Prerequisiti

Questo strumento richiede quanto segue:

  • Estensibilità di Copilot con Copilot Studio da configurare. Richiede il ruolo di Amministratore di Sistema o di Amministratore del Servizio Copilot

Scopri di più su Extend Copilot con Copilot Studio.

Riepilogo degli strumenti

Proprietà Valore
Nome rivolto all'utente Salva la registrazione dell'agente MCS
Nome dello strumento interno save_copilot_studio_registration
Purpose Persiste una nuova o aggiornata registrazione di un agente Copilot Studio (MCS)

Comportamento degli strumenti

Persiste una nuova o aggiornata registrazione di un agente Copilot Studio (MCS). Questo è uno strumento di supporto ai widget che viene attivato automaticamente quando gli utenti interagiscono con il widget di registrazione di estensibilità. Non è destinato a essere invocato direttamente dal modello.

Annotations

Annotation Valore Meaning
readOnlyHint false Questo strumento crea o aggiorna i dati di registrazione.
destructiveHint false Gli aggiornamenti sono non distruttivi (pattern upsert).
idempotentHint true Le chiamate ripetute con lo stesso input producono lo stesso risultato.
openWorldHint Non impostato Usa il valore predefinito.

Concetti di input

Oggetto di registrazione

Inserimento Description Obbligatorio
botId, name, displayNamedescription, , inputParameters, environmentId, schemaName, ,m365AppId Contiene i dettagli di registrazione degli agenti tra cui botId (GUID del bot Dataverse), name (identificatore univoco), displayName, description, inputParameters, environmentId (ambiente Power Platform), schemaName, e m365AppId. No

ID registrazione

Inserimento Description Obbligatorio
id id (facoltativo). Quando fornito, aggiorna una registrazione esistente; quando viene omesso, ne crea uno nuovo. No

URL dell'organizzazione

Inserimento Description Obbligatorio
orgUrl orgUrl (facoltativo). Sovrascrive l'URL dell'ambiente attualmente selezionato. No

Risposta e comportamento dell'interfaccia utente

Questo strumento MCP è supportato da un'app MCP.

Tipo di risposta

Aggiornamento widget

Il widget si aggiorna per mostrare la registrazione salvata.

Note di instradamento

Questo strumento è chiamato esclusivamente dal manage_copilot_studio_registration widget. Non invocarla direttamente.

Tool Relazione
manage_copilot_studio_registration Lo strumento di lancio che apre il widget di registrazione
delete_copilot_studio_registration Rimuove la registrazione di un agente
test_copilot_studio_registration_connection Testa la raggiungibilità dell'agente prima di salvare
list_copilot_studio_registration_bots Elenca i bot disponibili per il bot picker

Classificazione delle mutazioni dei dati

Scrivi (upsert). Crea o aggiorna la registrazione di un agente Copilot Studio nello store di registrazione con ambito organizzativo.

  • Last updated on