Collaborare con il server MCP di Power Apps

Il protocollo MCP (Model Context Protocol) è un protocollo aperto che consente una perfetta integrazione tra applicazioni LLM (Large Language Model) e origini dati esterne e strumenti. Il tuo agente può usare il server MCP di Power Apps per comunicare con le tue Power Apps, fornendo una corretta supervisione con l'intervento umano o flussi di lavoro agentici.

Il server MCP Power Apps fornisce all'agente due tipi di funzionalità:

• Automatizzare le attività ripetitive delle app:

  Il server MCP Power Apps consente agli agenti di usare strumenti app avanzati sviluppati in Power Apps. Ad esempio, le funzionalità dell'agente di immissione dati precedentemente disponibili come funzionalità di intelligenza artificiale su richiesta sono ora accessibili a qualsiasi agente tramite Power Apps server MCP. Per usarli, è necessario creare l'agente, configurare lo strumento MCP e indirizzarlo al contenuto non strutturato in modo che possa generare record di Dataverse con revisione e approvazione umana tramite il feed dell'agente avanzato.

• Supervisionare l'attività dell'agente

  Il server MCP Power Apps fornisce anche strumenti specializzati per gli utenti aziendali per supervisionare qualsiasi attività dell'agente nel feed dell'agente. Gli agenti possono ora consegnare il controllo agli esseri umani per la revisione, l'assistenza e lo spostamento con gli strumenti MCP. Questi strumenti forniscono ai creatori un maggiore controllo sulle attività che vogliono pubblicare nel flusso dell'agente e quando è necessario un passaggio da agente a umano.

Gli strumenti MCP di Power Apps migliorano quanto più vengono usati. Ad esempio, quando si apportano correzioni ai suggerimenti nell'area di disegno dell'agente, lo strumento di immissione dei dati migliora in base alle correzioni. Per utilizzare le funzionalità avanzate del feed dell'agente, abilitare e configurare il server Power Apps MCP tramite l'agente di Microsoft Copilot Studio. Dopo la configurazione, è possibile richiamare Power Apps strumenti server MCP dalle istruzioni dell'agente usando il linguaggio naturale.

Altre informazioni: Creare un agente autonomo connesso al server MCP Power Apps

Configurare l'agente per utilizzare il server MCP di Power Apps.

Per configurare un agente esistente nella versione precedente del feed dell'agente per l'uso del server MCP Power Apps, è necessario eseguire le operazioni seguenti:

1. Aggiungi il server MCP Power Apps all'agente. A tale scopo, aprire l'agente in Copilot Studio e quindi selezionare Aggiungi strumento.

2. Cercare Power Apps MCP Server.

3. Selezionare Aggiungi e configura.

4. Aggiorna le istruzioni dell'agente per usare ognuno degli strumenti nel server MCP di Power Apps nei momenti appropriati nell'orchestrazione. Nel resto di questo documento sono disponibili esempi di come eseguire questa operazione.

5. Salva e pubblica l'agente.

Elenco di strumenti

Dopo la connessione al server MCP Power Apps, l'agente può scegliere tra vari strumenti nell'ambiente Power Platform. Questi strumenti possono generare elementi del feed agente che creano esperienze utente diverse, ad esempio una visualizzazione affiancata per gli agenti di immissione dati o la navigazione diretta a un record per scenari di tipo request_for_assistance.

log_for_review

Registra il lavoro dell'agente completato nel feed dell'agente per la revisione umana. Lo log_for_review strumento è destinato agli scenari in cui un agente dispone di informazioni sufficienti per agire in modo autonomo, ma l'utente deve comunque essere a conoscenza di ciò che l'agente ha fatto. Questo strumento può essere considerato come un modo per supervisionare passivamente le azioni ad alta attendibilità o a basso rischio eseguite dagli agenti. È più adatto per le decisioni che possono essere facilmente riviste o di cui è possibile eseguire il rollback se l'agente esegue l'azione in modo errato. Oltre al titolo, alla descrizione e ai passaggi, è anche possibile chiedere allo strumento di aggiungere un collegamento al record Dataverse pertinente o a un URL esterno dell'app. Se un'azione dell'agente tocca più record di Dataverse, è possibile indicare all'agente il record a cui deve passare in connessione con l'attività creata. Potrebbe trattarsi del collegamento al record creato dall'agente usando il server MCP Dataverse o un collegamento di record presente nel contesto, ad esempio il record che ha attivato l'esecuzione dell'agente. Queste attività vengono visualizzate nella scheda Completato del feed dell'agente.

Istruzione di esempio

Quando il cliente effettua una prenotazione dal portale, questo agente deve registrare i dettagli per la revisione. Il titolo dell'articolo di revisione deve essere basato sul numero di riferimento della prenotazione e deve usare il prefisso esatto "Review Web Booking: ". Nella descrizione della recensione scrivere un riepilogo conciso della prenotazione che include i campi principali come Riferimento prenotazione, Data prenotazione, Numero di posto e Stato, in modo che un revisore possa comprendere rapidamente cosa è stato elaborato senza aprire il record. Assicurarsi che la descrizione venga letta come paragrafo breve e rifletta accuratamente i valori correnti del record di prenotazione. Includi il ragionamento come passaggi. Includere anche un collegamento al record di prenotazione.

richiedi_assistenza

Lo scopo previsto dello strumento request_assistance è di consentire agli agenti di individuare errori, escalation o eccezioni per gli utenti, in modo che possano prendere provvedimenti appropriati. In qualità di creatore, puoi definire gli scenari in cui l'agente deve usare lo strumento request_assistance. Crea un'operazione nel feed agente che viene inserita nella sezione Richiede attenzione del feed dell'agente. Si tratta di un'operazione asincrona che chiama l'agente Microsoft Copilot Studio che attende fino al completamento dell'azione da parte dell'utente. Per informazioni dettagliate sul completamento dell'attività del feed delle azioni, vedi Supervisionare l'agente nelle app basate su modello con feed dell'agente (anteprima)

È possibile osservare lo stato In progress dell'esecuzione dell'agente nella scheda attività quando si visualizza l'agente in Copilot Studio. Una volta che l'utente ha completato l'attività dal feed dell'agente, il controllo ritorna all'agente tramite callback e l'agente può completare il compito.

Analogamente allo log_for_review strumento, è possibile controllare l'output dell'attività per titolo, descrizione e passaggi e può essere specifico quando si indica all'agente il collegamento da associare a una determinata attività.

Istruzione di esempio

Quando questo agente viene attivato dalla creazione di un nuovo caso di supporto, deve richiedere assistenza. Nella richiesta, imposta il titolo aggiungendo il valore del problema con "Assistenza necessaria:". Nella descrizione dell'attività sono inclusi il tipo di problema, la descrizione del problema, la data segnalata e il valore risolto. Includere i passaggi di ragionamento. Includi anche un collegamento al relativo record del problema di Dataverse. Una volta completata l'attività, continuare l'elaborazione impostando lo stato del caso su Chiuso.

Progetta il tuo utente nel ciclo

Prima di scrivere le istruzioni dell'agente, decidere dove appartiene la supervisione umana nel flusso di lavoro. Usare le domande seguenti per identificare quali momenti usare request_assistance, che devono usare log_for_reviewe quali possono essere gestiti in modo autonomo dall'agente.

Istruzioni di esempio in base al modello

Regola esplicita:

"Per qualsiasi attestazione con un importo stimato di perdita superiore a $ 5.000, usare request_assistance per instradare l'attestazione al regolatore assegnato prima di procedere."

Giudizio dinamico:

"Se la causa della perdita è ambigua o i documenti di reclamo sono in conflitto tra di loro, usare request_assistance per contrassegnare la richiesta per la revisione del liquidatore".

Supervisione passiva:

"Dopo aver completato la determinazione della copertura, usare log_for_review per registrare il risultato e confermare che la richiesta è stata approvata per procedere."

Esempio: agente di determinazione della copertura assicurativa del proprietario di casa

Nell'esempio seguente viene illustrato come questi modelli si applicano a un flusso di lavoro completo e reale.

L'agente viene attivato automaticamente quando viene inviata una nuova attestazione. Estrae le polizze, gli avalli e i documenti di supporto pertinenti da Dataverse, quindi li analizza per produrre una determinazione della copertura, verificando se la polizza era attiva, se il rischio richiesto è coperto e se eventuali conflitti di documenti influiscono sulla fiducia nel risultato.

Da qui, l'agente usa il server MCP Power Apps per visualizzare i risultati nel feed dell'agente in base a ciò che ha trovato. Se la richiesta è ambigua, in conflitto o richiede un giudizio del perito, l'agente usa request_assistance per creare un'attività per il perito assegnato fornendo il contesto necessario per agire. Se la richiesta è ben definita, l'agente usa log_for_review per registrare passivamente il risultato e non è necessaria alcuna azione. Quando un perito completa un'attività, l'agente riprende, legge la decisione, aggiorna il record del sinistro e registra un avviso di completamento nel registro.

Il risultato è un flusso di lavoro in cui l'agente gestisce in modo autonomo il volume di routine e coinvolge un essere umano solo nei veri punti decisionali, fornendo un contesto sufficiente affinché il perito possa agire immediatamente.

invoke_data_entry

Lo invoke_data_entry strumento semplifica la creazione di record di Dataverse estraendo informazioni strutturate da input non strutturati, ad esempio messaggi, messaggi o documenti. Quando viene richiamato da un agente di Copilot Studio, analizza automaticamente il contenuto in ingresso, compila il modulo appropriato con i dati estratti e presenta la voce proposta come attività nel feed dell'agente per la revisione e l'approvazione dell'utente. Richiede la revisione della voce proposta da un utente prima di creare il record. I record non vengono mai creati automaticamente usando lo invoke_data_entry strumento . Ciò consente l'acquisizione di dati veloce e affidabile con un lavoro manuale minimo.

Istruzione di esempio - Agente attivato tramite posta elettronica condivisa

Sei l'agente generatore di idee di viaggio. Il processo consiste nell'elaborare i messaggi di posta elettronica in arrivo e creare record di idea di viaggio in Dataverse.

Quando arriva un messaggio di posta elettronica:

1. Determinare se contiene informazioni relative ai viaggi (nel corpo o negli allegati del messaggio di posta elettronica).

2. Usare lo invoke_data_entry strumento per creare un record di idea di viaggio con le informazioni estratte nelle colonne seguenti:

   • cr3ea_title
   • cr3ea_description
   • cr3ea_triptype
   • cr3ea_customername
   • cr3ea_customeremail
   • cr3ea_customerphone
   • cr3ea_destinationcity
   • cr3ea_travelstart
   • cr3ea_travelend
   • cr3ea_numero_di_viaggiatori
   • cr3ea_budgetusd
   • cr3ea_specialrequests

3. Se mancano informazioni, creare comunque il record con i dati disponibili. Lasciare vuoti i campi sconosciuti.

Funzionamento dello strumento invoke_data_entry

Quando si configura un agente Copilot Studio per l'uso del server MCP Power Apps e si abilita lo strumento invoke_data_entry, l'agente segue questo processo:

1. Un trigger dell'agente viene generato in base alla tua configurazione, ad esempio un messaggio di posta elettronica in arrivo in una cassetta postale monitorata o un nuovo documento caricato all'interno di SharePoint.
2. L'agente analizza i contenuti in arrivo e le tue istruzioni per determinare se utilizzare lo strumento invoke_data_entry.
3. Se necessario, lo strumento invoke_data_entry viene richiamato, passando il contenuto di input e la tabella di destinazione nel Dataverse e le colonne della tabella da predire.
4. Lo strumento elabora l'input, estrae le informazioni pertinenti e popola un modulo Dataverse con valori suggeriti per ogni colonna mappata.
5. Un'attività viene visualizzata nel feed dell'agente. Selezionandola si attiva l'esperienza di revisione dell'inserimento dati. Il pannello sinistro mostra l'input originale e il pannello destro visualizza il modulo popolato con valori suggeriti.
6. L'utente può esaminare i valori estratti, apportare correzioni, se necessario, e quindi salvare il record in Dataverse.

Inviare commenti

Per fornire commenti e suggerimenti sullo strumento di invoke_data_entry:

1. Aprire un'attività invoke_data_entry nel feed dell'agente.
2. Selezionare il pulsante feedback nell'intestazione dell'attività.
3. Scegliere di fornire un complimento, segnalare un problema o inviare un suggerimento.

Articoli correlati

Aggiungi agenti all'app di tipo model-driven (anteprima)

Supervisionare gli agenti nelle app basate su modello con feed degli agenti (anteprima)