Documentazione di Oracle Cloud Infrastructure

Creazione di una Knowledge Base negli agenti di intelligenza artificiale generativa

Creare una knowledge base nel servizio Agenti AI generativi.

  1. Nella pagina elenco Basi di conoscenza, selezionare Crea knowledge base. Per assistenza nella ricerca della pagina di elenco, vedere Elenco delle knowledge base.
  2. Immettere le informazioni riportate di seguito.
    • Nome: un nome che inizia con una lettera o un carattere di sottolineatura, seguito da lettere, numeri, trattini o caratteri di sottolineatura. La lunghezza può essere compresa tra 1 e 255 caratteri.
    • Compartimento: compartimento in cui si desidera memorizzare la knowledge base
    • Descrizione: una descrizione facoltativa.
  3. Per Tipo di data store, selezionare una delle seguenti opzioni:
  4. Se è stata selezionata l'opzione Storage degli oggetti, eseguire le azioni riportate di seguito.
    1. In Origini dati, selezionare Specifica origine dati e immettere un nome e una descrizione facoltativa per l'origine dati.
    2. Selezionare il bucket che contiene i dati per la knowledge base. Modificare il compartimento se il bucket si trova in un altro compartimento.
      Vedere Linee guida sullo storage degli oggetti di RAG Tool per assicurarsi che i file nei bucket soddisfino i requisiti per gli agenti AI generativa.
    3. Dopo aver elencato i contenuti del bucket, eseguire una delle seguenti azioni per selezionare i file da utilizzare:
      • Per includere tutti gli elementi nel bucket, fare clic su Seleziona tutto nel bucket.
      • Selezionare i file e le cartelle da includere.
      • Espandere Aggiungi prefissi oggetto manualmente per digitare i prefissi per i file e le cartelle da includere.
    4. (Facoltativo) Selezionare Avvia automaticamente il job di inclusione per le origini dati precedenti.
      Se non si seleziona questa opzione, è necessario includere i dati in un secondo momento affinché l'agente possa utilizzarli.
    Nota

    È possibile avere una sola origine dati per knowledge base. Vedere Limiti e limitazioni per gli agenti di intelligenza artificiale generativa.
  5. Se è stato selezionato OCI OpenSearch per il tipo di origine dati, immettere le informazioni riportate di seguito. Per le linee guida, vedere RAG Tool OCI Search with OpenSearch Guidelines.
    1. Per il cluster OpenSearch, selezionare il cluster che contiene i dati per la knowledge base. Modificare il compartimento se il cluster si trova in un altro compartimento.

      Per informazioni sui cluster OpenSearch, vedere una pagina dei dettagli del cluster OpenSearch.

    2. Per l'indice OpenSearch, immettere i dettagli dell'indice OpenSearch. Vedere RAG Tool OCI Search with OpenSearch Guidelines.
    3. Per Dettagli segreti selezionare una delle opzioni riportate di seguito.
      • Segreto di autenticazione di base: per questa opzione, selezionare il segreto vault per OCI Search con OpenSearch.
      • Segreto IDCS: per questa opzione, immettere le seguenti informazioni per l'applicazione riservata IDCS che si desidera utilizzare per l'agente:
        • Dominio di Identity: selezionare il dominio di Identity da utilizzare per accedere al cluster. Modificare il compartimento se il dominio di Identity si trova in un altro compartimento.
        • ID client: immettere l'ID per l'applicazione client IDCS del cluster OpenSearch.
        • Vault segreto client: selezionare il vault che contiene il segreto client. Modificare il compartimento se il segreto si trova in un altro compartimento.
        • URL ambito: immettere l'URL che rappresenta l'endpoint API per l'applicazione server delle risorse del dominio di Identity e include l'ambito dell'agente. Ad esempio, per l'ambito genaiagent, l'URL è https://*.agent.aiservice.us-chicago-1.oci.oraclecloud.com/genaiagent.
  6. Se è stato selezionato Oracle AI Vector Search per il tipo di origine dati, selezionare la connessione allo strumento di database, quindi selezionare Test della connessione per confermare una connessione al database riuscita. In caso di esito positivo, vengono visualizzati il nome e la versione del database. Immettere quindi la funzione o la procedura di ricerca vettoriale per la connessione allo strumento di database.
    Nota

    Per informazioni sulla funzione o sulla procedura, vedere RAG Tool Oracle Database Guidelines o RAG Tool Heatwave MySQL Guidelines.
  7. (Facoltativo) Selezionare Mostra opzioni di applicazione tag e aggiungere una o più tag a questa risorsa. Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare tag in formato libero a tale risorsa. Per applicare una tag defined, è necessario disporre delle autorizzazioni per utilizzare la tag namespace. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa. Se non sei sicuro di applicare i tag, salta questa opzione o chiedi a un amministratore. È possibile applicare i tag in un secondo momento.
  8. Selezionare Crea.

    La knowledge base richiede un po' di tempo per creare. Dopo aver creato la knowledge base, se non si dispone di dati inclusi per un'origine dati dello storage degli oggetti, attenersi alla procedura descritta in Inserimento dei dati dell'origine dati negli agenti AI generativa.

    Nota

    Dopo l'esecuzione di un job di inclusione dati per un'origine dati di storage degli oggetti, esaminare i log di stato e di stato per verificare che tutti i file aggiornati siano stati inclusi correttamente.

    Per informazioni sul significato dello stato di un job di inclusione e sull'azione da eseguire in caso di errore, vedere Inclusione dei dati di origine dati, passo 6.

    Se il job di inclusione non riesce (ad esempio, perché un file era troppo grande), risolvere il problema e riavviare il job.

    Quando riavvii un job di inclusione eseguito in precedenza, la pipeline rileva i file precedentemente inclusi e li ignora. La pipeline include solo i file con errori precedenti e successivi aggiornamenti. Ad esempio, si dispone di 20 file da includere e l'esecuzione del job iniziale comporta 2 file non riusciti. Quando riavvii il job, la pipeline riconosce che 18 file sono già stati inclusi correttamente e li ignora. Include solo i 2 file non riusciti in precedenza e da allora sono stati aggiornati.