Skip to main content

Skills

Una skill è una cartella che dice all’AI cosa sa e cosa può fare con la tua app. Contiene:
  • SKILL.md — istruzioni che l’AI legge (obbligatorio).
  • tools.ts — un elenco di strumenti che l’AI può chiamare (facoltativo).
SKILL.md descrive l’app e i suoi strumenti; tools.ts dichiara gli strumenti; ogni strumento è implementato da una rotta HTTP in uno dei componenti della tua app.

Definire le skill

Punta kazzle.config.ts al SKILL.md di ogni skill. Kazzle utilizza la sua cartella, quindi tools.ts accanto ad essa viene rilevato automaticamente.

SKILL.md

Markdown con frontmatter, seguito dalle istruzioni che l’AI deve seguire.

tools.ts

tools.ts accanto a SKILL.md dichiara gli strumenti che quella skill può chiamare. Il contratto completo dello strumento — tipi di dichiarazione, la forma della richiesta/risposta del gestore e i canali di risultato content vs markdown — si trova in Tools.

Come l’AI utilizza le skill

L’AI legge SKILL.md su richiesta (non tutte le skill in anticipo) per fondare le sue risposte e può chiamare gli strumenti dichiarati in tools.ts. Uno strumento senza una rotta corrispondente non fa nulla; aggiungili entrambi. tools.json non è supportato.