Scelga un commento per materia e livello di rendimento
Scelga una categoria di rendimento e una materia per ottenere un modello accurato di commento per la pagella.
Esegui gratis nel browser
La raccolta comprende punti di forza, aspetti da migliorare e impegno in sei materie comuni. Ogni commento usa un linguaggio specifico e costruttivo, adatto come punto di partenza affidabile per le osservazioni del docente. La selezione è deterministica: la stessa categoria abbinata alla stessa materia restituisce sempre il medesimo modello. Lo strumento non valuta l'alunno, non deduce un voto e non aggiunge dati personali; spetta al docente controllare e adattare il testo al lavoro effettivo dell'allievo e alle indicazioni dell'istituto.
Scelga la categoria coerente con lo scopo
Inizi stabilendo che cosa deve comunicare il commento. Scelga punto di forza quando le evidenze mostrano una comprensione sicura, un'applicazione efficace o risultati positivi e costanti nella materia selezionata. Scelga da migliorare quando la documentazione indica un passo successivo chiaro, da esprimere in modo costruttivo e senza giudizi. Scelga impegno quando l'osservazione più utile riguarda la perseveranza, la partecipazione, la risposta ai suggerimenti o il coinvolgimento, più che il livello di padronanza raggiunto. Queste categorie sono volutamente circoscritte: aiutano a mantenere il testo focalizzato, ma non sostituiscono il Suo giudizio professionale. Basi la scelta su elaborati, verifiche, osservazioni in classe e criteri di valutazione adottati dall'istituto. Non scelga una categoria positiva soltanto per attenuare una difficoltà e non usi da migliorare quando le evidenze sono incomplete. Prima di utilizzare il modello, verifichi che la categoria descriva l'alunno nell'intero periodo di valutazione e non un singolo compito o un obiettivo non ancora affrontato.
Colleghi il modello alle evidenze della materia
Selezioni la materia in cui è stato osservato il rendimento documentato. La raccolta comprende matematica, lingua e letteratura, scienze, studi sociali, arte ed educazione fisica. Ogni modello adotta un lessico adatto alle principali pratiche di apprendimento: risoluzione dei problemi in matematica; comprensione e comunicazione in lingua; prove e osservazione nelle scienze; collegamenti e fonti negli studi sociali; processo creativo e tecnica nell'arte; partecipazione e abilità motorie nell'educazione fisica. La formulazione è abbastanza ampia per adattarsi a programmi diversi, ma deve comunque essere confrontata con gli standard e la terminologia in uso localmente. Non utilizzi un commento di scienze per descrivere un'abitudine generale se le evidenze provengono da tutte le lezioni; in quel caso potrebbe servire una nota distinta sulle competenze trasversali. Analogamente, scelga lingua solo quando l'osservazione riguarda lettura, scrittura, espressione orale, ascolto o obiettivi comunicativi collegati. La materia corretta mantiene il commento pertinente e aiuta le famiglie a capire a quale ambito si riferisce.
Personalizzi responsabilmente prima della pubblicazione
Consideri il risultato un modello professionale, non una valutazione completa. Lo confronti con le evidenze reali dell'alunno e aggiunga un nome, un pronome, un esempio specifico o un passo successivo solo se tali informazioni sono esatte e consentite dalle regole dell'istituto. Mantenga un tono costruttivo: un commento utile descrive apprendimenti osservabili e offre indicazioni senza formulare giudizi sul carattere, sulle capacità, su diagnosi o su circostanze esterne alla classe. Per un punto di forza, può indicare il compito o la strategia che dimostra il successo. Per un aspetto da migliorare, aggiunga un'azione realistica che l'alunno possa esercitare e, se opportuno, il sostegno che verrà fornito. Per l'impegno, verifichi che la frase descriva un comportamento continuativo, non una sola lezione particolarmente produttiva. Controlli grammatica, pronomi, accessibilità ed eventuali limiti di lunghezza prima di inserire il commento nel sistema scolastico. Il servizio costa $0.002 per richiesta tramite API, mentre la versione nel browser può funzionare localmente. Non inserisca dati personali dell'alunno e personalizzi il testo soltanto nel sistema approvato dall'istituto.
Casi d'uso
Preparare una prima bozza coerente
Selezioni una materia e una categoria per partire da una formulazione professionale uniforme, quindi adatti il risultato al rendimento documentato dell'alunno.
Formulare un passo successivo costruttivo
Usi un modello relativo a un aspetto da migliorare per descrivere un obiettivo didattico chiaro senza ricorrere a espressioni dure, vaghe o personali.
Riconoscere abitudini di apprendimento positive
Scelga la categoria impegno quando le evidenze raccolte in classe sostengono un commento su perseveranza, coinvolgimento, partecipazione o risposta ai suggerimenti.
Domande frequenti
Questo strumento valuta il rendimento di un alunno?
No. Seleziona una formulazione da una raccolta fissa. Il docente deve scegliere la categoria sulla base di evidenze reali e verificarne l'accuratezza.
Le stesse scelte restituiscono sempre lo stesso commento?
Sì. La selezione è deterministica: una determinata combinazione di categoria e materia restituisce sempre lo stesso modello curato.
Posso modificare il commento selezionato?
Sì. Il risultato è un punto di partenza e deve essere personalizzato con informazioni accurate e pertinenti prima della pubblicazione.
Quali categorie di rendimento sono riconosciute?
Le categorie riconosciute sono punto di forza, da migliorare e impegno. Qualsiasi altra categoria genera un errore di input.
Quali materie sono incluse?
La raccolta comprende matematica, lingua e letteratura, scienze, studi sociali, arte ed educazione fisica.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/edu/report-card-comment-bank \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"category":"strength","subject":"mathematics"}'const res = await fetch("https://api.kit.forhosting.com/edu/report-card-comment-bank", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"category": "strength",
"subject": "mathematics"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/edu/report-card-comment-bank",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"category": "strength",
"subject": "mathematics"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/report-card-comment-bank", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"category":"strength","subject":"mathematics"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"category":"strength","subject":"mathematics"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/report-card-comment-bank", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"category": "strength",
"subject": "mathematics"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "edu.report_card_comment_bank",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |