Usare le azioni con agenti personalizzati (anteprima)
Puoi estendere le funzionalità del tuo agente aggiungendo una o più azioni. Le azioni vengono utilizzate dall'agente per rispondere automaticamente agli utenti, utilizzando orchestrazione generativa, oppure puoi chiamarle esplicitamente da un argomento.
Tipi di azioni principali
Se attivi la orchestrazione generativa, l'agente può selezionare automaticamente l'azione o l'argomento più appropriato oppure cercare tra la conoscenza per rispondere a un utente.
In modalità classica (orchestrazione generativa disabilitata), un agente può utilizzare gli argomenti solo per rispondere all'utente. Tuttavia, è comunque possibile progettare l'agente in modo che chiami le azioni in modo esplicito dall'interno degli 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 di AI Builder (all'interno di un argomento)
- Competenza Bot Framework
- Connessione API REST
Ogni azione principale ha informazioni supplementari che ne descrivono lo scopo, permettendo all'agente di usare l'IA generativa per creare domande. Tali domande sono necessarie per compilare gli input richiesti per eseguire l'azione. Di conseguenza, non è necessario creare manualmente i nodi domanda per raccogliere tutti gli input necessari, ad esempio gli input in un flusso. Gli input sono gestiti automaticamente in fase di esecuzione.
Per impostazione predefinita, quando si utilizza la modalità generativa, le azioni restituiscono le informazioni all'agente, in modo che l'agente possa generare una risposta contestuale alla query dell'utente. In alternativa, puoi impostare un'azione in modo che risponda sempre immediatamente, generando un messaggio o creando un messaggio esplicito.
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 agente scegliendo Agenti nel riquadro di navigazione a sinistra e selezionando il tuo agente dall'elenco.
Seleziona Azioni per visualizzare le azioni per l'agente.
Seleziona Aggiungi un'azione.
Nella procedura guidata Scegli un'azione , cerca l'azione che desideri usare e selezionala.
L'elenco predefinito visualizzato contiene flussi Power Automate e connettori personalizzati disponibili nel tuo ambiente. Questo elenco include i connettori predefiniti di uso comune e competenze Bot Framework registrate con l'agente.
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 caso contrario, seguire le istruzioni della procedura guidata per configurare la connessione. Una volta configurata correttamente la connessione, seleziona Avanti.
Rivedi la configurazione dell'azione del plug-in e apporta modifiche se necessario.
Seleziona Avanti.
Seleziona Fine per aggiungere l'azione al tuo agente.
Testa l'azione
Se hai abilitato l'orchestrazione generativa, l'azione viene chiamata automaticamente in risposta a una query utente pertinente.
In alternativa, puoi richiamare un'azione esplicitamente da un argomento.
L'agente seleziona ed esegue la tua azione in base al nome e alla descrizione. Puoi creare descrizioni di alta qualità, utilizzando la mappa delle attività per vedere quali azioni ha selezionato l'agente dalla pagina azioni generative.
Puoi vedere un'azione meteorologica testata in questo screenshot:
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. Dalla schermata Rivedi input e output della procedura guidata o dalla pagina dei dettagli di un'azione che fa già parte dell'agente, è possibile gestire i parametri di input e output per l'azione.
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 l'agente 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 l'agente chiede all'utente una posizione, genera una domanda simile a 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.
È possibile modificare l'opzione Identifica come su un tipo di entità specifico, a seconda dell'input raccolto, in modo che l'agente possa estrarre con precisione un valore dalla risposta di un utente.
Input
Per impostazione predefinita, ogni input è impostato su Riempi dinamicamente con l'opzione migliore. L'agente tenta di estrarre il valore dal contesto disponibile, ad esempio 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 impostare una sostituzione, in Come agente riempirà questo input?, selezionare Imposta come valore e immettere il valore desiderato. Questo valore può essere un valore letterale, una variabile esistente o una formula Power Fx.
Per controllare il comportamento dell'agente 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.
Richiamare 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 l'agente che desideri modificare.
Crea un nuovo argomento e chiamalo Visualizza meteo.
Aggiungi le seguenti frasi trigger:
- pioverà
- previsioni odierne
- 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, l'agente 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 viene sovrascritto, l'agente non chiede all'utente un valore.
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 dell'agente 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 agente.
Pubblica e testa l'esperienza nel riquadro di test dell'agente o nel canale desiderato.
Utilizzare le azioni del flusso con le credenziali utente
Le azioni del flusso possono essere configurate per l'uso delle credenziali utente. L'uso di un flusso in un canale supportato non richiede alcuna configurazione speciale nella finestra di dialogo agente e gli utenti sono in grado di gestire le proprie connessioni per un determinato flusso in un'esperienza specificata.
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 utente 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 vuoi pubblicare il tuo agente su un canale di Teams. Questo metodo funziona anche per gli agenti incorporati in qualsiasi Power Platform app che utilizza token creati con lo standard PPAPI.
Autenticazione manuale (agenti di terze parti): questo metodo di autenticazione prevede la configurazione di una Microsoft Entra connessione ID.
Per creare una connessione a un'autenticazione manuale:
Configura un'app Microsoft Entra ID.
Configura l'autenticazione manuale per l'agente.
Consenti alla tua app di utilizzare la delega per recuperare un token per conto dell'utente. Assicurati di aggiungere tutti gli ambiti necessari.
