Gestione Aziende

Ogni azienda in Queria rappresenta un ambiente completamente isolato. Documenti, utenti, conversazioni e configurazioni sono separati per garantire la massima riservatezza nell'architettura multi-tenant.

Creare una nuova azienda

Dal pannello di amministrazione, seleziona Nuova azienda e compila le informazioni richieste.

I campi obbligatori sono il nome dell'azienda e la tipologia. Descrizione e logo possono essere aggiunti in un secondo momento.

Tipologie aziendali

Queria supporta due modalita operative, ciascuna ottimizzata per un caso d'uso specifico.

Documentale

Pensata per organizzazioni che necessitano di caricare, gestire e interrogare documenti interni. Supporta i formati PDF, DOCX, XLSX e altri formati comuni. I documenti vengono processati dall'architettura Cog-RAG per l'indicizzazione semantica e la ricerca intelligente.

Funzionalita principali:

• Caricamento documenti con estrazione automatica del testo
• OCR integrato per documenti scansionati e immagini
• Knowledge base curata per contenuti permanenti
• Documenti temporanei associati alle singole conversazioni

Online

Progettata per aziende che operano con contenuti web. Permette di indicizzare pagine web, monitorare siti e costruire una base di conoscenza a partire da fonti online.

Funzionalita principali:

• Web scraping automatico con pianificazione
• Indicizzazione contenuti da URL specifici
• Sintesi automatica dei contenuti con AI
• Monitoraggio aggiornamenti delle fonti

Configurazione azienda

Dopo la creazione, ogni azienda puo essere personalizzata in dettaglio.

Informazioni base

• Nome: il nome visualizzato nell'interfaccia e nei widget
• Descrizione: una breve descrizione dell'attivita o dello scopo
• Logo: immagine identificativa, utilizzata anche nei widget integrabili

Prompt di sistema

Il prompt di sistema definisce il comportamento dell'assistente AI per l'intera azienda. Qui puoi specificare il tono, il dominio di competenza, le regole di risposta e i vincoli da rispettare. Ogni conversazione eredita queste istruzioni, salvo sovrascrittura a livello di topic.

Chiave API

Genera una chiave API per integrare Queria in applicazioni esterne, widget o automazioni. La chiave e associata all'azienda e ne rispetta tutte le configurazioni e i limiti di abbonamento.

Attenzione

La chiave API viene mostrata una sola volta al momento della generazione. Conservala in un luogo sicuro. Puoi rigenerarla in qualsiasi momento, invalidando la precedente.

Settore e sotto-settore

A partire dalla v3.5.0 ogni azienda viene associata a un settore (LEGAL, FINANCE, HEALTHCARE, ...) e opzionalmente a un sotto-settore. La scelta determina:

• Il preset RAG di default (chunking, tag, domain terms).
• I termini di dominio applicati a ingestione e retrieval.
• Le sorgenti esterne suggerite (es. LEGAL -> Legal Sources).
• Le politiche di accesso e confidenzialita.
• L'eventuale AI Constructor disponibile (es. TOURISM -> Tourism Constructor).

Per la mappatura completa, consulta Settori e YAML.

Cambio di settore

Se cambi settore a un'azienda con documenti gia ingestati, esegui un backfill sector-fields sui chunk esistenti per stampigliare i nuovi termini di dominio. Vedi Ingestion DSL > Reingest.

Tag

Etichette libere associate all'azienda (es. enterprise, pilot, EU-East). Vengono usate:

• Come filtro lato amministrazione (cross-tenant per SYSTEM_ADMIN).
• Dal planner del bot per disambiguare comportamenti specifici (es. tono enterprise vs SMB).
• Per raggruppare le aziende in dashboard di consumo.

I tag si inseriscono separati da invio o tab. Possono essere modificati in qualsiasi momento senza impatto sui documenti gia ingestati.

Domain terms (dizionario aziendale)

Termini specifici della tua azienda che non rientrano nel dominio generico del settore: sigle interne, nomi prodotti, gergo tecnico. Vengono uniti ai domainTerms del settore quando il sistema valuta la pertinenza dei chunk.

Esempi:

• MOL-adj (margine operativo lordo aggiustato, sigla interna).
• Prodotto Alpha, Codice ATECO 62.01.
• Acronimi del cliente.

Inseriscili nella scheda azienda > Domain terms, uno per riga. Aggiunte e rimozioni richiedono un backfill sector-fields per essere applicate ai chunk esistenti.

Pipeline AI (canvas DSL)

A differenza delle versioni precedenti, la pipeline AI (chat, ricerca, ingestione) non si configura piu nella scheda azienda. Va modificata nei rispettivi canvas DSL:

• Chat: Chat DSL (Canvas)
• Ingestione: Ingestion DSL
• Integrazioni esterne: OAuth e Service Canvas

L'azienda eredita i canvas di sistema; puoi duplicarli e associarne versioni custom per topic specifici.

Isolamento multi-tenant

L'isolamento e garantito a tutti i livelli:

• Dati: ogni azienda ha collezioni vettoriali e archivi separati
• Utenti: nessun utente puo accedere a dati di altre aziende
• Pipeline: ogni azienda eredita o personalizza i canvas DSL (chat, ingestione, service) in modo indipendente
• Connessioni OAuth: le connessioni esterne sono per (utente, azienda, service); nessuna fuoriuscita cross-tenant
• Consumi: il monitoraggio dei token e dei canali e separato per azienda

Eliminazione azienda

L'eliminazione di un'azienda e un'operazione irreversibile che comporta la cancellazione permanente di tutti i dati associati: documenti, conversazioni, utenti, configurazioni e indici vettoriali.

Operazione irreversibile

Prima di procedere, assicurati di aver esportato eventuali dati necessari. Il sistema richiede una doppia conferma e la digitazione del nome dell'azienda per procedere.

Buone pratiche

• Scegli la tipologia aziendale corretta fin dall'inizio: il cambio successivo non e supportato
• Configura il prompt di sistema prima di invitare gli utenti
• Genera la chiave API solo quando necessario e limitane la distribuzione
• Assegna un Company Admin dedicato per ogni azienda
• Utilizza nomi descrittivi per facilitare la gestione con molte aziende