Utilizza le azioni con copiloti personalizzati (anteprima)
Puoi estendere le capacità del tuo copilota aggiungendo una o più azioni. Le azioni vengono utilizzate dal tuo copilota per rispondere automaticamente agli utenti, utilizzando azioni generative, oppure puoi chiamarle esplicitamente da un argomento.
[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]
Tipi di azioni principali
Se attivi la modalità generativa, il tuo copilota può selezionare automaticamente l'azione o l'argomento più appropriato, per rispondere a un utente in fase di runtime.
Nella modalità classica, un copilota può utilizzare solo gli argomenti per rispondere all'utente. Tuttavia, puoi comunque progettare il tuo copilota in modo che richiami azioni esplicitamente dagli argomenti.
Le azioni si basano su uno dei seguenti tipi di azioni principali:
- Azione del connettore predefinito
- Azione del connettore personalizzato
- Flusso cloud di Power Automate
- Richieste AI Builder
- Competenza Bot Framework
Importante
Non puoi utilizzare le azioni di conversazione create in Copilot Studio come azioni con copiloti personalizzati.
Ogni azione principale dispone di informazioni aggiuntive che ne descrivono lo scopo, consentendo al copilota di utilizzare l'IA generativa per generare domande. Queste domande sono necessarie per fornire gli input necessari per eseguire l'azione. Pertanto, ciò significa che invece di dover creare manualmente i nodi della domanda per raccogliere tutti gli input necessari, come gli input su un flusso. Gli input vengono gestiti per te durante il runtime.
Le azioni possono generare una risposta contestuale alla query di un utente, utilizzando i risultati dell'azione. In alternativa, puoi creare esplicitamente una risposta per l'azione.
Suggerimento
Quando utilizzi domande generate da un'azione, informa i tuoi utenti che parte della conversazione è generata dall'intelligenza artificiale.
Ad esempio, aggiungi un messaggio aggiuntivo nell'argomento di sistema Avvio conversazione. Questo argomento determina il messaggio mostrato ai tuoi utenti quando inizia una nuova conversazione.
Aggiunge un'azione
Apri il tuo copilota personalizzato scegliendo Copiloti nel riquadro di spostamento a sinistra e seleziona il tuo copilota dall'elenco.
Seleziona Azioni per visualizzare le azioni per il copilota.
Seleziona + Aggiungi un'azione.
Nella procedura guidata Scegli un'azione (anteprima), cerca l'azione che desideri utilizzare e selezionala.
L'elenco predefinito visualizzato contiene flussi Power Automate e connettori personalizzati disponibili nel tuo ambiente. Questo elenco include anche connettori predefiniti e competenze Bot Framework comunemente utilizzati registrati con il tuo copilota.
Importante
Alcune azioni create dai plug-in IA, come i prompt dinamici e quelle basate su API Dataverse, richiedono l'autenticazione.
A seconda dell'azione, la connessione viene configurata automaticamente, come mostrato nell'esempio. In alternativa, è necessario configurare la connessione se vengono fornite istruzioni nella procedura guidata. Una volta configurata correttamente la connessione, seleziona Avanti.
Rivedi e, se necessario, apporta modifiche alle azioni dei plug-in. Seleziona Fine per aggiungere l'azione al tuo copilota.
Seleziona Avanti.
Chiama un'azione
Se hai abilitato azioni generative, l'azione viene richiamata automaticamente in risposta a una query utente pertinente.
In alternativa, puoi richiamare un'azione esplicitamente da un argomento.
Testa l'azione
Chiamare un'azione
Il tuo copilota seleziona ed esegue la tua azione in base al nome e alla descrizione. Puoi creare descrizioni di alta qualità, utilizzando la modalità di tracciamento dedicata per vedere quali azioni ha selezionato il tuo copilota dalla pagina azioni generative.
In alternativa, se hai aggiunto un'azione a un argomento, puoi testarla inserendo un messaggio simile a una delle frasi di attivazione per quell'argomento.
Puoi vedere un'azione meteorologica testata in questo screenshot:
In alternativa, se hai aggiunto un'azione a un argomento, puoi testare attivando il tuo argomento con una frase di attivazione adatta.
Configurazione di input e output per un'azione
Apporta modifiche alla configurazione dell'azione
Sono disponibili molti modi per configurare l'azione. Nel passaggio finale della procedura guidata dell'azione, chiamato Rivedi e termina, puoi apportare modifiche alla configurazione dell'azione facendo clic su Modifica accanto alla sezione appropriata.
Dettagli azione
Qui puoi configurare i dettagli della tua azione, incluso il Modello nome visualizzato e Descrizione del modello per la tua azione. Di solito, il nome e la descrizione sono stati prepopolati in base all'azione selezionata.
Le proprietà Nome visualizzato e Descrizione per ciascun input aiutano il copilota a comprendere lo scopo dell'input, per generare un domanda appropriata per l'utente e riconoscere il valore corretto nella risposta di un utente. Ad esempio, quelli che seguono sono il nome predefinito e la descrizione del parametro di input della posizione per il connettore MSN Weather.
- Nome: Località
- Descrizione: la query di ricerca del percorso. Gli input validi sono Città, Regione, Stato, Paese, Punto di riferimento, CAP, latitudine e longitudine
Quando chiedi all'utente una posizione, il copilota genera una domanda simile a questa: Qual è la posizione per la quale vorresti controllare il meteo? Puoi inserire una città, una regione, uno stato, un paese, un punto di riferimento o un codice postale.
Puoi anche modificare l'opzione Identifica come a un tipo di entità specifico, a seconda dell'input raccolto, che può aiutare il copilota a estrarre con precisione un valore per l'input dalla risposta di un utente.
Per impostazione predefinita, ogni input è impostato su Riempi dinamicamente con l'opzione migliore. Il copilota tenta di popolare il valore dal contesto disponibile, ad esempio estraendo un valore dal messaggio dell'utente. Se non viene trovato alcun valore appropriato, genera una domanda per chiedere un valore all'utente. Puoi sovrascrivere un input con un valore invece di chiedere all'utente. Per sovrascrivere, modifica il menu a discesa In che modo il copilota riempirà questo input? su Imposta un valore e quindi inserisci il valore che desideri utilizzare. Questo valore può essere un valore letterale, una variabile esistente o una formula Power Fx.
Per controllare il comportamento del tuo copilota quando chiedi un valore o convalidi la risposta di un utente, puoi configurare impostazioni aggiuntive per gli input.
Output
Per impostazione predefinita, la tua azione è configurata per generare automaticamente una risposta contestuale per un utente, in base alla sua query e al risultato dell'azione. Ad esempio, se un utente chiede "Qual è la temperatura attuale a Londra?", viene generata una risposta contestuale utilizzando GPT, ad esempio "La temperatura attuale a Londra è di 9 gradi Celsius".
In alternativa, puoi scegliere di creare una risposta specifica da restituire alla tua azione. Come con l'editor di conferma, puoi inserire riferimenti alle variabili di output dell'azione utilizzando il selettore di variabili come mostrato in questo esempio.
Chiamare un'azione da un argomento
Puoi chiamare un'azione esplicitamente da un argomento, in maniera simile a chiamare altri tipi di azioni come flussi di Power Automate. A seconda del caso d'uso, potresti utilizzare il tuo flusso come parte di un argomento più ampio, che utilizza più nodi. Oppure, come nell'esempio del meteo, aggiungere un singolo nodo di azione a un argomento potrebbe essere ciò di cui hai bisogno.
Per chiamare un'azione da un argomento:
In Copilot Studio, vai alla pagina Argomenti per il copilota che desideri modificare.
Crea un nuovo argomento e chiamalo Visualizza meteo.
Aggiungi le seguenti frasi trigger:
- pioverà
- previsioni per oggi
- ottieni previsioni
- com'è il tempo
Seleziona Aggiungi nodo (+) e quindi seleziona Chiama un'azione. Passa alla scheda Azioni plug-in (anteprima) e seleziona l'azione creata in precedenza Ottieni previsioni del tempo.
Il tuo nodo Azione plug-in (anteprima) è ora aggiunto al tuo argomento.
Seleziona Salva.
Sostituisci gli input quando chiami un'azione da un argomento
Per impostazione predefinita, quando viene eseguita l'azione, il copilota genera domande affinché l'utente possa compilare gli input richiesti. Tuttavia, potresti voler eseguire l'override di uno o più input e fornire un valore esplicito invece di chiedere all'utente. Puoi eseguire l'override nella configurazione dell'azione del plug-in all'interno della sezione Input. Oppure potresti sovrascrivere i valori solo quando la tua azione viene utilizzata da uno specifico argomento:
Seleziona Imposta valore sul nodo e scegli l'input che desideri sovrascrivere.
Immettere il valore per l'input digitando un valore, selezionando una variabile o utilizzando una formula.
Ora che questo input è sovrascritto, il copilota non chiederà più un valore all'utente.
Abilitare l'autenticazione azioni IA
Alcune azioni, se create in base alle azioni IA, richiedono l'autenticazione per funzionare correttamente, come il prompt dinamico o altre che chiamano un'API Dataverse.
Le azioni vengono sempre eseguite nel runtime di Microsoft Copilot nel contesto dell'utente finale e non possono essere eseguite a meno che l'autenticazione non sia abilitata. Sono supportati due tipi di metodi di autenticazione:
Vai alle proprietà dell'azione del connettore.
In Autenticazione utente finale, seleziona Autenticazione autore Copilot.
Pubblica e testa l'esperienza nel riquadro di test del copilota o nel canale desiderato.
Utilizza le azioni del flusso con le credenziali dell'utente finale
Le azioni del flusso possono essere configurate per utilizzare le credenziali dell'utente finale. Se utilizzi il flusso in un canale supportato, ciò non richiede alcuna configurazione speciale nella finestra di dialogo del copilota e gli utenti finali sono in grado di gestire le proprie connessioni per un determinato flusso in un'esperienza fornita.
Autenticazione per azioni basate sui plug-in nella tua libreria
Se create in base ai plug-in IA, le azioni richiedono l'autenticazione per funzionare correttamente. Questo si verifica più comunemente con azioni basate su prompt o altre che chiamano le API Dataverse. Le azioni basate sui plug-in vengono sempre eseguite nel contesto dell'utente finale e non possono essere eseguite a meno che l'autenticazione non sia abilitata. Sono supportati due tipi di metodi di autenticazione:
Autenticazione integrata (Teams e Power Apps): puoi utilizzare questo metodo di autenticazione se desideri pubblicare il tuo copilota su un canale Teams. Questo metodo funziona anche per i copiloti incorporati in qualsiasi app Power Platform che utilizza token creati con lo standard PPAPI.
Autenticazione manuale (copiloti di terze parti): questo metodo di autenticazione prevede l'impostazione di una connessione Microsoft Entra ID.
Per creare una connessione a un'autenticazione manuale:
Configura un'app Microsoft Entra ID.
Configura l'autenticazione manuale per il tuo copilota Copilot Studio.
Consenti alla tua app di utilizzare la delega per recuperare un token per conto dell'utente. Assicurati di aggiungere tutti gli ambiti necessari.
