Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Prompt di sistema per agenti API

Lezione 14 di 14 Aggiornata il 29 luglio 2026 Sviluppatore
In questa pagina
  1. Costruire agenti con grok-build-0.1
  2. Anatomia di un buon prompt di sistema
  3. Strutturazione con Markdown o XML
  4. Ottimizzazione della cache
  5. Esempio completo: Agente di generazione test
  6. Punti chiave
  7. Metti alla prova le tue conoscenze

Costruire agenti con grok-build-0.1

Se stai sviluppando i tuoi strumenti di sviluppo—un agente di revisione del codice, un assistente al deployment, uno strumento di generazione della documentazione—interagirai direttamente con l’API xAI. Il prompt di sistema è la tua leva principale per controllare il comportamento del modello.

Anatomia di un buon prompt di sistema

Un prompt di sistema efficace per un agente basato su grok-build-0.1 contiene quattro sezioni:

1. Descrizione del compito

Inizia definendo chiaramente cosa fa l’agente:

## Ruolo
Sei un assistente di revisione del codice specializzato in TypeScript.
Analizzi le differenze nel codice (diff) per identificare potenziali bug,
problemi di prestazioni e violazioni delle convenzioni.

2. Aspettative e formato di output

Descrivi cosa ti aspetti dal modello:

## Formato di output
Per ogni problema identificato, fornisci:
- Il file e la riga coinvolti
- La gravità (critico, avviso, info)
- Una descrizione del problema
- Un suggerimento di correzione con un esempio di codice

3. Casi limite

Anticipa le situazioni ambigue:

## Casi limite
- Se il diff è vuoto, rispondi "Nessuna modifica da analizzare"
- Se il codice è in un linguaggio non supportato, indicarlo
- Non commentare le modifiche di formattazione (spazi, indentazione)
- Ignora i file di configurazione generati (.lock, dist/)

4. Vincoli

Definisci i limiti:

## Vincoli
- Massimo 10 commenti per revisione
- Dai priorità ai bug critici rispetto ai suggerimenti di stile
- Non suggerire refactoring importanti per correzioni minori

Strutturazione con Markdown o XML

Il modello è abituato a vedere un contesto sostanziale e strutturato nel primo prompt. Due formati funzionano bene:

Markdown (consigliato per la leggibilità)

## Ruolo
Descrizione del ruolo...

## Strumenti disponibili
- read_file: legge un file del progetto
- write_file: modifica un file
- run_command: esegue un comando di terminale

## Regole
1. Leggi sempre il file prima di modificarlo
2. Chiedi conferma prima di eliminare codice
3. Esegui i test dopo ogni modifica

XML (consigliato per la precisione)

<agent>
  <role>Assistente di revisione del codice TypeScript</role>
  <tools>
    <tool name="read_file">Legge un file del progetto</tool>
    <tool name="write_file">Modifica un file</tool>
  </tools>
  <rules>
    <rule>Leggi sempre il file prima di modificarlo</rule>
    <rule>Chiedi conferma prima di eliminare codice</rule>
  </rules>
</agent>

Entrambi i formati sono efficaci. Il Markdown è più facile da mantenere; l’XML è più strutturato per l’analisi automatica.

Ottimizzazione della cache

Ricorda la lezione sulla caching: il prompt di sistema deve essere stabile. Scrivilo una volta, completamente, e non modificarlo durante la sessione. Se hai bisogno di cambiare il comportamento dell’agente, aggiungi istruzioni nel messaggio dell’utente piuttosto che modificare il prompt di sistema.

Esempio completo: Agente di generazione test

## Ruolo
Sei un agente che genera test unitari per codice TypeScript.
Usi Vitest come framework di testing.

## Processo
1. Leggi il file sorgente con read_file
2. Identifica le funzioni esportate
3. Per ogni funzione, genera test che coprano:
   - Il caso nominale
   - Casi limite (null, undefined, array vuoto)
   - Casi di errore
4. Scrivi i test con write_file nella cartella __tests__/
5. Esegui i test con run_command("npx vitest run")

## Convenzioni
- Nomenclatura: {file}.test.ts
- Struttura: describe > it > expect
- Usa fixture per dati complessi
- Mocka le dipendenze esterne (API, DB)

## Vincoli
- Non modificare il codice sorgente
- Se un test fallisce, correggi il test, non il codice sorgente
- Massimo 20 test per file

Questo prompt di sistema fornisce all’agente tutte le informazioni necessarie per operare in autonomia, rimanendo entro i limiti definiti.

Punti chiave

  • Il prompt di sistema struttura il comportamento dell’agente in 4 parti: ruolo, aspettative, casi limite, vincoli
  • Usa Markdown o XML per strutturare le sezioni
  • Il prompt di sistema deve essere stabile per ottimizzare la cache
  • Includi processi passo-passo per gli agenti sequenziali
  • Definisci sempre i casi limite per evitare comportamenti imprevisti

Metti alla prova le tue conoscenze

grok-build nei tuoi editor: prendere il controllo finale.

1. Cos'è grok-build-0.1?

Risposta: Il modello di codice agentico di xAI: chiamata nativa degli strumenti, ragionamento in streaming, contesto adattato per compiti di sviluppo—il motore dietro Grok Build e le integrazioni negli editor.

2. Come lo usi nel tuo editor?

Risposta: Tramite integrazioni: Cline in VS Code, Cursor, GitHub Copilot, Windsurf e altri—l’API xAI compatibile con OpenAI rende possibile l’integrazione diretta.

3. Quali abitudini garantiscono buoni compiti di codice?

Risposta: Specifica il contesto (file, vincoli), definisci obiettivi chiari e verificabili, itera progressivamente—e ottimizza la cache mantenendo stabili i prefissi.

4. grok-build-0.1 o grok-4.5 per il codice?

Risposta: grok-build per compiti agentici di sviluppo quotidiani (veloce, specializzato); grok-4.5 quando il compito richiede il massimo ragionamento—la scelta segue la difficoltà.

5. Cosa va nel prompt di sistema di un agente di codice API?

Risposta: Il ruolo, le convenzioni del progetto, le regole di modifica (test, stile) e i limiti—la cornice che trasforma un modello di codice in un compagno di squadra per il tuo codebase.

Modello specializzato, editor connesso, compiti puliti, prompt inquadrati: lo sviluppo assistito da Grok si riduce a quattro scelte—tutte fatte intenzionalmente.