Skip to content
FundamentalsGitHub HarnessLab 05

Lab 05 - Automating with Workflows ​

Tempo stimato: ~90 minuti · Harness: GitHub Copilot

Scenario ​

I dispositivi aziendali di Zava (laptop, desktop, smartphone) sono censiti nella lista SharePoint Dispositivi del sito Zava Help Desk, con stato, produttore, modello e dati di acquisto. Oggi chi ha bisogno di un nuovo dispositivo deve chiedere quali sono disponibili e poi scrivere al proprio responsabile: l'IT vuole che tutto avvenga in chat, con una richiesta che arriva al responsabile già completa e solo se il dispositivo si può davvero assegnare.

Nel Lab 05 della standard harness lo scenario è risolto con due topic, una adaptive card e un agent flow. Qui l'Assistente Zava GH guida la conversazione con la skill richiesta-dispositivo e passa la richiesta confermata a un workflow, Invia richiesta dispositivo, che rilegge la lista e segue sempre uno di tre percorsi:

PercorsoChe cosa fa il workflowEsito restituito all'agente
Dispositivo disponibile (Status uguale a Available)Invia la richiesta al responsabile via emailDISPONIBILE
Dispositivo non disponibile (ad esempio In use)Non invia nullaESAURITO
Dispositivo non presente nella listaNon invia nullaNON_IN_CATALOGO

In tutti e tre i casi il workflow restituisce anche il modello (ModelValue), che l'agente cita nella risposta. Il nome di chi richiede lo prende l'agente dal profilo Microsoft 365 con Get my profile (V2), lo strumento del Lab 03. In particolare verranno svolte le seguenti attività:

  • Controllare i nomi interni delle colonne della lista Dispositivi.
  • Creare il workflow Invia richiesta dispositivo con trigger da agente, una lettura della lista, due condizioni e tre risposte all'agente.
  • Pubblicare il workflow e aggiungerlo come strumento, insieme allo strumento di lettura Leggi dispositivi.
  • Caricare la skill richiesta-dispositivo e aggiornare le istruzioni.
  • Provare i tre percorsi dall'agente e ispezionare le esecuzioni del workflow.
Perché questa scelta
  • Giudizio all'agente, regole al workflow. Capire quale tipo di dispositivo serve, mostrare le opzioni, raccogliere i requisiti e ottenere la conferma è lavoro di giudizio: lo fanno l'agente e la skill. Controllare lo stato del dispositivo e inviare la richiesta sono regole fisse: le esegue il workflow, che con lo stesso input produce sempre lo stesso risultato.
  • Workflow invece di agent flow. Nella GitHub Copilot harness le automazioni sono workflow: oggetti autonomi in Copilot Studio, con un designer proprio, un Health Center che segnala gli errori, il test dei singoli nodi e la scheda Activity per ispezionare le esecuzioni. Un workflow pubblicato può essere usato come strumento da qualsiasi agente dell'ambiente.
  • Un contratto esplicito. Il trigger When an agent calls the workflow definisce gli input, con nome e descrizione; il nodo Respond to the agent definisce gli output. Ogni percorso risponde con gli stessi output, così l'agente riceve sempre la stessa forma.
  • Un esito codificato. Il workflow restituisce un codice (DISPONIBILE, ESAURITO, NON_IN_CATALOGO); le istruzioni dell'agente decidono come comunicarlo. I fatti vengono dal workflow, le parole dall'agente.
  • Due controlli dello stato, per due ragioni. Per mostrare le opzioni la skill legge solo i dispositivi Available con lo strumento Leggi dispositivi. Il workflow però rilegge l'elemento al momento dell'invio: nel frattempo qualcuno può aver preso lo stesso dispositivo, e una richiesta per un dispositivo non più disponibile non deve arrivare al responsabile.
  • L'ID dell'elemento, non il nome. La skill associa ogni opzione all'ID dell'elemento SharePoint e lo passa al workflow come sharepointItemId: un identificatore non è ambiguo, mentre il nome di un modello può essere scritto in più modi.
  • Il richiedente da una fonte affidabile. Il nome di chi richiede arriva da Get my profile (V2): non viene chiesto in chat e non si può dichiarare di essere un'altra persona.
  • Limiti da conoscere. Il workflow deve rispondere all'agente entro 100 secondi, con la risposta asincrona disattivata, e deve essere pubblicato per comparire tra gli strumenti. Ogni azione eseguita consuma capacità di Copilot Studio.

Che cosa si costruisce ​

Lo schema mostra il workflow Invia richiesta dispositivo alla fine del lab: una lettura della lista, due condizioni e tre risposte all'agente con lo stesso contratto; solo il percorso del dispositivo disponibile invia l'email al responsabile.

WORKFLOW · INVIA RICHIESTA DISPOSITIVOElseIn CatalogoElseDisponibile
Passa il mouse su un riquadro o selezionalo per vederne il dettaglio.

Prerequisiti ​

Per svolgere questo lab occorre avere:

  • completato il Lab 04: l'agente Assistente Zava GH con gli strumenti Get my profile (V2) e Invia guida via email, le skill supporto-tecnico, apertura-ticket e guida-passo-passo e le istruzioni che terminano con le sezioni # Strumenti ed email e # Procedure;
  • il sito SharePoint Zava Help Desk - Vostro Nome (indirizzo ZavaHelpDesk) con la lista Dispositivi, creata nel Lab 01;
  • la skill richiesta-dispositivo/SKILL.md, che nel Lab 04 non è stata caricata;
  • una casella Outlook del tenant di laboratorio: il workflow invierà email reali al proprio indirizzo.

Lista Dispositivi - nomi interni ​

Il workflow cercherà il dispositivo per ID e ne leggerà stato, produttore e modello. La lista è stata creata nel Lab 01 da un CSV che contiene anche lo schema, quindi i nomi interni dovrebbero essere già quelli giusti; prima di scrivere filtri ed espressioni conviene comunque controllarli, perché SharePoint assegna il nome interno alla creazione della colonna e non lo cambia più, anche se si rinomina la colonna.

  1. Aprire il sito Zava Help Desk - Vostro Nome e la lista Dispositivi. Controllare che contenga sei dispositivi e che Contoso Phone Z abbia Status uguale a In use.

  2. Nella vista della lista selezionare + Add column e poi Show/hide columns, selezionare ID e applicare: la colonna ID mostra l'ID di ogni elemento.

  1. Annotare l'ID di Microsoft Surface Laptop 5 e quello di Contoso Phone Z: è l'ID dell'elemento SharePoint che la skill passerà al workflow, e serve nei test.

  2. Aprire List settings, selezionare la colonna Asset type e leggere il parametro Field=AssetType nell'indirizzo della pagina. Ripetere per Status (Field=Status) e Model (Field=Model).

Nome visualizzatoNome interno attesoTipo
TitleTitleTesto
ManufacturerManufacturerScelta
StatusStatusScelta: Available, Reserved, In use, In repair, Retired
ModelModelTesto
Asset typeAssetTypeScelta: Smartphone, Laptop, Desktop
ColorColorScelta
Order #OrderNumberTesto

Importante

Nomi interni e colonne di scelta

Asset type ha nome interno AssetType, senza spazio. Le colonne di scelta restituiscono un oggetto con la proprietà Value: per questo le espressioni del workflow leggono ?['Status']?['Value'] e non ?['Status']. I valori delle scelte sono in inglese: non tradurli. Se la lista è stata creata in un altro modo e i nomi interni sono diversi, usare i propri nel workflow e negli strumenti.

Workflow - Invia richiesta dispositivo ​

Creare il workflow e definire il contratto ​

Il contratto viene prima della logica: gli input dicono all'agente che cosa deve passare, gli output che cosa riceverà. I nomi e le descrizioni degli input sono quelli che la skill richiesta-dispositivo usa al passaggio di invio.

  1. Nella barra laterale di Copilot Studio selezionare Workflows, poi New workflow. Il designer si apre con un nodo Start con trigger Manual.
Il designer dei workflow

Il designer ha a sinistra il nome e lo stato del workflow e la tavolozza dei nodi; al centro le schede Build, Activity e Monitor e la tela; a destra i comandi (annulla, ripristina, cronologia delle versioni, salva, prova, problemi, pubblica) e il pannello di configurazione del nodo selezionato.

  1. Rinominare il workflow:
text
Invia richiesta dispositivo

  1. Selezionare il nodo Start e cambiare il Trigger type in When an agent calls the workflow. Sulla tela il nodo può comparire come When an agent calls the flow: è lo stesso trigger.

  2. Con Add an input aggiungere tre input di tipo testo, ciascuno con la sua descrizione:

NomeDescrizione
sharepointItemIdID numerico dell'elemento della lista SharePoint Dispositivi corrispondente al dispositivo scelto dall'utente
additionalCommentRequisiti aggiuntivi indicati dall'utente (ad esempio RAM, memoria, accessori). Se non ce ne sono, il testo Nessun requisito aggiuntivo
requestorNameNome visualizzato di chi fa la richiesta, come restituito da Get my profile (V2)

Il workflow copia requestorName e additionalComment nell'email così come li riceve: da dove prendere i valori lo dicono le descrizioni degli input, la skill e le istruzioni dell'agente.

Cercare il dispositivo nell'inventario ​

Una sola lettura della lista, filtrata sull'ID e limitata a un elemento, basta a distinguere i casi: se non torna nulla l'ID non corrisponde a nessun dispositivo, altrimenti si guarda lo stato.

  1. Selezionare + (Add a step) dopo il trigger. Nel riquadro Add cercare Get items e scegliere l'azione Get items di SharePoint. Rinominarla:
text
Cerca dispositivo

  1. Impostare Site Address sul sito Zava Help Desk - Vostro Nome e List Name su Dispositivi.

  2. Con Show all, nel campo Filter Query scrivere ID eq e inserire il contenuto dinamico sharepointItemId del trigger (pulsante fulmine Insert dynamic content, oppure digitare /). Il risultato ha questa forma, dove sharepointItemId è il contenuto dinamico e non il testo, senza apici perché ID è un numero:

text
ID eq sharepointItemId

  1. Nel campo Top Count scrivere 1.

  2. Provare solo questo nodo: nel pannello di Cerca dispositivo selezionare il pulsante di avvio (Test), scrivere nel campo sharepointItemId l'ID di Contoso Phone Z annotato prima e selezionare Run test. Nell'output c'è un elemento con Model CP-Z2022 e Status con Value In use.

Suggerimento

Test di un nodo

Il test di un nodo esegue solo quell'azione, senza pubblicare il workflow e senza eseguire il resto. Se si riceve un errore sul filtro, ricontrollare i nomi interni della lista. Con un valore non numerico, ad esempio una lettera, il filtro ID eq produce un errore: la skill passa sempre l'ID numerico dell'elemento.

Primo bivio: il dispositivo è in inventario? ​

Una lista vuota non è un errore: è uno dei tre percorsi previsti, e la decisione si prende nel workflow con una condizione. Nel ramo Else il workflow risponde subito all'agente con l'esito NON_IN_CATALOGO.

  1. Dalla tavolozza dei nodi trascinare il nodo condizionale (If / Else) dopo Cerca dispositivo e rinominarlo Dispositivo in inventario.

  1. Selezionare il ramo If e, in Property, inserire l'espressione:
text
length(body('Cerca_dispositivo')?['value'])
Come si legge l'espressione

Restituisce il numero di dispositivi trovati da Cerca dispositivo.

  • body('Cerca_dispositivo'): il risultato del nodo Cerca dispositivo.
  • ?['value']: l'elenco degli elementi trovati; il ? evita un errore se l'elenco manca.
  • length(...): conta gli elementi dell'elenco.

Risultato: 1 se l'ID corrisponde a un dispositivo, 0 se la lista è vuota. Per questo la condizione confronta con Greater 0.

  1. Impostare Operator su Greater e Value su 0.

Suggerimento

Nome dell'azione nelle espressioni

L'espressione richiama l'azione con il suo nome, con gli spazi sostituiti da trattini bassi: Cerca dispositivo diventa Cerca_dispositivo. Se l'azione non è stata rinominata, usare Get_items. Un nome sbagliato compare in rosso nel nodo e nell'Health Center.

  1. Nel campo Branch name rinominare il ramo If in In Catalogo.

  1. Nel ramo Else selezionare + e scegliere Respond to the agent. Con Add an output creare due output di testo:
OutputValore
esitoNON_IN_CATALOGO
ModelValueNessun dispositivo

Secondo bivio: il dispositivo è disponibile? ​

Se il dispositivo esiste, resta da guardare lo stato. Solo nel percorso "disponibile" il workflow invia la richiesta al responsabile; nel percorso "esaurito" risponde senza inviare nulla, così nessuno riceve richieste che non possono essere evase.

  1. Nel ramo In Catalogo di Dispositivo in inventario aggiungere un secondo nodo condizionale, Dispositivo disponibile, e configurarne il ramo If:
  • Branch name: Disponibile;
  • Property: l'espressione first(body('Cerca_dispositivo')?['value'])?['Status']?['Value'];
  • Operator: Equals;
  • Value: Available.

Come si legge l'espressione

Restituisce lo stato del dispositivo trovato, ad esempio Available.

  • body('Cerca_dispositivo')?['value']: l'elenco dei dispositivi trovati.
  • first(...): ne prende il primo elemento; con Top Count 1 è anche l'unico.
  • ?['Status']: la colonna Status di quell'elemento. Le colonne di scelta restituiscono un oggetto, non direttamente il testo.
  • ?['Value']: il testo della scelta, dentro quell'oggetto.

Risultato: Available oppure, ad esempio, In use. La stessa forma first(body('Cerca_dispositivo')?['value'])?['Model'] legge un'altra colonna, ad esempio il modello nel corpo dell'email e nell'output ModelValue.

  1. Nel ramo Disponibile selezionare +, cercare send an email e scegliere Send an email di Office 365 Outlook. Rinominarlo Avvisa responsabile, creare la connessione se richiesto e impostare:
  • To: il proprio indirizzo (in produzione sarebbe la casella del responsabile di chi richiede);
  • Subject: Richiesta nuovo dispositivo da seguito dal contenuto dinamico requestorName;
  • Body: lasciare vuoto per ora, si compila nei passaggi seguenti.
  1. Nel campo Body selezionare l'icona </> per passare alla vista del codice HTML e incollare il seguente testo. Le espressioni @{...} leggono i valori dal trigger e dal nodo Cerca dispositivo: non serve inserirle a mano.
html
<p>Ciao,</p>
<p>nuova richiesta di dispositivo.</p>
<p>
<strong>Richiesta inviata da:</strong> @{triggerBody()?['requestorName']}<br>
<strong>Produttore:</strong> @{first(body('Cerca_dispositivo')?['value'])?['Manufacturer']?['Value']}<br>
<strong>Modello:</strong> @{first(body('Cerca_dispositivo')?['value'])?['Model']}<br>
<strong>Collegamento all'elemento:</strong> <a href="@{first(body('Cerca_dispositivo')?['value'])?['{Link}']}">Apri il dispositivo</a><br>
<strong>Requisiti aggiuntivi:</strong> @{triggerBody()?['additionalComment']}
</p>
<p><em>Email automatica inviata dal workflow Invia richiesta dispositivo.</em></p>
  1. Selezionare di nuovo </> per tornare alla vista normale e verificare che le espressioni compaiano come valori dinamici. Le espressioni funzionano solo se il nodo di ricerca si chiama esattamente Cerca dispositivo.

  2. Dopo Avvisa responsabile aggiungere Respond to the agent con gli stessi due output:

OutputValore
esitoDISPONIBILE
ModelValuel'espressione first(body('Cerca_dispositivo')?['value'])?['Model']

  1. Nel ramo Else di Dispositivo disponibile aggiungere Respond to the agent:
OutputValore
esitoESAURITO
ModelValuel'espressione first(body('Cerca_dispositivo')?['value'])?['Model']

Importante

Lo stesso contratto in ogni percorso

I tre nodi Respond to the agent devono avere gli stessi output, con gli stessi nomi e tipi: l'agente riceve sempre lo stesso contratto, qualunque percorso sia stato seguito. ModelValue ha esattamente questo nome perché è quello che la skill richiesta-dispositivo cita nella conferma.

Salvare, controllare e pubblicare ​

Un workflow con errori non si pubblica, e un workflow non pubblicato non compare tra gli strumenti dell'agente. Prima della pubblicazione si controlla anche che la risposta all'agente sia sincrona: l'agente aspetta l'esito per rispondere all'utente.

  1. In ciascun nodo Respond to the agent aprire le impostazioni e verificare che Asynchronous response, nella sezione Networking, sia disattivato.

  1. Selezionare l'icona Save. Se l'Health Center segnala problemi, risolverli: di solito un campo obbligatorio vuoto o un'espressione con il nome dell'azione sbagliato.

  2. Selezionare Publish. Lo stato del workflow passa a Published.

Nota

Tempo di risposta

Il workflow deve rispondere all'agente entro 100 secondi. Questo impiega pochi secondi; con liste grandi o servizi lenti conviene filtrare sul server e restituire solo i dati necessari (Add a workflow as a tool to an agent).

Tool - Invia richiesta dispositivo e Leggi dispositivi ​

La skill usa due strumenti: Leggi dispositivi, per mostrare all'utente i dispositivi disponibili, e il workflow, per inviare la richiesta. Il workflow pubblicato diventa uno strumento dell'agente: la sua descrizione dice all'orchestratore quando usarlo e come interpretare gli esiti.

  1. Aprire l'agente Assistente Zava GH, scheda Build.

  2. Selezionare Tools e, nella finestra Add a tool, il filtro Workflows. Scegliere Invia richiesta dispositivo e selezionare Add. Compaiono solo i workflow pubblicati con il trigger da agente e il nodo Respond to the agent.

  1. Aprire lo strumento. Nel pannello Workflow details, scheda Details, controllare input e output e scrivere la descrizione:
text
Registra la richiesta di un dispositivo aziendale della lista SharePoint Dispositivi. Riceve l'ID dell'elemento scelto (sharepointItemId), i requisiti aggiuntivi (additionalComment) e il nome di chi richiede (requestorName, da Get my profile (V2)). Rilegge l'elemento e restituisce un esito: DISPONIBILE (richiesta inviata al responsabile), ESAURITO (dispositivo non più disponibile, nessuna richiesta inviata) o NON_IN_CATALOGO (nessun dispositivo con quell'ID, nessuna richiesta inviata), più il modello nel campo ModelValue. Usalo solo quando la skill richiesta-dispositivo lo indica, dopo che l'utente ha confermato dispositivo e requisiti.

  1. Selezionare Save.

  2. Aggiungere lo strumento di lettura: selezionare di nuovo Tools, filtro Connectors, cercare Get items e scegliere l'azione Get items di SharePoint. Creare o selezionare la connessione e selezionare Add.

  1. Aprire lo strumento. Nella finestra Tool details selezionare l'icona a forma di matita accanto al nome e rinominarlo con il nome con cui lo cita la skill:
text
Leggi dispositivi
  1. Nel campo Description for Intelligence scrivere:
text
Legge i dispositivi aziendali dalla lista SharePoint Dispositivi di Zava e li restituisce con ID, produttore, modello, colore, tipo e stato. Usalo per mostrare i dispositivi disponibili del tipo richiesto (Laptop, Desktop o Smartphone). Nel parametro Filter Query usa i nomi interni delle colonne, ad esempio Status eq 'Available' and AssetType eq 'Laptop'. Non modifica la lista e non invia richieste.
Come si legge l'espressione

Filtro che l'agente scrive nel parametro Filter Query: tiene solo gli elementi che rispettano entrambe le condizioni.

  • Status eq 'Available': eq significa "uguale a"; la colonna Status deve valere Available. I valori di testo e di scelta stanno tra apici singoli.
  • and: unisce le condizioni, che devono essere vere insieme.
  • AssetType eq 'Laptop': la colonna AssetType deve valere Laptop.

Risultato: i soli portatili disponibili. Si usano i nomi interni delle colonne, quindi AssetType e non "Asset type".

  1. Aprire la scheda Inputs e impostare:
InputCompilazioneValore
Site AddressCustomil sito Zava Help Desk - Vostro Nome
List NameCustomDispositivi
Filter QueryFill with Intelligence
Top CountCustom20

  1. Controllare che Authentication indichi End user account e selezionare Done e poi Save.

Skill - richiesta-dispositivo ​

La skill richiesta-dispositivo descrive la conversazione: tipo di dispositivo, tabella delle opzioni, scelta, requisiti, riepilogo con conferma e invio. Dei tre esiti del workflow la skill conosce solo la conferma con ModelValue; spiegare gli altri due è compito delle istruzioni, perché valgono per ogni uso del workflow.

  1. Scaricare richiesta-dispositivo/SKILL.md.

  2. Nella scheda Build, nel pannello dei componenti, selezionare Skills (o + accanto a Skills); nella finestra Add skill selezionare Upload a skill, trascinare il file e confermare, come nel Lab 04.

  3. Selezionare la skill e rileggerne le istruzioni.

Notare in particolare:

  • il filtro di esempio sui nomi interni (Status eq 'Available' and AssetType eq 'Laptop'), uguale a quello della descrizione di Leggi dispositivi;
  • la tabella delle opzioni con produttore, modello e colore, e l'ID SharePoint associato a ogni lettera;
  • la domanda sui requisiti, con il testo fisso Nessun requisito aggiuntivo;
  • riepilogo e conferma prima dell'invio, e annullamento senza chiamare il workflow;
  • la lettura del nome con Get my profile (V2) e i tre input del workflow, sharepointItemId, additionalComment e requestorName, gli stessi del trigger;
  • la chiamata al workflow una sola volta per conferma.
  1. Selezionare Save.

  2. Nel riquadro Instructions aggiungere in fondo alla sezione # Procedure del Lab 04 una quarta riga:

text
- Per vedere i dispositivi disponibili o richiedere un dispositivo aziendale (laptop, desktop o smartphone), attività che rientra nei tuoi compiti, segui la skill richiesta-dispositivo. Comunica l'esito dello strumento Invia richiesta dispositivo: DISPONIBILE significa che la richiesta è stata inviata al responsabile; ESAURITO che il dispositivo non è più disponibile e non è stata inviata nessuna richiesta, quindi proponi di sceglierne un altro; NON_IN_CATALOGO che il dispositivo non è nella lista e non è stata inviata nessuna richiesta. Non dire mai che una richiesta è stata inviata se l'esito non è DISPONIBILE.

Non serve una nuova sezione: le tre righe del Lab 04 restano come sono, e la nuova riga allarga ai dispositivi il perimetro della sezione # Ruolo e ambito del Lab 02, scritta per il supporto IT.

  1. Selezionare Save.

Testing ​

Ogni prova mette alla prova una parte diversa: il percorso DISPONIBILE dalla conversazione completa, la lettura dell'inventario che nasconde i dispositivi in uso, due comportamenti della skill (limite dell'inventario, annullamento) e i percorsi ESAURITO e NON_IN_CATALOGO, che una conversazione normale non raggiunge perché la skill mostra solo dispositivi disponibili. All'inizio di ogni prova selezionare New chat in Preview, con End user preview disattivato.

ProvaScenarioCrediti stimati
05-1Laptop disponibile, workflow ed email
05-2Contoso Phone Z non offerto
05-3Tablet, fuori inventario
05-4Annullamento
05-5Esito ESAURITO, strumento chiamato direttamente
05-6Esito NON_IN_CATALOGO, strumento chiamato direttamente

Dispositivo disponibile ​

  1. Scrivere:
text
Mi serve un laptop

Nella traccia compare Leggi dispositivi con un filtro come Status eq 'Available' and AssetType eq 'Laptop'. L'agente mostra una tabella con tre opzioni, A, B e C, con produttore, modello e colore: Fabrikam Laptop X1 (FX1-2023, Space gray), Microsoft Surface Laptop 5 (Silver) e Microsoft Surface Laptop Studio 2 (Black).

  1. Rispondere B. L'agente chiede se ci sono requisiti aggiuntivi: rispondere Almeno 16 GB di RAM.

  1. L'agente mostra dispositivo e requisiti e chiede se procedere. Rispondere Sì, procedi e consentire le connessioni se compare Permission required.

  1. Nella traccia compaiono Get my profile (V2) e poi la chiamata a Invia richiesta dispositivo con sharepointItemId uguale all'ID di Surface Laptop 5 annotato prima, additionalComment uguale a Almeno 16 GB di RAM e requestorName uguale al proprio nome visualizzato; l'output ha esito uguale a DISPONIBILE e ModelValue uguale a Surface Laptop 5.

  2. L'agente conferma la richiesta citando il modello e spiega che il responsabile la esaminerà. Controllare la propria casella: l'email riporta nome, produttore Microsoft, modello, collegamento all'elemento e Almeno 16 GB di RAM.

Dispositivo in uso ​

  1. Scrivere:
text
Vorrei il Contoso Phone Z

L'agente capisce che serve uno smartphone e legge i dispositivi Available di tipo Smartphone: la tabella contiene solo Trey Smartphone Elite (TS-E2025, Dark blue), perché Contoso Phone Z ha Status uguale a In use. Se si chiede di nuovo il Contoso, l'agente non lo offre e non chiama il workflow. Annullare la richiesta.

Fuori inventario ​

  1. Scrivere:
text
Mi serve un tablet

L'agente chiede di scegliere tra Laptop, Desktop e Smartphone, i tipi che la skill conosce, e non inventa un elenco di tablet: nella traccia non c'è nessuna chiamata a Invia richiesta dispositivo.

Annullamento ​

  1. Scrivere Mi serve un desktop, scegliere l'opzione proposta e rispondere Nessuno alla domanda sui requisiti.

  2. Alla richiesta di conferma rispondere No, annulla: l'agente conferma l'annullamento e nella traccia non c'è nessuna chiamata a Invia richiesta dispositivo.

I due percorsi senza invio si provano chiamando lo strumento direttamente, come nel Lab 04 si è caricata una skill per nome: è una tecnica di verifica in Preview, non una richiesta da utente finale.

  1. In una nuova chat scrivere, sostituendo <ID> con l'ID di Contoso Phone Z annotato prima:
text
Prova del workflow: chiama lo strumento Invia richiesta dispositivo con sharepointItemId <ID>, additionalComment Nessun requisito aggiuntivo e requestorName Prova laboratorio, poi riporta l'esito.

Nella traccia l'output ha esito uguale a ESAURITO e ModelValue uguale a CP-Z2022; l'agente spiega che il dispositivo non è disponibile e che non è stata inviata nessuna richiesta. Non arriva nessuna email.

  1. In una nuova chat ripetere la stessa richiesta con sharepointItemId uguale a 999: l'output ha esito uguale a NON_IN_CATALOGO e ModelValue uguale a Nessun dispositivo, e l'agente spiega che il dispositivo non è nella lista.

Ispezionare le esecuzioni ​

Ogni esecuzione del workflow lascia una traccia, nodo per nodo, con input e output. È il primo posto in cui guardare quando un'email non arriva o l'esito non è quello atteso: insieme alla traccia dell'agente dà le due metà della stessa chiamata, che cosa ha passato l'agente e che cosa è successo dentro il workflow.

  1. Aprire Workflows, poi Invia richiesta dispositivo, scheda Activity. L'elenco mostra le esecuzioni con il loro stato (ad esempio Succeeded o Failed) e si può filtrare.

  2. Selezionare l'esecuzione della prova 1: sulla tela ogni nodo mostra gli input ricevuti e gli output prodotti. Controllare i valori di sharepointItemId, additionalComment e requestorName ricevuti dal trigger, il filtro ricevuto da Cerca dispositivo, i rami seguiti e gli output di Respond to the agent.

  3. Aprire le esecuzioni delle prove 5 e 6: il percorso è diverso e il nodo Avvisa responsabile non è stato eseguito.

  4. Per riprodurre un caso, aprire il nodo Cerca dispositivo, selezionare Test e scegliere un'esecuzione in Load values from previous run: i dati di quell'esecuzione vengono caricati negli input del nodo.

Importante

Lab Completato

L'Assistente Zava GH ora mostra i dispositivi disponibili e passa la richiesta confermata al workflow Invia richiesta dispositivo, che la invia al responsabile solo se il dispositivo è ancora disponibile. In questo lab si è visto:

  • come dividere il lavoro tra agente (giudizio) e workflow (regole fisse);
  • come definire il contratto agente-workflow con input descritti e output uguali in ogni percorso;
  • come leggere una lista SharePoint con un filtro sui nomi interni, leggere il valore di una colonna di scelta e decidere con le condizioni;
  • come provare un singolo nodo, pubblicare un workflow, aggiungerlo come strumento e ispezionarne le esecuzioni;
  • come una skill e un workflow collaborano: la conversazione alla skill, il controllo finale e l'invio al workflow;
  • come far compilare all'agente gli input del workflow da una fonte affidabile, il profilo, invece di chiederli.