Prompt di sistema per agenti API
In questa pagina
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.