Chat HR

Ultimo aggiornamento: 2026-05-12 Owner: Product Writer Audience: hr_admin, manager, admin tenant

Scopo

Spiegare come usare Chat HR come Talent Partner per ricercare skill, profili, competenze, costruire shortlist e gestire una memoria recruiter persistente, sempre dentro il proprio perimetro autorizzato.

Prerequisiti

• ruolo abilitato e capability Chat HR attiva sul tenant
• servizio AI attivo per il tenant e policy piattaforma configurata
• pannello AI di tenant configurato dal proprio admin tenant

Concetti chiave

• Talent Partner: nome ufficiale dell'assistente. La pill in alto al thread mostra modello e capacita correnti, per esempio Sonnet 4.6 · memoria · 8 tool.
• Memoria recruiter: archivio strutturato persistente del recruiter (ricerche salvate, candidati favoriti, gare attive). La memoria viene letta automaticamente all'inizio di ogni nuovo turno.
• Memoria conversazione: ogni sessione produce un riassunto sintetico (criteri bloccati, candidati mostrati, domande aperte) che resta legato alla sessione e viene riusato se la riapri dallo storico.
• Tool agentic: il Talent Partner sceglie autonomamente fino a otto strumenti (ricerca semantica, dossier candidato, chiarimenti, confronto, raccomandazione, validazione, filtro, espansione skill correlate) per arrivare alla risposta. Vedi sotto Visibilita degli strumenti.

Cosa trovi nella shell di Chat HR

• abstract recruiter, KPI di intelligence, preview CV inline, export markdown/json
• CTA dirette: Apri scheda candidato, Apri CV, passaggio a shortlist operativa

Passi operativi base

1. Apri il modulo Chat HR. La shell parte dal thread; non devi piu scegliere Assistente, Ricerca o Report: il Talent Partner decide autonomamente.
2. Se hai gia conversazioni recenti vedrai la lista nell'empty state. Clicca su una riga per riprendere il thread, oppure scrivi una nuova richiesta nel composer.
3. Inserisci una richiesta chiara, per esempio profili, skill richieste, contesto gara o confronto.
4. Mentre il Talent Partner lavora, leggi gli status di esecuzione sotto la pill: ti dicono quale strumento sta usando.
5. La risposta arriva in streaming nello stesso messaggio. Sotto trovi eventuali profili proposti come card e azioni operative finali.
6. Se la richiesta e molto semplice, per esempio Java, aspettati una risposta naturale grounded e, solo se esistono profili davvero vicini, i candidati piu rilevanti nello stesso messaggio.
7. Se non esistono match, la chat lo dichiara in modo esplicito e propone ricerche vicine o un taglio recruiter piu ampio.
8. Se un profilo ti interessa, usa direttamente dalla card Apri scheda candidato, Apri CV o passa la shortlist operativa.

Azioni rapide sul thread

• Copia risposta: hover su un messaggio del Talent Partner per rivelare il pulsante copia.
• Rigenera ultima risposta: hover sull'ultimo messaggio assistant, pulsante Rigenera. Il sistema riavvia lo stesso turno con la stessa richiesta utente.
• Modifica messaggio utente: hover su un tuo messaggio precedente, pulsante Modifica. Si apre una textarea inline con Salva e rigenera o Annulla. La conversazione viene biforcata da quel punto.
• Nuova chat: dal pulsante in header. Il thread corrente, se ha messaggi, viene salvato automaticamente nello storico.

Memoria recruiter

Il pannello Memoria recruiter espone tre sezioni accordion persistenti tra sessioni:

1. Ricerche salvate — query rilevanti che vuoi rieseguire o riprendere. Da empty state o report-header puoi usare l'azione Salva ricerca corrente: la sessione attiva viene salvata come ricerca riusabile.
2. Candidati favoriti — profili che hai marcato come riferimento ricorrente.
3. Gare attive — contesti gara persistenti, riusati dal Talent Partner per filtrare automaticamente.

Per ogni sezione: paginazione 50 + Carica altre 50, eliminazione click-to-confirm (un primo click pre-conferma, il secondo cancella). Le voci salvate vengono lette automaticamente all'inizio di ogni nuovo turno e arricchiscono il prompt del Talent Partner.

Storico conversazioni

Il toggle Storico conversazioni mostra:

• barra di ricerca con debounce
• lista sessioni del tuo utente nel tenant corrente, ordinate per ultimo aggiornamento
• per ogni riga: titolo sintetico, timestamp relativo, conteggio messaggi, badge Memoria attiva se la sessione ha gia un riassunto
• pagination Carica altre 50

Cliccando su una sessione la riapri: il thread viene caricato per intero, lo stato transient (match correnti, report, chiarimenti) viene resettato per partire pulito sopra la cronologia originaria.

Allegare un CV

Dal pulsante graffetta nel composer puoi caricare un curriculum come contesto del turno corrente.

• formati supportati: .pdf, .docx, .txt,
• dimensione massima file: 5 MB
• il testo estratto e' cappato a 200 KB nel prompt (i CV piu lunghi vengono troncati)
• .txt e sono letti in locale; .pdf e .docx vengono parsati server-side via l'endpoint /api/hr-chat/cv-parse (no LLM, solo estrazione testo)
• il messaggio finale ha il formato [CV allegato: nome_file]\n\n{testo_estratto}\n\n{tua_richiesta}
• il Talent Partner usa il CV come contesto solo per quel turno: non viene salvato come asset persistente del tenant
• non supportati: PDF scansionati senza testo selezionabile (OCR), DOC binari (.doc legacy), DOCM con macro

Visibilita degli strumenti (tool call)

Mentre il Talent Partner ragiona vedi in tempo reale lo strumento che sta usando, con etichetta localizzata. Gli otto tool del catalogo:

• search — ricerca semantica vector + lessicale sui profili
• dossier — apertura dossier candidato dettagliato
• clarify — richiesta di chiarimento mirato all'utente
• compare — confronto strutturato tra candidati
• recommend — raccomandazione operativa di shortlist
• validate — validazione di un'assunzione o di un criterio
• filter — filtro su pool corrente
• expand — espansione 1-hop di skill di nicchia o certificazioni nelle skill adiacenti del catalogo (es. CKA → Kubernetes, Kubernetes → Docker/Helm); i risultati allargano il recall della ricerca come segnale soft, mai come requisiti hard (CV_ENTITY_GRAPH_01)

Quando uno status compare significa che il modello sta eseguendo quella sotto-azione. Non devi intervenire: gli status si aggiornano da soli e svaniscono quando la risposta arriva.

Lingua della conversazione

La conversazione segue la lingua attiva dell'interfaccia utente. Se il workspace e in inglese, anche il Talent Partner, le card, i suggerimenti e gli status degli strumenti vengono resi in inglese senza configurazione manuale.

Workspace report e workflow shortlist (operativita successiva)

Quando vuoi passare al lato operativo, apri Percorso operativo dalla barra compatta Accesso rapido. Trovi:

• Overview (sintesi report)
• Shortlist (workflow shortlist persistito con priorita, note, esclusione/reinclusione, selezione per confronto)
• Confronto (confronto strutturato dei selezionati)
• Matrice gara (per report di tipo gara: matrice requisiti/candidati, dossier per candidato)
• Archivio

Esporta il report quando il workflow e allineato. Gli export disponibili rispettano il motore documentale dei profili (markdown/html/json).

Risultato atteso

• la shell di Chat HR si apre direttamente sul thread, con empty state ricco e conversazioni recenti se presenti
• il Talent Partner risponde nella tua lingua, dentro il tuo perimetro dati, citando candidati solo se davvero rilevanti
• gli strumenti che il modello sta usando sono visibili in tempo reale
• la memoria recruiter viene letta a ogni turno e arricchisce automaticamente le risposte
• ogni conversazione ripresa dallo storico mantiene il contesto e il riassunto persistente
• copia, rigenera, modifica e nuova chat permettono iterazione rapida senza ricaricare la pagina
• l'allegato CV resta locale al turno e non inquina lo stato del tenant

Errori frequenti

• Chat HR non disponibile
• causa: ruolo non abilitato oppure servizio AI non attivo per il piano del tenant
• soluzione: contattare admin tenant o platform owner

• Richiesta troppo generica
• causa: manca un dettaglio decisivo per il ranking
• soluzione: rispondere al singolo chiarimento mostrato dalla chat invece di riscrivere tutto da capo

• Configurazione AI assente
• causa: provider/modello non configurato a livello piattaforma
• soluzione: richiedere intervento a un amministratore SaaS

• CV non accettato
• causa: formato diverso da .pdf / .docx / .txt / , file vuoto, dimensione superiore a 5 MB, oppure PDF scansionato senza testo selezionabile
• soluzione: verificare che il PDF contenga testo selezionabile (no OCR), oppure convertirlo manualmente in .txt /

• CV troncato nel prompt
• causa: il testo estratto supera i 200 KB
• soluzione: tagliare il CV alle sezioni rilevanti prima di allegare

• Memoria recruiter sembra non aggiornarsi
• causa: la voce e stata creata in un altro tenant o con un altro utente
• soluzione: la memoria e per-utente per-tenant; verifica Contesto attivo nella dashboard

• Storico conversazioni vuoto dopo Nuova chat
• causa: la sessione precedente non aveva ancora messaggi quando hai cliccato Nuova chat
• soluzione: lo storico mostra solo conversazioni con almeno uno scambio assistant; riprendi il thread vuoto e fai la prima domanda

Guide collegate

• roles/hr-admin
• roles/manager
• roles/admin-tenant
• ./profilo-professionale
• ./report-core

FAQ

Devo ricordarmi di abilitare la memoria a ogni sessione?

No. La memoria recruiter e sempre attiva e viene letta in automatico. Devi solo decidere cosa salvare nei tre slot (ricerche, favoriti, gare).

La memoria recruiter e visibile ad altri utenti del tenant?

No. La memoria e per-utente all'interno del tenant: ogni recruiter mantiene il proprio archivio.

Posso passare un PDF al Talent Partner?

Si. Dal 2026-05-12 sono supportati .pdf e .docx oltre a .txt e . L'estrazione del testo avviene server-side. Per PDF scansionati senza testo selezionabile (immagini), serve convertirli manualmente: l'OCR non e' supportato.

Cosa succede se chiudo la pagina mentre il Talent Partner sta rispondendo?

La sessione resta salvata server-side. Quando rientri, riapri il thread dallo storico per riprendere da dove eri.

Posso disattivare la visualizzazione degli strumenti in esecuzione?

Non in modo selettivo. Gli status compaiono solo durante l'attesa e svaniscono al primo token di risposta.