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
  1. 10. Risorse aggiuntive
  2. API Engine

Media

PreviousLocalizationKeysNextMemories

Lists all Medium objects of a Memory.

get

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

Responses
200
Success
application/json
get
GET /memori/v2/Media/{strSessionID}/{strMemoryID} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "media": [
    {
      "mediumID": "text",
      "url": "text",
      "content": "text",
      "mimeType": "text",
      "title": "text",
      "properties": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "creationTimestamp": "2025-06-06T20:51:54.905Z",
      "creationSessionID": "text",
      "lastChangeTimestamp": "2025-06-06T20:51:54.905Z",
      "lastChangeSessionID": "text"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-06-06T20:51:54.905Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Removes all Medium objects from a Memory.

delete

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

Responses
200
Success
application/json
delete
DELETE /memori/v2/Media/{strSessionID}/{strMemoryID} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "requestID": 1,
  "requestDateTime": "2025-06-06T20:51:54.905Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets the details of a Medium object of a Memory.

get

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

strMediumIDstringRequired

The Medium object ID

Responses
200
Success
application/json
get
GET /memori/v2/Medium/{strSessionID}/{strMemoryID}/{strMediumID} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "medium": {
    "mediumID": "text",
    "url": "text",
    "content": "text",
    "mimeType": "text",
    "title": "text",
    "properties": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "creationTimestamp": "2025-06-06T20:51:54.905Z",
    "creationSessionID": "text",
    "lastChangeTimestamp": "2025-06-06T20:51:54.905Z",
    "lastChangeSessionID": "text"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-06T20:51:54.905Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Removes an existing Medium object from a Memory.

delete

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

strMediumIDstringRequired

The Medium object ID

Responses
200
Success
application/json
delete
DELETE /memori/v2/Medium/{strSessionID}/{strMemoryID}/{strMediumID} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "requestID": 1,
  "requestDateTime": "2025-06-06T20:51:54.905Z",
  "resultCode": 1,
  "resultMessage": "text"
}
  • GETLists all Medium objects of a Memory.
  • DELETERemoves all Medium objects from a Memory.
  • GETGets the details of a Medium object of a Memory.
  • DELETERemoves an existing Medium object from a Memory.
  • PATCHUpdates an existing Medium object of a Memory.
  • POSTAdds a new Medium object to a Memory.

Updates an existing Medium object of a Memory.

patch

This API requires a Giver session. Only non-null (present) fields are considered for update. Null or absent fields are left unaltered.

Path parameters
strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

strMediumIDstringRequired

The Medium object ID

Body
mediumIDstring | nullableOptional

Medium object ID.

urlstring | nullableOptional

URL of the Medium. If specified, the Content property must be Null. Use this property to link large amounts of data stored externally. If the amount of data is modest the Content property may be used as an alternative.

contentstring | nullableOptional

Content of the Medium. If specified, the URL property must be Null. Don't use this property to store large amounts of data. Can be used to store limited text for a maximum of 10 KiB. For larger amounts store the data externally and link it via the URL property.

mimeTypestring | nullableOptional

MIME type of the Medium. Required during Add operations.

titlestring | nullableOptional

Title of the Medium.

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Always present when reading/receiving an object, ignored when writing/sending an object.

creationSessionIDstring | nullableOptional

ID of the session that created this object.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Always present when reading/receiving an object, ignored when writing/sending an object.

lastChangeSessionIDstring | nullableOptional

ID of the latest session that changed this object.

Responses
200
Success
application/json
patch
PATCH /memori/v2/Medium/{strSessionID}/{strMemoryID}/{strMediumID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 282

{
  "mediumID": "text",
  "url": "text",
  "content": "text",
  "mimeType": "text",
  "title": "text",
  "properties": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "creationTimestamp": "2025-06-06T20:51:54.905Z",
  "creationSessionID": "text",
  "lastChangeTimestamp": "2025-06-06T20:51:54.905Z",
  "lastChangeSessionID": "text"
}
200

Success

{
  "requestID": 1,
  "requestDateTime": "2025-06-06T20:51:54.905Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Adds a new Medium object to a Memory.

post

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

Body

Specifications of a Medium object.

mediumIDstring | nullableOptional

Medium object ID.

urlstring | nullableOptional

URL of the Medium. If specified, the Content property must be Null. Use this property to link large amounts of data stored externally. If the amount of data is modest the Content property may be used as an alternative.

contentstring | nullableOptional

Content of the Medium. If specified, the URL property must be Null. Don't use this property to store large amounts of data. Can be used to store limited text for a maximum of 10 KiB. For larger amounts store the data externally and link it via the URL property.

mimeTypestring | nullableOptional

MIME type of the Medium. Required during Add operations.

titlestring | nullableOptional

Title of the Medium.

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Always present when reading/receiving an object, ignored when writing/sending an object.

creationSessionIDstring | nullableOptional

ID of the session that created this object.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Always present when reading/receiving an object, ignored when writing/sending an object.

lastChangeSessionIDstring | nullableOptional

ID of the latest session that changed this object.

Responses
200
Success
application/json
post
POST /memori/v2/Medium/{strSessionID}/{strMemoryID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 282

{
  "mediumID": "text",
  "url": "text",
  "content": "text",
  "mimeType": "text",
  "title": "text",
  "properties": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "creationTimestamp": "2025-06-06T20:51:54.905Z",
  "creationSessionID": "text",
  "lastChangeTimestamp": "2025-06-06T20:51:54.905Z",
  "lastChangeSessionID": "text"
}
200

Success

{
  "mediumID": "text",
  "requestID": 1,
  "requestDateTime": "2025-06-06T20:51:54.905Z",
  "resultCode": 1,
  "resultMessage": "text"
}