Come Parlare agli AgentiModulo 01 · 01

01 / CAPIRE E PARTIRE

Fatti capire. Ottieni un aiuto utile.

Iniziamo da una risposta poco utile che hai ricevuto in passato. Vedremo insieme come chiarire il compito, dialogare in modo costruttivo e verificare il risultato.

Come Parlare agli AgentiModulo 01 · 02

Ti hanno mai dato un consiglio troppo generico?

A volte ricevi risposte scritte bene, ma che andrebbero bene per chiunque. Pensando al tuo lavoro, quale informazione mancava per rendere il testo davvero usabile?

Come Parlare agli AgentiModulo 01 · 03

Tu conosci la situazione. Che cosa sa l’AI?

Budget, decisioni e dubbi spesso restano nella tua testa. Condividi quelli che servono al compito: il contesto aiuta l’assistente a rispondere e a fare domande pertinenti.

Il budget è apertoServe una decisioneCi sono impegni da chiarire

Tu conosci la situazione.

Che cosa gli hai dato?
LA RICHIESTA

«Preparami per la call.»

Con chi?
Per decidere cosa?
Da quali note?
Come Parlare agli AgentiModulo 01 · 04

Il prompt dà l’incarico. Il contesto lo rende concreto.

La richiesta dice cosa fare; il contesto offre le informazioni su cui lavorare. Chiarire lo scopo finale aiuta a concentrarsi sui fatti che servono davvero.

Come Parlare agli AgentiModulo 01 · 05

Le domande giuste aiutano anche te a decidere

Spesso chiediamo una soluzione senza aver scelto la direzione. Puoi invitare l'AI a farti domande specifiche: rispondere ti aiuterà a mettere a fuoco le tue priorità.

Tu

«Aiutami a preparare una proposta.»

AI

«Vuoi convincere il cliente o capire se il lavoro è fattibile?»

Tu

«Prima voglio capire che cosa manca per partire.»

Come Parlare agli AgentiModulo 01 · 06

L'AI suggerisce un percorso, tu valuti se funziona

Un ruolo orienta la prospettiva e il modo di rispondere. La tua esperienza serve a riconoscere se la proposta è adatta al caso e quali informazioni vanno verificate.

  1. Lo stile cambia la prospettiva

    «Agisci da consulente» modella il tono e il punto di vista. Non inietta vera competenza nel sistema.

  2. L'obiettivo rende utile il test

    «Cerca i punti deboli della mia proposta». Poi sarai tu a stabilire se le debolezze trovate sono reali.

Come Parlare agli AgentiModulo 01 · 07

Un testo utile evidenzia ciò che ancora manca

Una frase ben scritta non è per forza vera, e un dato inventato fa danni. A volte la risposta migliore è quella che ti fa notare un buco nelle informazioni.

  1. Tra i tuoi appunti

    «Dobbiamo ancora definire la cifra finale»: manca un importo concordato.

  2. Nella bozza generata

    «Verificare l'investimento prima di inviare»: una lacuna riconosciuta diventa un'azione chiara.

Come Parlare agli AgentiModulo 01 · 08

Costruiamo insieme un incarico verificabile

Per partire bene servono quattro elementi: l'obiettivo, i materiali da usare, i limiti da rispettare e il modo in cui verificherai il risultato.

Dalle note, prepara un briefing per la call.
Separa decisioni, impegni e domande, indicando le fonti.
Segnala i dati mancanti; per ora non creare file né inviare nulla.
Come Parlare agli AgentiModulo 01 · 09

Aggiungiamo un criterio e osserviamo cosa cambia

Hai 6 minuti: usa gli stessi file sintetici in due nuove conversazioni. Cambia un solo criterio nella richiesta e confronta un punto preciso dei risultati.

  1. Primo tentativo

    Chiedi un briefing dalle note sintetiche del kit.

  2. Secondo tentativo

    Ripeti la richiesta e chiedi la fonte di ogni fatto importante.

  3. Il confronto pratico

    Quale testo riesci a verificare più in fretta? Cerca un dettaglio, non guardare solo la lunghezza.

Come Parlare agli AgentiModulo 01 · 10

Non hai la richiesta pronta? Fatti intervistare

Parti da chi sei, dalle attività e dai programmi che usi. Lascia che l’AI faccia una domanda alla volta, poi correggi il profilo che ti restituisce.

Come Parlare agli AgentiModulo 01 · 11

Partire da un episodio chiarisce subito il contesto

Raccontare un caso passato è più efficace di descrivere la teoria. Fa emergere subito i veri ostacoli e i documenti che usi regolarmente.

Prima di proporre una soluzione, intervistami.
Chiedimi una cosa alla volta, partendo dall’ultimo caso.
Chiarisci il risultato, i materiali e come valuto il lavoro.
Come Parlare agli AgentiModulo 01 · 12

Vuoi riscrivere un'istruzione? Fatti aiutare

Puoi far rivedere la tua richiesta iniziale prima di eseguirla. L'AI segnala le ambiguità, ma sei tu a controllare che non stravolga le tue intenzioni.

Come Parlare agli AgentiModulo 01 · 13

Rendi la richiesta più chiara. Lascia intatti i fatti.

Se non hai fissato una scadenza, il nuovo testo non deve inventarla. Una scrittura più chiara non deve mai prendere decisioni al posto tuo.

Non eseguire il compito: migliora le mie istruzioni.
Conserva i fatti e rendi visibili le informazioni mancanti.
Restituisci un prompt da provare e spiega cosa hai cambiato.
Come Parlare agli AgentiModulo 01 · 14

Come lavora un agente.

Riceve un incarico, usa i materiali e gli strumenti disponibili, poi produce un risultato. Tu stabilisci i confini e controlli ciò che ha fatto.

Il tuo incarico

Prepara il briefing dai file Faro.

L’AGENTE

Organizza il lavoro

ModelloElabora la richiesta
IstruzioniGuidano il compito
ContestoFornisce i materiali
StrumentiPermettono le azioni

Legge → prepara → controlla

Una bozza

Un file da aprire e verificare.

Tu valuti il risultato. Se serve, correggi l’incarico e riprovi.

Come Parlare agli AgentiModulo 01 · 15

Il modello è il motore. Serve anche il resto.

La bontà del lavoro dipende dal motore, ma anche dai materiali che rendi disponibili, dagli strumenti abilitati e dalla chiarezza del tuo metodo.

01

Modello

Interpreta il compito

+
02

Contesto

File e informazioni utili

+
03

Metodo

I tuoi criteri di lavoro

↓   Un risultato da verificare

OpenAI · documentazione ufficiale
Come Parlare agli AgentiModulo 01 · 16

Per funzionare bene, servono regole, risorse e strumenti

Questi elementi orientano il lavoro sul progetto. Non dobbiamo configurarli tutti oggi, ma è utile sapere a cosa servono per il futuro.

  1. Gli strumenti

    Funzioni specifiche per leggere, scrivere o cercare dati.

  2. Le istruzioni

    Le direttive di base che indicano come comportarsi nel progetto.

  3. Le skill

    I passaggi codificati per ripetere bene un incarico frequente.

  4. La memoria

    Informazioni utili richiamate al bisogno, non un archivio onnisciente.

OpenAI · documentazione ufficiale
Come Parlare agli AgentiModulo 01 · 17

Collega gli strumenti. Poi insegna il metodo.

Un collegamento permette di usare un servizio. Una skill descrive come svolgere un compito. Prima verifica disponibilità e accessi, poi costruisci la procedura.

  1. Il collegamento

    Controlla prima i plugin disponibili. Se manca quello adatto, verifica un MCP e chiedi una guida; altrimenti valuta API o un passaggio manuale.

  2. Il metodo

    La skill specifica input, passaggi, controlli e risultato. Può usare solo gli strumenti davvero disponibili.

OpenAI · documentazione ufficiale
Come Parlare agli AgentiModulo 01 · 18

Partiamo dai file locali, senza collegare gli account

In aula useremo solo i file sintetici del kit. Potrai provare lettura, scrittura e verifica senza collegare posta, calendario o account dei clienti.

Come Parlare agli AgentiModulo 01 · 19

Prepariamo l'ambiente usando la guida ufficiale

Segui il primo avvio guidato: verifica il tuo ambiente, accedi dal percorso ufficiale e apri il progetto. Non condividere credenziali durante la dimostrazione.

  1. Trova la documentazione

    Segui il link approvato per raggiungere lo strumento in sicurezza.

  2. Esegui l'accesso

    Inserisci le tue credenziali senza mostrarle sul proiettore dell'aula.

  3. Seleziona l'ambiente

    Scegli l'interfaccia Codex, come mostrato nei passaggi della guida.

OpenAI · documentazione ufficiale
Come Parlare agli AgentiModulo 01 · 20

Usiamo una cartella dedicata solo alle prove

Lavoreremo su una copia dei materiali del laboratorio. Non selezionare i tuoi archivi di lavoro quotidiano o le cartelle con dati sensibili.

  1. La cartella corretta

    Scegli la copia del laboratorio. In questo modo avrai già i documenti pronti.

  2. Le cartelle da evitare

    Non usare la scrivania, i documenti generali o le cartelle condivise aziendali.

Come Parlare agli AgentiModulo 01 · 21

Istruzioni e permessi non sono lo stesso confine.

La cartella organizza il lavoro; i permessi ne limitano le azioni. Controlla dove Codex può scrivere e quando deve chiedere approvazione: AGENTS.md non è una sandbox.

CARTELLA DEL PROGETTO
Codex
Legge i materiali Scrive le bozze consentite
Un altro confineControlla accesso e approvazione

Posta e altri servizi

Un incarico sui file non autorizza un invio.

OpenAI · documentazione ufficiale
Come Parlare agli AgentiModulo 01 · 22

Prima richiesta: «Quali file vedi?»

Prima di chiedere un lavoro, controlla se il sistema riconosce effettivamente la cartella, i file e le istruzioni che hai preparato.

Esamina soltanto la cartella del laboratorio, senza modifiche.
Indica i file disponibili e le istruzioni che hai letto.
Spiega cosa puoi fare e cosa non riesci a verificare.
Come Parlare agli AgentiModulo 01 · 23

Prima di partire, facciamo un controllo incrociato

Lavorando in coppia, verificate questi quattro passaggi fondamentali prima di lanciare la prima vera esecuzione pratica.

  1. Account corretto

    Sai con quale account stai lavorando e hai completato l’accesso.

  2. Cartella giusta

    Il progetto attivo è la copia del laboratorio, non un altro archivio.

  3. Permessi compresi

    Hai controllato dove può scrivere e quando deve chiedere approvazione.

  4. Risultato chiaro

    Sai che cosa vuoi ottenere e come lo controllerai.

OpenAI · documentazione ufficiale
Come Parlare agli AgentiModulo 01 · 24

Usiamo queste basi per creare il primo documento

Nel prossimo modulo prepareremo un briefing sui dati sintetici Faro. Lo salveremo in un file da aprire, rileggere e correggere.

Indice del modulo

Frecce: naviga · N: note · I: indice · Home / End: inizio / fine.

Prompt completo