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
  • Implementazione di una funzione per recuperare contenuti web live
  • Esempio pratico: il blog del Comune di Verona
  1. 5. Funzionalità avanzate
  2. Integrazioni
  3. Funzioni
  4. Funzioni avanzate
  5. Funzioni avanzate: best practice e casi d'uso

Caso d'uso - Aggiornamento automatico: il tuo Agente sempre connesso al web

AIsuru offre la potente capacità di arricchire le conversazioni del tuo Agente con informazioni in tempo reale provenienti da siti web esterni. Questa funzionalità permette al tuo assistente virtuale di fornire dati aggiornati su vari argomenti, migliorando notevolmente la qualità e la rilevanza delle interazioni.

In questa guida, vedremo un esempio concreto di implementazione: creeremo una funzione per recuperare e analizzare contenuti HTML da una pagina web in tempo reale. Questo ci permetterà di rielaborare il codice HTML ed estrarre i contenuti utili attraverso l'IA generativa.

Implementazione di una funzione per recuperare contenuti web live

Seguiamo passo dopo passo la creazione di una funzione che recupera contenuti HTML da un sito web e li analizza:

  1. Accesso e creazione

    • Accedi al pannello di gestione del tuo Agente in AIsuru;

    • Vai su "Funzioni" > "Funzioni avanzate";

    • Clicca su "Nuova funzione".

  2. Configurazione della funzione

    • Nome: dai un nome breve ma descrittivo della tua funzione (es. domande_sito, non usare gli spazi);

    • Descrizione: fai copia e incolla di questa descrizione; "Questa funzione recupera il contenuto HTML di una pagina web specifica. Utilizzala quando un utente chiede informazioni o aggiornamenti da un sito web particolare."

    • Webhook: inserisci il link della pagina da analizzare;

    • Metodo HTTP: usa il metodo GET già selezionato.

  3. Test della funzione

    • Scorri in fondo e premi sul tasto Test > Esegui;

    • Verifica il funzionamento della tua funzione: dovresti vedere il codice della pagina web come risposta.

✅ Se è tutto corretto puoi salvare la tua funzione.

Integrazione nelle istruzioni dell'Agente

Ora che la tua funzione è pronta, la dovrai integrare nelle Istruzioni dell'Agente:

  1. Vai alla sezione Impostazioni del tuo Agente > IA > Istruzioni;

  2. Aggiungi queste istruzioni:

Sei un assistente specializzato nell'analisi di contenuti web in tempo reale. Quando un utente chiede informazioni da un sito web specifico:

1. Usa la funzione [nome della funzione] con l'URL della pagina come parametro;
2. Analizza il contenuto HTML ricevuto ed estrai le informazioni rilevanti;
3. Presenta le informazioni in modo chiaro e conciso, organizzandole in un formato facilmente comprensibile;
4. Se richiesto, fornisci ulteriori dettagli o approfondimenti sul contenuto analizzato.

Esempio pratico: il blog del Comune di Verona

Vediamo ora un esempio concreto di come utilizzare questa funzione per creare un Agente che mostri all'utente gli articoli presenti in tempo reale sul blog del Comune di Verona.

Configurazione Specifica:

  • Nome: comune_verona_blog

  • Descrizione: "Utilizza questa funzione quando l'utente chiede i contenuti del blog del comune di Verona. Analizza le informazioni per rispondere in maniera chiara e organizzata."

  • Webhook: https://www.comune.verona.it/nqcontent.cfm?a_id=70461

Istruzioni specifiche per l'Agente

Aggiungi queste istruzioni specifiche al prompt dell'Agente:

Sei un assistente specializzato per il blog del Comune di Verona. Quando un utente chiede informazioni sugli articoli recenti:

1. Usa la funzione comune_verona_blog per ottenere il contenuto HTML della pagina del blog;
2. Analizza il contenuto ed estrai titoli e brevi descrizioni degli articoli recenti;
3. Presenta un elenco organizzato degli articoli all'utente, includendo titolo e una breve sintesi per ciascuno;
4. Offri la possibilità di fornire ulteriori dettagli su articoli specifici se richiesto.

Esempio di interazione

Utente: "Quali sono gli articoli recenti nel blog di Verona?"

[L'Agente utilizza la funzione comune_verona_blog]

Agente: Certamente! Lascia che controlli gli ultimi aggiornamenti dal blog del Comune di Verona.

Ecco un elenco degli articoli più recenti pubblicati sul blog del Comune di Verona:

  1. Scuole dell'Infanzia: Accoglienza bambini 3-6 anni

    • Il Comune annuncia nuove iniziative per l'accoglienza dei bambini nelle scuole dell'infanzia, con focus su attività educative e socializzazione.

  2. Consiglio comunale: Apertura 2° sessione 2024

    • Annuncio della data e dell'ordine del giorno per la prossima sessione del Consiglio comunale, con discussioni su importanti temi cittadini.

  3. Bando di gara n.23/24: Nomina Commissione giudicatrice

    • Informazioni sulla nomina della commissione giudicatrice per un recente bando di gara comunale, includendo dettagli sul processo di selezione.

Desideri ulteriori informazioni su uno di questi articoli in particolare o preferisci una panoramica generale sulle attività recenti del Comune?

Con questa implementazione, il tuo Agente diventa una fonte affidabile di informazioni aggiornate da siti web specifici. Questo esempio di funzione per l'analisi di contenuti web è solo l'inizio: puoi applicare lo stesso approccio per integrare dati da vari siti web, espandendo ulteriormente le capacità del tuo Agente! 🌟

PreviousFunzioni avanzate: best practice e casi d'usoNextCaso d'uso - Prendere dati live da un servizio esterno

Last updated 5 months ago

Ricorda di rispettare sempre i termini di servizio dei siti web che intendi analizzare. Se l'Agente non riesce ad estrapolare le informazioni, assicurati di non star superando la (se la pagina è particolarmente lunga e complessa) e che il file robots.txt non blocchi l'accesso al modello linguistico.

finestra di contesto