AIsuru Docs
AIsuru
AIsuru
  • 0. Introduzione ad AIsuru
    • Cos'è AIsuru
    • Per chi è AIsuru?
    • Panoramica delle funzionalità principali
    • Che differenza c'è con ChatGPT?
    • Requisiti di sistema
  • 1. Primi passi
    • Creazione di un account
    • Navigazione dell'interfaccia utente
    • Creazione del primo Agente
      • Come creare un Agente
      • Importazione rapida di un documento
      • Condivisione
    • Video riassuntivo
    • Gestione account
  • 2. Istruzione dell'Agente e gestione dei contenuti
    • Come istruire un Agente: panoramica dei metodi
    • Istruiscimi: insegna nuove informazioni all'Agente chiacchierando
    • Contenuti
      • Cosa sono i contenuti e perché sono importanti
      • Creazione manuale dei contenuti
      • Validazione e correzione dei contenuti
      • Modifica e aggiornamento dei contenuti
    • Importazione di documenti
      • Come funziona l'importazione di documenti
      • Importare documenti testuali
      • Gestione delle immagini nei documenti
    • Dizionario
    • Istruzione: sezione avanzata
      • Personalizzazione dei contenuti
        • Come attribuire contenuti a persone o ruoli specifici
        • Personalizzare le risposte in base a data e luogo dell'utente
        • Gestione dei suggerimenti
        • Contesto: argomenti ed etichette
        • Gestione dei testi preformattati (snippet di codice)
        • Utilizzo del timeout
      • Importazione avanzata di documenti
        • Creare una gerarchia dei documenti
        • Importare un documento non supportato
      • Messaggio di benvenuto
      • Risposte predefinite
      • Formattazione dei messaggi: HTML e formule matematiche
      • Metodi avanzati di istruzione
  • 3. Modelli linguistici e IA generativa
    • Attiva l'IA generativa e cambia il modello
    • Istruzioni IA
      • Istruzioni IA: cosa sono e come modificarle
      • Come scrivere istruzioni efficaci
      • Esempi di istruzioni efficaci
    • Provider e modelli di IA generativa
    • IA generativa: sezione avanzata
      • Altre impostazioni dell'IA generativa
      • Crea e gestisci le configurazioni dei modelli
      • Cosa fare in caso di problemi
  • 4. Condivisione e pubblicazione
    • Crea e gestisci i layout di condivisione
    • Codice di embed
    • Condividi i tuoi Agenti
      • Condividi un link al tuo Agente
      • Incorpora l'Agente sul tuo sito web
      • Scarica una pagina HTML con il tuo Agente
      • Integra l'Agente con il tuo blog WordPress
      • Inserisci l'Agente all'interno di totem e dispositivi fisici
      • Aggiungi l'Agente al tuo spazio virtuale (VR e AR)
      • Integrazione con WhatsApp Business
    • Visibilità in homepage
    • Condivisione: sezione avanzata
      • Domanda iniziale
      • Personalizzazione avanzata dell'interfaccia utente
      • Analisi del codice di embed
      • Modificare il nome dell'Agente
  • 5. Funzionalità avanzate
    • Backup dell'Agente
    • Trasferimento e cancellazione dell'Agente
    • Integrazioni
      • Funzioni
        • Cosa sono le funzioni
        • Funzioni di AIsuru
        • Funzioni avanzate
          • Come configurare una funzione personalizzata
          • Funzioni avanzate: best practice e casi d'uso
            • Caso d'uso - Aggiornamento automatico: il tuo Agente sempre connesso al web
            • Caso d'uso - Prendere dati live da un servizio esterno
          • Problemi comuni con le funzioni avanzate
          • Cache delle funzioni
      • Intenti dinamici
        • Cosa sono e come configurare gli intenti dinamici
        • Come usare gli slot
        • Tunneling: esempio di una live chat su AIsuru
      • Intenti dinamici o funzioni, cosa usare?
      • Copia gli intenti dinamici, gli slot e le funzioni da un altro Agente
    • Gestione degli utenti
      • Differenza tra autori e persone
      • Invito e gestione degli autori
      • Creazione e gestione delle persone
    • Fine-tuning
      • Cos'è il fine-tuning e a cosa serve
      • Come fare fine-tuning in maniera semplice con AIsuru
      • Come sfruttare modelli fine-tuned su AIsuru
    • Interfacce web: come creare esperienze interattive
  • 6. Consumi e Analytics
    • Consumi
      • Come funzionano i consumi?
      • Monitora i tuoi consumi
      • Come ricaricare i crediti
    • Analisi e ottimizzazione dell'Agente
      • Statistiche
      • Storico delle conversazioni
      • Velocità di risposta
      • Preferenze notifiche
  • 7. Estensioni
    • Gruppo di esperti
      • Cosa sono i gruppi di esperti
      • Creare un gruppo di esperti
      • Come aggiungere Agenti al gruppo e descriverli
      • Come sfruttare i contenuti nel gruppo di esperti
      • Gruppo di esperti: best practice e casi d'uso
    • Pensiero Profondo
      • Cosa è Pensiero Profondo
      • Attivazione e configurazione
      • Gestione delle memorie
      • Best practices e casi d'uso
      • Analytics
        • Ricerca interessi degli utenti
        • Ricerca di segmenti di pubblico in linguaggio naturale
    • Spazi Virtuali (VR e MR)
      • Cosa è uno spazio virtuale
      • Creazione di uno spazio virtuale
      • Aggiungere Agenti agli spazi virtuali
      • Aggiungere oggetti agli spazi virtuali
      • Entrare in uno spazio virtuale
      • Casi d'uso
    • Open Badge
  • 8. Platform as a Service (PaaS)
    • Vantaggi della PaaS
    • Come attivare e configurare la PaaS
    • Come collegare la PaaS al tuo dominio
    • Gestione degli utenti nella PaaS
    • Come controllare i consumi della piattaforma
    • Personalizzazione dell'ambiente PaaS
    • Sicurezza e privacy
    • Supporto e manutenzione
  • 9. Documentazione Frontend
    • ⚛️ Componente React
    • 🌐 Web Component
    • 🎨 Stile e Personalizzazione
    • 🔌 Client API
  • 10. Risorse aggiuntive
    • Glossario dei termini
    • Link utili e supporto
    • API Engine
      • ChatLogs
      • ContextVars
      • CorrelationPairs
      • CustomDictionary
      • Dialog
      • EventLogs
      • ExpertReferences
      • Functions
      • Intents
      • LocalizationKeys
      • Media
      • Memories
      • NLP
      • People
      • Search
      • Session
      • Stats
      • Topics
      • UnansweredQuestions
      • User
      • WebHooks
      • Models
Powered by GitBook
On this page
  • Procedura generale
  • Gestione di formati specifici
  1. 2. Istruzione dell'Agente e gestione dei contenuti
  2. Istruzione: sezione avanzata
  3. Importazione avanzata di documenti

Importare un documento non supportato

PreviousCreare una gerarchia dei documentiNextMessaggio di benvenuto

Last updated 5 months ago

AIsuru supporta l'importazione di vari tipi di documenti testuali, ma ci possono essere situazioni in cui desideri importare un formato non supportato ufficialmente. Questa guida ti aiuterà a gestire l'importazione di diversi tipi di file non standard, assicurando che il tuo Agente IA possa accedere e utilizzare efficacemente queste informazioni.

Procedura generale

Se il formato del tuo documento non è direttamente supportato:

  1. Estrai il testo o le informazioni dal tuo file;

  2. Incolla le informazioni che hai estratto ->

    1. Nelle se vuoi che l'IA sappia sempre tutto (e se il testo utilizza meno di 200.000 caratteri);

    2. O nei se vuoi separare le informazioni per argomenti ->

      1. Domanda -> inserisci una parola chiave;

      2. Varianti di domanda -> scrivi specifiche domande per cui quelle informazioni sono utili;

      3. Risposta -> inserisci il testo che hai estratto;

  3. Spiega come leggere e come utilizzare i dati nelle istruzioni del tuo Agente.

Gestione di formati specifici

Ora che abbiamo visto la procedure generale, vediamo come puoi caricare file di specifici formati.

File Excel

I file Excel, ed in generale le tabelle, più semplici possono essere trasformati in formato markdown e possono essere inseriti all'interno di un contenuto o delle istruzioni del tuo Agente.

Se, però, il tuo file Excel è più complesso e vuoi una maggiore accuratezza nelle risposte:

  1. Identifica diverse categorie in cui puoi accorpare i dati;

  2. A partire dal tuo Excel, estrai le informazioni e salvale in diversi file JSON (uno per categoria) che abbiano una struttura semplice e chiara anche per un essere umano;

  3. Copia il codice dei tuoi file JSON e incollalo ->

    1. Nelle istruzioni se il totale non supera i 200.000 caratteri

    2. In tanti contenuti diversi (uno per categoria, come i file) ->

      1. Domanda -> inserisci una parola chiave;

      2. Varianti di domanda -> inserisci esempi di domande a cui l'IA dovrebbe rispondere a partire da quelle informazioni;

      3. Risposta -> inserisci il codice del tuo file JSON.

  4. Nelle istruzioni, spiega all'Agente dove trova le informazioni (se nelle istruzioni, nei contenuti o nelle funzioni), come leggere i dati (la struttura del JSON) e come li deve utilizzare per rispondere alle richieste degli utenti.

Video

AIsuru non supporta ufficialmente l'istruzione a partire da file video. Se vuoi rendere un video interrogabile:

  1. Ottieni una trascrizione del video (utilizza whisper di OpenAI o sfrutta Sharepoint per i meeting di Teams);

  2. Nelle istruzioni spiega cosa deve fare l'IA, copia la trascrizione e incollala.

✅ Finito! Ora l'AI saprà rispondere alle domande sul video. La qualità delle risposte dipenderà molto dalla qualità della trascrizione stessa.

Se utilizzi Microsoft SharePoint, puoi anche allegare il link del video (al minuto preciso) ad ogni risposta:

  1. Assicurati di copiare anche il minutaggio della trascrizione e riportalo nelle istruzioni del tuo Agente;

  2. Copia il link del video;

  3. Personalizza e aggiungi queste istruzioni:

1. LINK VIDEO:
 - Il video si trova qui: `...name.mp4`

2. TRASCRIZIONE:
 - La trascrizione precede ogni parte con hh:mm:ss indicando l'ora, il minuto e il secondo preciso in cui qualcosa viene detto.
 - Devi ASSOLUTAMENTE tenere conto della trascrizione, del tempo ESATTO e della seguente regola per creare il link al minuto preciso.

3. COMPOSIZIONE DEL LINK AL MINUTO PRECISO:
 - Se il minuto indica, per esempio, 5 minuti e 16 secondi, significa `5*60+16 = 316` secondi. Devi quindi aggiungere questa parte variabile al link:
 `&nav=%7B%22playbackOptions%22%3A%7B%22startTimeInSeconds%22%3AXXX%7D%7D` dove `XXX` deve essere sostituito con i secondi esatti.

### Esempio:
- Calcolo: `5 minuti e 16 secondi = 5*60+16 = 316 secondi`
- Parte variabile: `&nav=%7B%22playbackOptions%22%3A%7B%22startTimeInSeconds%22%3A316%7D%7D`
- Link completo: `...name.mp4&nav=%7B%22playbackOptions%22%3A%7B%22startTimeInSeconds%22%3A316%7D%7D`

Queste istruzioni sono state create per Microsoft SharePoint. Se utilizzi YouTube o un altro servizio, assicurati di modificare la parte variabile del link.

Immagini

Per importare informazioni dalle immagini:

  1. Utilizza ChatGPT o Claude per ottenere una descrizione accurata e completa dell'immagine;

  2. Esporta il testo e inseriscilo ->

    1. Nelle istruzioni -> se vuoi che l'Agente abbia sempre in mente le informazioni estratte;

    2. In un contenuto -> se vuoi mostrare l'immagine in specifiche occasioni (con determinate parole chiave o domande):

      1. Domanda -> inserisci una domanda a cui l'immagine risponde (o una parola chiave);

      2. Varianti di domanda -> aggiungi altre domande per cui l'immagine potrebbe essere utile;

      3. Risposta -> la descrizione dell'immagine;

L'importazione di documenti non supportati richiede un po' più di lavoro manuale, ma permette di integrare una vasta gamma di informazioni nel tuo Agente AI. Scegli il metodo più appropriato in base al tipo di documento e alla struttura delle informazioni che contiene. Ricorda sempre di verificare che le informazioni importate siano accurate e facilmente accessibili all'Agente per garantire risposte precise e pertinenti.

In tante diverse (una per categoria, come i file) -> puoi utilizzare anche le funzioni per ospitare i tuoi contenuti. Ti basterà rendere accessibile il tuo file JSON e l'Agente andrà a recuperare le informazioni quando necessario

-> aggiungi la tua immagine.

istruzioni
contenuti
funzioni
Media