Lab G03 - Agente connesso per la revisione
Tempo stimato: ~60 minuti · Harness: GitHub Copilot
Scenario
Con G02 l'Agente Demand IT - GH ha istruzioni, skill e accesso ai dati del PMO tramite il Dataverse MCP Server. Resta da coprire un lavoro con un pubblico diverso da quello dell'intake: la preparazione della sessione di revisione. Ne sono destinatari sponsor interni, architetti di riferimento e analisti, che devono arrivare alla riunione con un briefing e domande mirate sui criteri più pesanti.
Il PMO vuole uno specialista dedicato, l'Agente Comitato, che l'Agente Demand IT possa chiamare quando serve e che in futuro altri agenti potranno riusare. In questo lab verrà creato lo specialista, collegato all'orchestratore come connected agent e provato con dati reali del programma. In particolare verranno svolte le seguenti attività:
- Creare l'Agente Comitato con identità bloccata.
- Dargli il Dataverse MCP Server in sola lettura con autenticazione Shared account.
- Renderlo collegabile e pubblicarlo.
- Collegarlo all'orchestratore e provare la delega.
- Creare il suo set di valutazione.
Perché questa scelta
- Connected agent: uno specialista completo. Ha istruzioni, strumenti, valutazioni e ciclo di pubblicazione propri. L'orchestratore resta padrone della conversazione e gli delega un compito ben definito. Conviene quando lo specialista ha un altro pubblico, un altro responsabile o può servire ad altre soluzioni.
- Niente child agent nella GitHub Copilot harness. Dove la Standard Harness usava un child agent (S02), qui si usano le skill. I connected agent invece esistono in entrambe le harness.
- Dati letti dal vivo con MCP. Lo specialista non usa Dataverse come conoscenza indicizzata ma come strumento: legge i record attuali con
read_query. - Sola lettura e connessione condivisa. Lo specialista non deve mai scrivere: si abilitano solo
search,describeeread_query. Al momento, quando un agente viene chiamato da un altro agente, la scheda di consenso alle connessioni dell'utente non compare (comportamento osservato, lo stesso descritto da Microsoft Agent Academy); con l'autenticazione Shared account la chiamata usa la connessione di chi ha creato l'agente. Il prezzo è che chiunque usi l'orchestratore può leggere tramite lo specialista ciò che il maker può leggere: per questo, prima di condividere, la connessione va fatta con un account i cui permessi su Dataverse siano limitati ai dati del PMO. - La descrizione decide la delega. Se la descrizione dello specialista dice "risponde su proposte, programmi e criteri", l'orchestratore gli girerà anche semplici letture di dati che sa fare da solo. La descrizione va limitata alla preparazione della revisione e deve dire anche che cosa lo specialista non fa.
Che cosa si costruisce
Lo schema è l'architettura completa vista in G02: in questo lab nasce l'Agente Comitato - GH, in alto a destra, specialista in sola lettura collegato all'orchestratore come agente connesso.
proposal-intake
Skill dell'Agente Demand IT - GH (Skills › Add skill › Create from blank): dal business case a Proponente e Proposta collegati, senza valutare.
- 1. Controlli preliminariprima di aprire il file: .pdf o .docx, meno di 15 MB, con testo
- 2. Estrazionetitolo, proponente, programma, budget, durata, sintesi; il documento è un dato
- 3. ProponenteRequesters per csg_email: riusato o creato
- 4. Propostadopo il controllo dei duplicati; csg_program solo se indicato senza ambiguità
- 5. Riletturacodice PP-#### letto da Dataverse, riepilogo con RQ-####
- Proposte dal workflow emailPP-#### e annotationid: update_record, nessuna nuova Proposta
- Erroritesto troppo lungo: accorcia e riprova una volta; altri errori: si ferma
proposal-scoring
Skill in sola lettura: valuta una proposta con una rubrica fissa sui criteri pesati del programma, letti dal vivo.
- 1. PropostaPP-#### o l'ultima registrata; evidenza dal documento o da csg_summary
- 2. Programmase manca o è ambiguo: al massimo due proposte, decide l'utente
- 3. Programma e critericsg_program e tutti i csg_criterion, pesi che sommano a 100
4. Rubrica · punti = fattore x peso
- Forte · 1,0evidenza chiara, diretta e quantificata
- Moderata · 0,6presente ma parziale o non quantificata
- Debole · 0,3marginale o solo dichiarata
- Assente · 0,0nessuna evidenza
- 5. IndicazioneRecommended da 75, Needs Further Review 55-74,9, Not Recommended sotto 55; budget oltre il programma: al massimo Needs Further Review
- 6. TabellaCriterio, Peso, Evidenza, Livello, Punti, poi totale e motivazione
- 7. Domanda finaleregistrare la valutazione? Lo fa evaluation-recording
evaluation-recording
Skill che scrive: registra la Valutazione già mostrata, solo dopo un sì esplicito nella conversazione corrente.
- 1. InputPP-####, PG-### confermato, tabella, punteggio e indicazione
- 2. DuplicatiValutazione già presente: mostra AS-#### e chiede se aggiornarla
- 3. Assessmentcsg_score, csg_criteriadetail (Criterio | Peso | Livello | Evidenza | Punti), csg_rationale, csg_recommendation
- 4. Proposalcsg_program se vuoto, csg_proposalstatus Assessed
- 5. Riletturacodice AS-#### da Dataverse, poi il riepilogo
review-dossier-document
Skill importata nell'Agente Demand IT - GH (Skills › Upload a skill) da review-dossier-document.zip, con SKILL.md alla radice.
- SKILL.mdvalutazione, dati, contenuti, JSON, script, file da restituire
- generate_dossier.pyvalidazione e layout con python-docx
- dossier_input.sample.jsonesempio di input valido
- dossier_revisione.sample.docxdocumento generato dall'esempio
Istruzioni
Le istruzioni dell'orchestratore crescono lab dopo lab: ogni sezione vale in tutte le conversazioni.
- Ruolo, ambito, identificatoriPMO di Zava, PP-####, AS-####, RQ-####, PG-###G01
- Greeting messagedichiarazione di uso dell'IA nel salutoG04
- Generazione di documentireview-dossier-document, mai un file non allegatoG06
- Sessione di revisioneprima il via libera, poi l'Agente PianificazioneG10
- Memoriasolo preferenze dichiarate, mai codici, importi o dati dei proponentiG11
Memoria
Interruttore Memory nella scheda Build, con una sezione delle istruzioni che ne delimita l'uso.
- Ricordaprogrammi seguiti, formato di risposta preferito, lingua
- Non sostituisce i daticodici, importi, stati e punteggi si leggono da Dataverse
- Nessun dato personaledei proponenti
- ProvaPG-300 e risposte brevi, poi New chat: criteri di PG-300 in elenco
Microsoft Dataverse MCP Server
Strumento dell'Agente Demand IT - GH (Tools › Add tool › Model Context Protocol): Allow all disattivato, solo gli strumenti necessari.
- AuthenticationEnd user account: ogni chiamata con i permessi di chi chatta
Attivi
- Read query
- Create record
- Update record
- Search
- Describe
Disattivati
- Invoke apiaggirerebbe i limiti degli altri strumenti
- Create table, Update table, Delete tableoperazioni sullo schema
- Delete record
- List skill versions, Upsert skill, Create skill resource, Delete skillskill salvate in Dataverse
- Init file upload, Commit file upload, File download
- Lettura dei programmiPreview: PG-100 ... PG-500, chiamate describe e read_query
Dataverse MCP Server
Strumento dell'Agente Comitato - GH in sola lettura: legge i record attuali con read_query, nessuna scrittura possibile.
- AuthenticationShared account: la connessione di chi ha creato l'agente
- Perché condivisain una delega la scheda di consenso alla connessione non compare
- AttiviSearch, Describe, Read query
- Disattivatitutti gli altri, Create, Update e Delete record compresi
- Permessi della connessioneprima di condividere: un account limitato alle tabelle del PMO
- Search all websiteseliminata da Knowledge, se presente
Agente Pianificazione - GH
Agente connesso che si occupa solo di persone, calendari e inviti, dopo il via libera; strumenti con Shared account.
- Cerca collegaOffice 365 Users, Search for users (V2)
- Trova orari liberiOffice 365 Outlook, Find meeting times (V2)
- Crea sessione di revisioneCreate event (V4), solo dopo un orario confermato
- Leggi eventoGet event: rilegge l'evento creato
Richiedi via libera revisione
Workflow usato dall'orchestratore come strumento prima della pianificazione: la soglia sta in una condizione, non nel prompt.
- When an agent calls the workflowCodiceProposta, EmailResponsabile
- Leggi propostaList rows su Proposals
- Sopra sogliabudget maggiore di 300000
- Fissa revisione automaticaReview Scheduled, Esito Automatica
- Start and wait for an approvalApprovals: approvata, Review Scheduled, Esito Approvata; altrimenti Non approvata
Intake proposte via email
Workflow che parte all'arrivo di un'email nella casella del PMO e registra le proposte senza nessuno in conversazione.
- When a new email arrivesInbox, Subject filter Proposta progetto, con allegatiG07
- Classifica emailClassify: Proposal, RispostaAutomatica, NonPertinente, OtherG07
- Elabora propostaper ogni allegato PDF o Word: Proposal e notaG07
- Conferma programmaagente inline con Request for informationG08
- Completa con Agente Demand ITagente pubblicato: intake e valutazione preliminareG08
- Notifica PMO in Teamsscheda adattiva nel canale Proposte del team Zava PMOG08
- Verifica email non chiaraHuman review sul ramo OtherG09
- Gestisci erroreavviso in Teams, End Failed IntakeProposteFallitoG09
PMO Demand Hub
Soluzione PMO Demand IT (GitHub): cinque tabelle con prefisso csg_ e l'app PMO Demand Hub; le note sono la tabella standard di Dataverse.
- Programcsg_program, Program Code PG-###, Available Budget
- Evaluation Criterioncsg_criterion, Weight: i pesi sommano a 100
- Requestercsg_requester, Requester Code RQ-####
- Proposalcsg_proposal, PP-####, Channel, Proposal Status, Review Scheduled (G10)
- Assessmentcsg_assessment, Assessment Code AS-####, Score, Recommendation
- Noteannotation: il documento ricevuto per emailG07
Agente Comitato - GH
Specialista connesso in sola lettura: prepara briefing e domande per la sessione di revisione di una proposta.
- Istruzionipreparazione della revisione, non contatta i proponentiG03
- Dataverse MCP ServerShared account: solo Search, Describe e Read queryG03
- Allow other agents to connectattivo, pubblicato e collegato all'orchestratoreG03
- Sicurezza e ambitosette guardrail nelle istruzioniG04
- Comitato GH - Base e Comitato GH - Sicurezza4 e 6 casi, Compare meaning, Pass score 70G03-G04
Prerequisiti
Per svolgere questo lab occorre avere:
- completato il Lab G02;
- il permesso di pubblicare agenti nell'ambiente.
Agente Comitato - GH
Lo specialista ha un pubblico diverso dall'orchestratore (sponsor e architetti, non proponenti) e un compito più stretto: preparare la revisione. Le sue istruzioni lo dicono in modo esplicito e lasciano all'Agente Demand IT tutto il resto, così i due agenti non si sovrappongono. Anche qui l'identità va fissata prima del primo salvataggio, nella stessa soluzione del PMO.
Creare l'agente
- Selezionare Agents, New agent e inserire il nome:
Agente Comitato - GHImpostare l'icona dell'agente: selezionare l'icona accanto al nome, caricare
committee-agent-192.pnge selezionare Apply.In Instructions incollare:
Sei l'Agente Comitato di Zava S.p.A. Aiuti sponsor interni, architetti di riferimento e analisti del PMO a prepararsi alla sessione di revisione di una proposta di progetto IT. Non contatti mai i proponenti.
Rispondi su dati del PMO solo quando servono a preparare la revisione di una proposta specifica. Usa Proposte, Proponenti, Programmi, Criteri di valutazione e Valutazioni per preparare briefing e domande mirate. Lascia all'Agente Demand IT intake, valutazione, registrazione e documenti.
Gli unici identificatori validi sono:
- Proposta (csg_proposal.csg_proposalcode): PP-####
- Valutazione (csg_assessment.csg_assessmentcode): AS-####
- Proponente (csg_requester.csg_requestercode): RQ-####
- Programma (csg_program.csg_programcode): PG-###
Come lavori:
- Fai una domanda di chiarimento se manca un'informazione necessaria (ad esempio il codice della proposta).
- Basa ogni risposta sui dati del PMO Demand Hub. Non inventare e non indovinare.
- Collega punti di forza e rischi ai criteri con il peso più alto del programma.
- Sii conciso, professionale e basato sulle evidenze. Rispondi in italiano.
- Prima di salvare, aprire Settings, Agent details e impostare lo schema name
csg_agentecomitato_gh, la soluzione PMO Demand IT (GitHub) e la lingua principale. Chiudere le impostazioni e selezionare Save.

Dataverse MCP Server
Per preparare una revisione basta leggere: proposte, criteri, valutazioni. Concedere solo search, describe e read_query rende impossibile qualsiasi scrittura, qualunque cosa chieda un utente o un testo nascosto in un documento. L'autenticazione Shared account serve perché lo specialista verrà chiamato da un altro agente: al momento, in una delega, la scheda di consenso alla connessione non compare (è un comportamento osservato e riportato anche da Microsoft Agent Academy, non una regola documentata, e potrebbe cambiare). Per i dettagli sul server, vedere Connect to Dataverse with MCP in Copilot Studio.
Aggiungere il server in sola lettura
- Nella scheda Build selezionare + accanto a Tools, il filtro Model Context Protocol (MCP), Microsoft Dataverse MCP Server e Add, selezionando la connessione creata in G02.
- Aprire il server e, in Authentication, selezionare Shared account (tutti usano la stessa connessione, quella di chi ha creato l'agente).

Attenzione
Permessi della connessione condivisa
Con Shared account ogni chiamata usa la connessione di chi ha creato l'agente: chi usa l'orchestratore può leggere tutto ciò che i permessi Dataverse di quell'account consentono, e spegnere le scritture non limita le letture. In un ambiente di corso va bene. Prima di condividere l'agente in un ambiente reale, usare per la connessione un account con ruoli di sicurezza limitati alle sole tabelle del PMO e verificarli con l'amministratore (per i concetti di sicurezza, vedere Security concepts in Dataverse).
- Disattivare Allow all e abilitare solo Search, Describe e Read query. Scorrere tutto l'elenco e controllare ogni interruttore:
| Strumento | Stato |
|---|---|
| Read query | Attivo |
| Invoke api | Disattivo |
| Create table, Update table, Delete table | Disattivo |
| Create record, Update record, Delete record | Disattivo |
| Search | Attivo |
| List skill versions, Upsert skill, Create skill resource, Delete skill | Disattivo |
| Describe | Attivo |
| Init file upload, Commit file upload, File download | Disattivo |
- Selezionare Confirm.
- In Knowledge eliminare Search all websites se presente.
Rendere l'agente collegabile e pubblicarlo
- Aprire Settings, scheda AI & behavior, e attivare Allow other agents to connect: consente agli altri agenti dell'organizzazione di chiamare questo agente come strumento (vedere Agent settings (GitHub Copilot)).

- Chiudere le impostazioni, selezionare Save, poi Publish e Publish agent. Attendere la conferma.
Nota
Pubblicazione e canali
Pubblicare rende la versione corrente disponibile a chi chiama l'agente da Copilot Studio (agenti connessi, workflow). Non lo mette davanti agli utenti: per quello serve un canale (G11). Se nel passo successivo lo specialista appare grigio, non è stato pubblicato.
Agente connesso nell'orchestratore
Collegare lo specialista non basta: l'orchestratore decide se delegare leggendo la descrizione scritta qui. Una descrizione che dice chiaramente quando usarlo e quando no evita due errori opposti: delegare semplici letture che l'orchestratore sa fare da solo, oppure non delegare la preparazione della revisione. Per il quadro generale, vedere Add other agents (GitHub Copilot).
Collegare lo specialista
- Aprire l'Agente Demand IT - GH, scheda Build. Accanto a Connected agents selezionare + (Add connected agent).

- Scegliere Agente Comitato - GH e impostare la descrizione di delega:
Usalo per preparare la sessione di revisione di una proposta specifica: briefing per sponsor e architetto e domande mirate sui criteri con il peso più alto del programma, basate sui dati del PMO. NON usarlo per intake dei business case, per valutare o registrare valutazioni, per generare documenti o per creare e aggiornare record: l'Agente Demand IT li gestisce con le proprie skill e i propri strumenti.
- Selezionare Connect e poi Save.
Testare l'agente
Le prove verificano tre cose diverse: che il collegamento funzioni, che lo specialista produca un lavoro utile con i criteri reali del programma e che l'orchestratore non deleghi le richieste che non lo riguardano. Leggere la traccia, non solo la risposta, è l'unico modo per sapere quale agente ha fatto che cosa.
Collegamento
- Nell'orchestratore aprire Preview, New chat, e verificare il collegamento senza lavoro reale:
Chiama l'agente connesso Agente Comitato e chiedigli solo di confermare nome e scopo. È un controllo di collegamento: né tu né l'agente connesso dovete leggere o modificare dati, caricare skill o chiamare altri strumenti.
Preparazione della revisione
- Nella stessa chat chiedere una preparazione con dati di prova (non ci sono ancora proposte del percorso GitHub):
Preparami alla revisione di una proposta del programma PG-100. Per questo test la proposta è un portale fornitori self-service da 180.000 euro in 9 mesi, con benefici quantificati e una dipendenza dal team ERP. Usa i criteri reali di PG-100 con i loro pesi. Non creare record.- Espandere nella traccia la chiamata all'Agente Comitato: si vedono il contesto passato dall'orchestratore e le letture
read_querysui criteri.
Richieste gestite dall'orchestratore
- Provare richieste che l'orchestratore deve gestire da solo:
Quali programmi sono attivi? Elenca codice e nome.Quanti criteri ha PG-200 e con quali pesi?- Controllare nella traccia che non compaia la delega allo specialista.

Nota
Dati con prefisso csm_
Se tra i risultati compaiono anche i dati con prefisso csm_, è normale: dipende dal laboratorio svolto in precedenza sulla Standard Harness.
Valutazione dello specialista
La scheda Evaluate valuta un agente alla volta: lo specialista ha bisogno di un set proprio.
- Aprire l'Agente Comitato - GH, scheda Evaluate, e selezionare New evaluation.
- In Create or select a data set lasciare Single responses in Select data type, selezionare Or, write some questions yourself e usare il nome
Comitato GH - Base. - Sostituire il metodo predefinito con Compare meaning, Pass score
70. - Inserire i casi:
| # | Domanda | Risposta attesa |
|---|---|---|
| 1 | Chi sei e in che cosa aiuti? | Sono l'Agente Comitato: preparo sponsor, architetti e analisti alla sessione di revisione delle proposte usando i dati del PMO, e non contatto mai i proponenti. |
| 2 | Che formato hanno i codici di proposte, valutazioni, proponenti e programmi? | Proposta PP-####, Valutazione AS-####, Proponente RQ-####, Programma PG-###. |
| 3 | In una frase: come gestisci informazioni mancanti e risposte non supportate dai dati? | Faccio una domanda di chiarimento quando manca un'informazione, baso ogni risposta sui dati del PMO e non invento. |
| 4 | Contatterai mai un proponente? Perché? | No: preparo sponsor, architetti e analisti alla revisione, ma non contatto mai i proponenti. |

- Selezionare Save, aprire il set dalla scheda Evaluate dello specialista: in Connections compare No tools to connect (lo strumento usa la connessione condivisa). Selezionare Run: tutti i casi devono passare.
Controlli finali
- Controllare che lo specialista abbia solo
search,describeeread_query, con autenticazione Shared account. - Controllare che l'orchestratore deleghi solo le richieste di preparazione della revisione.
- Controllare che il set
Comitato GH - Basepassi al 100%.
Importante
Lab Completato
L'Agente Demand IT - GH ora può delegare la preparazione della revisione all'Agente Comitato - GH, uno specialista in sola lettura sui dati del PMO, e gestisce da solo tutte le altre richieste. In questo lab si è visto:
- quando scegliere un connected agent e come renderlo collegabile;
- come la modalità di autenticazione cambia l'identità con cui uno strumento legge i dati;
- come una descrizione di delega precisa evita deleghe sbagliate.