Corsi e domande

Questa guida spiega come preparare un corso: crearlo, caricare i materiali per l'AI, invitare gli studenti, scrivere e importare le domande, clonare il corso per l'anno successivo.

L'interfaccia è in inglese: le etichette sono riportate come le vedi, con la traduzione tra parentesi.

Chi è un docente

Un account diventa docente quando un amministratore lo abilita. Non puoi diventare docente da solo, e un account già usato come studente non può diventare docente.

Come docente vedi tutti i corsi creati da te e dai colleghi del tuo stesso gruppo di lavoro. Quando entri in PeerCards (indirizzo /peercards/) arrivi direttamente alla Teacher Dashboard (pannello del docente).

La Teacher Dashboard

La dashboard raggruppa i corsi per anno. Ogni anno è un riquadro che si apre e si chiude con un clic; quello più recente è aperto.

Per ogni corso trovi:

• l'icona di modifica accanto al nome: apre la scheda del corso nell'area di amministrazione;
• l'elenco delle attività (assignment), ognuna con il badge Open, la data Due: (scadenza) e il menu Actions (azioni):
• Invite (invita): pagina con QR code e codice da proiettare in aula;
• Participants (partecipanti): iscritti e gruppi;
• Monitor (monitoraggio): chi ha risposto a cosa;
• Evaluate (valuta): valutazione delle risposte;
• Grade (voti): voti per studente;
• Edit (modifica): impostazioni dell'attività;
• i pulsanti del corso:
• Add Assignment (aggiungi attività);
• Add Question (aggiungi domanda);
• Questions (domande) e Quizzes (gruppi di domande);
• Glossary (glossario) oppure Create Glossary (crea glossario) se il corso non ne ha uno;
• Evaluation Summary (riepilogo delle valutazioni del corso).

In fondo alla pagina, Create New Course (crea un corso) apre il modulo di creazione.

Attività ed esecuzione in aula: vedi Attività e Condurre un'attività in aula.

Creare un corso

1. Nella dashboard clicca Create New Course.
2. Compila i campi: - Title (titolo): nome completo del corso. Lo vedono gli studenti e l'AI lo usa come contesto. - Name (nome): sigla breve, per uso interno. - Year (anno): l'anno di inizio dell'anno accademico. Per il 2026/2027 scrivi 2026. Il campo propone l'anno accademico in corso. - Description (descrizione): breve descrizione, visibile agli studenti e all'AI. - Degree program (corso di laurea): dà contesto agli studenti e all'AI. - Language (lingua): la lingua in cui scrive il peer AI. Il valore predefinito è Italiano.
3. Se vuoi, aggiungi i materiali in Course files (file del corso): vedi sotto.
4. Salva.

Non possono esistere due corsi con lo stesso Name e lo stesso Year nello stesso ateneo.

Per modificare un corso clicca l'icona di modifica accanto al suo nome nella dashboard.

Materiali per l'AI (vector store)

Il peer AI di un'attività può rispondere usando i materiali del corso (slide, dispense, articoli). PeerCards li carica su OpenAI in un archivio di ricerca chiamato vector store.

1. Apri la scheda del corso.
2. In Course files aggiungi un file per riga, con una Description (descrizione) facoltativa. Salva.
3. Clicca Sync Vector Store (sincronizza il vector store) in alto a destra.

Al primo clic PeerCards crea il vector store del corso. A ogni clic carica solo i file non ancora caricati: la colonna Uploaded to vector store (caricato nel vector store) mostra quali lo sono già. Se non c'è nulla da caricare, vedi il messaggio No new files to upload.

Quando elimini un file o un corso, PeerCards lo cancella anche dal vector store, a meno che un altro corso (per esempio una copia clonata) lo stia ancora usando.

Per far usare questi materiali all'AI attiva Use rag nell'attività: vedi Attività.

Invitare gli studenti al corso

Puoi iscrivere gli studenti al corso in due modi:

• Con il link del corso. Nella scheda del corso clicca Invite Students (invita studenti): il link viene copiato negli appunti. Incollalo in una email o in un messaggio. Chi lo apre, dopo l'accesso, viene iscritto al corso.
• Con un'attività. Quando uno studente si iscrive a un'attività (QR code, link o codice), viene iscritto anche al corso.

Gli studenti iscritti al corso compaiono nella pagina Participants di ogni attività, nella sezione In the course, not subscribed (nel corso, non iscritti all'attività) finché non si iscrivono all'attività.

Domande

Struttura

• Una domanda appartiene a un corso.
• Un quiz è un insieme ordinato di domande. È facoltativo: serve per ordinare le domande e per dare all'AI il contesto delle domande che le precedono.
• I tag sono etichette libere per filtrare le domande nell'elenco.

Creare una domanda

1. Nella dashboard clicca Add Question. Il corso è già selezionato.
2. Compila i campi principali: - Name (nome): nome breve interno, non visibile agli studenti. Lo vedi nel Monitor e in Evaluate. - Title (titolo): titolo breve mostrato agli studenti. - Quiz e Order (ordine): il quiz di appartenenza e la posizione nel quiz. Le domande senza ordine compaiono in ordine casuale, uguale per tutto il gruppo. - Tags e Note (note interne, non visibili agli studenti). - Question (domanda): il testo della domanda. - Reference answer (risposta di riferimento): una risposta corretta. La usa la valutazione AI. - Grading rubric (griglia di valutazione): criteri per valutare le risposte. La usa la valutazione AI. - Is closed (domanda chiusa): spuntalo per una domanda a scelta multipla, poi aggiungi le scelte in fondo alla pagina, segnando quelle corrette e un eventuale Feedback. - Open section question (parte aperta): per una domanda chiusa, il testo mostrato sotto le scelte, sopra il campo della risposta scritta.
3. Salva.

Per una domanda chiusa lo studente spunta una o più scelte e scrive comunque una risposta. Nel Monitor la risposta conta come corretta solo se le scelte selezionate coincidono esattamente con quelle corrette.

In fondo alla scheda puoi aggiungere anche delle espressioni regolari di correzione: un pattern, un colore e una nota. Le parti delle risposte che corrispondono al pattern vengono evidenziate con quel colore nella pagina Evaluate.

Nella pagina Quizzes, aprendo un quiz, modifichi tutte le sue domande in una sola pagina. Lì trovi anche due campi della domanda:

• Expected answer length (lunghezza attesa): numero di parole indicativo per studenti e AI (predefinito 150). Non è un limite.
• Evaluation weight (peso nella valutazione): quanto pesa la domanda nel voto (predefinito 1). Vedi Valutazione e voti.

Vedere la domanda come uno studente

Nell'elenco Questions clicca Preview (anteprima) sulla riga della domanda. Vedi la pagina di risposta come la vede lo studente. Con Preview AI Answer (anteprima della risposta AI) puoi generare una risposta di prova del peer AI.

Importare molte domande da Excel

Per caricare molte domande insieme usa un file .xlsx e la sezione Question batch uploads (caricamenti di domande) dell'area di amministrazione.

1. Prepara il file: - la riga di intestazione, con i nomi delle colonne, è la riga iniziale che non comincia con #; le righe che iniziano con # sono ignorate (usale per i commenti); - colonne obbligatorie: name, question; - colonne facoltative: quiz, order, title, tags (separati da virgola), reference_answer, note, is_closed, open_question, e per le domande chiuse fino a cinque scelte: choice_1, choice_1_correct, choice_1_feedback, … choice_5, choice_5_correct, choice_5_feedback; - per is_closed e choice_N_correct scrivi true, yes, 1, si o sì; - ogni altra colonna blocca il caricamento.
2. Nell'area di amministrazione apri Question batch uploads e clicca Add question batch upload (aggiungi un caricamento).
3. Scrivi un Name (nome del caricamento, unico nel corso), scegli il Course e carica il File.
4. Salva.

Cosa succede:

• se il quiz indicato non esiste, viene creato;
• se esiste già una domanda con lo stesso name nello stesso quiz, viene aggiornata invece di essere duplicata; le scelte del file vengono aggiunte a quelle già presenti, quindi controllale;
• ogni domanda riceve anche il tag batchUpload: <nome del caricamento>, utile per ritrovarla;
• se il file contiene un errore, nessuna domanda viene salvata: leggi il messaggio, correggi il file, caricalo ancora e salva;
• un caricamento riuscito diventa di sola lettura e non si può eliminare.

Importare le domande da un altro corso

1. Apri la scheda del corso che deve ricevere le domande.
2. Clicca Import questions from another course (importa domande da un altro corso).
3. Scegli il Source course (corso di origine) e clicca Import questions.

PeerCards copia domande, scelte, espressioni regolari di correzione, risposte di riferimento, quiz e tag. Le domande già importate da quel corso vengono saltate: puoi ripetere l'importazione senza creare doppioni.

Clonare un corso per l'anno successivo

Usa Clone course (clona il corso) quando riproponi lo stesso corso in un altro anno accademico.

1. Apri la scheda del corso da copiare.
2. Clicca Clone course.
3. Controlla Name, Title e Year. L'anno proposto è quello successivo.
4. Clicca Clone course.

La copia contiene:

• le stesse impostazioni del corso (descrizione, corso di laurea, lingua);
• gli stessi docenti;
• tutti i quiz, i tag e le domande;
• gli stessi file del corso e lo stesso vector store, condivisi: nulla viene caricato due volte.

La copia non contiene studenti, attività e glossari: invita gli studenti al corso clonato e crea le sue attività.

PeerCards rifiuta la copia se esiste già un corso con lo stesso nome e lo stesso anno: cambia uno dei due.

Attenzione: il vector store è condiviso. Un file che carichi e sincronizzi con Sync Vector Store in uno dei due corsi finisce anche nei materiali usati dall'AI dell'altro corso. Se un materiale deve valere solo per un anno, tienine conto.

Dopo la copia sei tu il proprietario del corso clonato.

Glossario

Ogni corso può avere un glossario in cui gli studenti inseriscono termini e definizioni. Dalla dashboard:

• Create Glossary crea il glossario del corso;
• Glossary apre Glossary Terms Overview (panoramica dei termini), da cui puoi cercare sinonimi e duplicati e aprire Glossary Students Overview (panoramica per studente), esportabile con Export to Excel.