Modello per brief di contesto di un agente AI

Usa questo brief quando un agente AI deve lavorare su un progetto reale e non può partire da una chat piena di correzioni, tentativi e contesto implicito.

Il documento chiarisce obiettivo, fonti ammesse, limiti e formato atteso prima che ChatGPT, Claude, Cursor o un connettore MCP inizino a produrre output.

In breve

Quando un agente deve lavorare su ticket Jira, repository privati, documenti interni o pagine Confluence, non lasciargli ricostruire il contesto da una conversazione lunga. Il brief deve dire fonti, limiti, permessi e formato atteso.

Un agente AI lavora meglio quando riceve un brief corto ma completo: compito, criteri di successo, fonti da usare, limiti, permessi e formato di output. Non basta incollare una conversazione lunga.

Scarica grafica

Modello copiabile

# Brief contesto agente AI

## Compito
Che cosa deve fare l'agente e per chi.

## Criteri di successo
Come capiremo se l'output è utilizzabile.

## Fonti consentite
Documenti, issue, note o repository che può usare.

## Limiti
Cosa non deve fare, creare o modificare.

## Permessi
Lettura, proposta, modifica o invio.

## Output richiesto
Memo, ticket, tabella, bozza email o lista azioni.

Come usarlo senza creare altra burocrazia

Compila prima compito, fonti consentite e limiti. Poi scegli l'output richiesto: memo, ticket, tabella o bozza email. Se una fonte non è approvata, scrivilo esplicitamente.

Checklist prima di inviarlo

• Scrivi il compito in una frase operativa.
• Indica fonti attendibili e fonti da ignorare.
• Se ci sono credenziali, chiave API o token, non inserirli nel brief.
• Conserva il brief in Notion, Google Docs o Confluence prima di riusarlo.

Esempio compilato

# Brief agente AI per revisione draft

## Obiettivo
Preparare una nota di contesto per un agente che deve analizzare ticket di supporto e proporre priorità di prodotto.

## Fonti di verità
- Report mensile del supporto.
- Tre ticket già anonimizzati.
- Roadmap prodotto approvata.

## Vincoli
- Non citare nomi cliente.
- Non promettere correzioni già confermate.
- Non modificare la roadmap senza revisione umana.

## Output atteso
Tabella con problema ricorrente, impatto, fonte e prossima azione consigliata.

## Regola di stop
Fermati se il ticket contiene dati personali o informazioni contrattuali.

La parte più importante è spesso la sezione "vincoli". Senza quella, un agente può fare lavoro apparentemente utile ma fuori ambito: scrivere a clienti, cambiare priorità, modificare documenti o inventare fonti.

Dove entra Highlight Reel

Con Highlight Reel puoi prendere la conversazione preparatoria, isolare i messaggi che definiscono il brief e consegnare una pagina leggibile al collega che deve approvare l'agente.

Domande frequenti

Devo copiare tutto il modello ogni volta?

No. Per un controllo veloce bastano compito, fonti, limiti e output. La versione completa serve quando più persone devono riusare lo stesso agente.

Posso includere la conversazione originale?

Sì, ma mettila dopo il brief. Chi approva deve leggere prima vincoli e fonti; la chat grezza resta prova di contesto, non istruzione principale.

Che cosa devo togliere prima di condividere?

Togli credenziali, token, chiavi API, prompt interni non necessari, nomi cliente non rilevanti e qualsiasi istruzione che l'agente non deve ripetere.