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
  • Contesto: cos'è e a cosa serve
  • Contesto impostato e contesto necessario
  • Come gestire il contesto dei tuoi contenuti
  • Esempi pratici
  • Vantaggi dell'uso dei contesti
  1. 2. Istruzione dell'Agente e gestione dei contenuti
  2. Istruzione: sezione avanzata
  3. Personalizzazione dei contenuti

Contesto: argomenti ed etichette

PreviousGestione dei suggerimentiNextGestione dei testi preformattati (snippet di codice)

Last updated 5 months ago

AIsuru ti permette di creare conversazioni dinamiche e contestuali attraverso l'uso del contesto. Questa funzionalità ti consente di controllare quando determinate domande sono appropriate e come l'Agente dovrebbe interpretare e rispondere alle richieste dell'utente in base al contesto della conversazione.

Contesto: cos'è e a cosa serve

La gestione del contesto ti permette di definire in quali situazioni specifiche una domanda o una risposta hanno senso.

Il contesto dice ad AIsuru di cosa si sta parlando in un preciso momento e, quindi, è necessario per guidare al meglio la conversazione, accedendo ad alcuni e limitando la visibilità degli altri.

Argomenti ed etichette

Il contesto in AIsuru può essere gestito attraverso due tipi di elementi:

  • Argomenti -> sono coppie nome-valore che definiscono un contesto specifico:

    • Il nome identifica il tipo di contesto (ANIMALE, OGGETTO, ecc.);

    • Il valore specifica il contesto attuale (CANE, SMARTPHONE, ecc.).

    Esempio: ANIMALE:CANE

  • Etichette -> sono contesti semplici:

    • Il nome identifica il tema di cui si parla (es. DOMANDE_GENERICHE);

    • Le etichette sono, in realtà, argomenti che hanno "✔️" come valore nascosto.

Contesto impostato e contesto necessario

Gli argomenti e le etichette possono essere utilizzati in due modi diversi che influenzano come l'Agente gestisce i contenuti:

  • Contesto impostato ("Imposta argomenti" in piattaforma):

    • Indica all'Agente di cosa si sta parlando in questo momento;

    • Aiuta l'Agente a prioritizzare i contenuti più rilevanti per il contesto attuale;

    • NON limita l'accesso ai contenuti, ma li organizza per rilevanza;

    • Esempio:

      • Domanda: "Parliamo di cani";

      • Risposta: "Ok, parliamo di cani" [argomento impostato: ANIMALE:CANE];

      • Dopo questa frase, l'Agente saprà che la conversazione riguarda i cani e potrà fornire risposte più pertinenti.

  • Contesto necessario ("argomenti necessari" in piattaforma):

    • Funziona come un vero e proprio filtro che impedisce all'Agente di accedere ai contenuti finché non viene impostato un certo contesto;

    • L'IA può accedere a questi contenuti SOLO quando quel specifico contesto è attivo;

    • Se non imposti alcun argomento necessario, l'Agente avrà sempre accesso al tuo contenuto, a prescindere dal contesto impostato;

    • Esempio:

      • ANIMALE:CANE: la domanda è rilevante solo quando si parla di cani;

      • OGGETTO:BACCHETTA: la domanda è appropriata solo nel contesto di una bacchetta.

La differenza chiave tra i due tipi di contesto è che:

  • Il contesto impostato aiuta l'Agente a capire meglio la conversazione e a prioritizzare i contenuti più rilevanti;

  • Il contesto necessario impedisce del tutto l'accesso ai contenuti finché non viene impostato quello specifico contesto.

Una volta impostato un certo contesto, anche i contenuti con quel contesto necessario potranno essere passati all'IA generativa per rispondere alle domande degli utenti.

Come gestire il contesto dei tuoi contenuti

Aggiungi un contesto

Se vuoi aggiungere un contesto ai tuoi contenuti:

  1. Vai alla sezione "Avanzate: gestione contesto";

  2. Scegli se aggiungere un argomento da impostare (sezione "Argomenti impostati") o necessario (sezione "Argomenti necessari");

  3. Scegli tra "Nuovo argomento" o "Nuova etichetta" in base alle tue esigenze;

  4. Compila nome e valore (se presente) nella scheda che si aprirà;

  5. Conferma i dati e salva le modifiche del contenuto.

💡 Puoi anche utilizzare "Suggerisci etichette" per ricevere proposte basate sul contenuto.

Annulla un contesto

Per annullare un contesto, aggiungi un argomento con lo stesso nome e inserisci "-" come valore.

Esempio: ANIMALE:- annullerà il contesto "ANIMALE", che non sarà più impostato e non avrà più alcun valore.

Esempi pratici

Scenario: assistente per un negozio di animali

  1. Domanda dell'Agente all'utente: "Che tipo di animale ti interessa?";

  2. Utente: "I cani", imposta argomento: ANIMALE:CANE;

  3. Argomento necessario: Domanda: "Quali sono le esigenze alimentari specifiche?", argomento necessario: ANIMALE:CANE;

  4. Annullare un contesto: Domanda: "Vorrei parlare di un altro animale", imposta argomento: ANIMALE:-.

Flusso di conversazione

  1. Utente: "Vorrei informazioni sugli animali domestici";

  2. Agente: "Certo! Che tipo di animale ti interessa?";

  3. Utente: "I cani";

  4. Agente: (imposta ANIMALE:CANE) "Ottimo! I cani sono animali meravigliosi. Cosa vorresti sapere sui cani?";

  5. Utente: "Quali sono le loro esigenze alimentari?";

  6. Agente: (verifica ANIMALE:CANE, domanda pertinente) "I cani hanno bisogno di una dieta equilibrata. In generale, necessitano di proteine di alta qualità, carboidrati, grassi, vitamine e minerali. La quantità e il tipo di cibo dipendono dall'età, dalla taglia e dal livello di attività del cane...";

  7. Utente: "Vorrei parlare di un altro animale";

  8. Agente: (imposta ANIMALE:-) "Certamente! Di quale altro animale vorresti parlare?".

Vantaggi dell'uso dei contesti

  • Conversazioni più naturali e coerenti;

  • Risposte più pertinenti e precise;

  • Possibilità di creare percorsi di dialogo complessi e ramificati;

  • Migliore gestione di argomenti multipli all'interno della stessa conversazione.

L'utilizzo efficace di contesti e variabili di contesto può trasformare il tuo Agente in un assistente veramente intelligente e contestuale. Sperimenta con queste funzionalità per creare esperienze di conversazione ricche e dinamiche che si adattano alle esigenze e agli interessi specifici dei tuoi utenti.

Accedi ai Contenuti e creane uno o modificane uno esistente;

Per ragioni di sicurezza, l' non può leggere né applicare i contesti in autonomia. Questo compito viene svolto da AIsuru.

contenuti
IA generativa