Documentazione di Oracle Cloud Infrastructure

Crea incorporamenti di testo nell'AI generativa

Utilizza i modelli incorporati Cohere nell'AI generativa OCI per convertire il testo in incorporamenti vettoriali da utilizzare nelle applicazioni per la ricerca semantica, la classificazione del testo o la configurazione cluster del testo.

I dati di input per le integrazioni di testo devono avere i seguenti requisiti:

  • È possibile aggiungere frasi, frasi o paragrafi per incorporare una frase alla volta o caricando un file.
  • Sono consentiti solo file con estensione .txt.
  • Se si utilizza un file di input, ogni frase, frase o paragrafo di input nel file deve essere separato da un carattere di nuova riga.
  • Sono consentiti al massimo 96 input per ogni esecuzione.
  • Nella console, ogni input deve essere inferiore a 512 token per i modelli di solo testo.
  • Se un input è troppo lungo, selezionare se interrompere l'inizio o la fine del testo per rientrare nel limite del token impostando il parametro Truncate su Start o End. Se un input supera il limite di 512 token e il parametro Truncate è impostato su Nessuno, viene visualizzato un messaggio di errore.
  • Per i modelli di testo e immagine, è possibile disporre di file e input che sommano tutti fino a 128.000 token.
  • Per i modelli incorporati di testo e immagine, ad esempio Cohere Embed English Image V3, è possibile aggiungere testo o aggiungere solo un'immagine. Per l'immagine, è possibile utilizzare l'API. Input immagine non disponibile nella console. Per l'API, inserire un'immagine con codifica base64 in ogni esecuzione. Ad esempio, un'immagine 512 x 512 viene convertita in circa 1.610 token.
    1. Nella barra di navigazione della console selezionare un'area con intelligenza artificiale generativa, ad esempio Midwest degli Stati Uniti (Chicago). Vedere quali modelli vengono offerti nella propria area.
    2. Aprire il menu di navigazione e selezionare Analytics & AI. In Servizi AI, selezionare AI generativa.
    3. Selezionare un compartimento in cui si è autorizzati a lavorare. Se l'area di gioco non è disponibile, chiedere a un amministratore di dare l'accesso alle risorse dell'intelligenza artificiale generativa, quindi tornare AI passi riportati di seguito.
    4. Selezionare Area di riproduzione.
    5. Selezionare Incorporamento.
    6. Selezionare un modello per la creazione di incorporazioni di testo eseguendo una delle seguenti azioni:
      • Selezionare un modello nell'elenco Modello.
      • Selezionare Visualizza dettagli modello, quindi selezionare Scegli modello.
    7. (Facoltativo) Per utilizzare un esempio dall'elenco Esempio, attenersi alla procedura riportata di seguito.
      1. Selezionare un esempio dalla lista Esempio.
      2. Selezionare Esegui per generare incorporamenti per l'esempio.
      3. Esaminare una versione bidimensionale dell'output nella sezione Proiezione del vettore di output.

        Per visualizzare l'output con incorporamenti, i vettori di output vengono proiettati in due dimensioni e tracciati come punti. I punti vicini corrispondono a frasi che il modello considera simili.

      4. Selezionare Cancella per rimuovere tutte le frasi e iniziare a generare integrazioni per le nuove frasi.
    8. (Opzionale) Aggiungere un'immagine .png o .jpg con una dimensione massima di 5 MB.
      È consentita una sola immagine.
    9. Nell'area Input frasi, immettere il testo in uno dei modi seguenti:
      • Digitare una frase nella casella 1., quindi selezionare Aggiungi frase per aggiungere altre frasi.
      • Selezionare Carica file e selezionare un file con testo da aggiungere.
      Nota

      Sono consentiti solo file con un'estensione .txt. Ogni frase, frase o paragrafo di input deve essere separato da un carattere di nuova riga. Per ogni esecuzione sono consentiti al massimo 96 input e ogni input deve essere inferiore a 512 token. È possibile aggiungere frasi manualmente o caricare più file fino a raggiungere il numero massimo di input.
    10. Per il parametro Truncate, selezionare se troncare i token iniziale o finale quando i token superano il numero massimo di token consentiti (512).
      Suggerimento

      Per l'input che supera i 512 token, se si imposta il parametro Truncate su Nessuno, viene visualizzato un messaggio di errore. Prima di eseguire un modello di incorporamento, selezionare Inizio o Fine per il parametro Truncate.
    11. Selezionare Esegui.
    12. Esaminare una versione bidimensionale dell'output nella sezione Proiezione del vettore di output.
      Per visualizzare gli output con incorporamenti, i vettori di output vengono proiettati in due dimensioni e rappresentati come punti. I punti vicini corrispondono a frasi che il modello considera simili.
    13. Quando si è soddisfatti del risultato, selezionare Esporta incorporamenti in JSON per ottenere un file JSON contenente un vettore a 1024 dimensioni per ogni input.
    14. (Facoltativo) Selezionare Visualizza codice, selezionare un linguaggio o un framework di programmazione, selezionare Copia codice e incollare il codice in un file. Assicurarsi che il file mantenga il formato del codice incollato.
      Suggerimento

      Se si utilizza il codice in un'applicazione:

    15. (Facoltativo) Selezionare Cancella per rimuovere tutte le frasi e iniziare a generare integrazioni per le nuove frasi.
      Nota

      Quando si seleziona Cancella, il parametro Truncate ripristina il valore predefinito Nessuno.

  • Per creare incorporazioni per il testo, utilizzare l'operazione embed-text-result.

    Immettere il comando seguente per un elenco di opzioni per creare incorporazioni di testo.

    oci generative-ai-inference embed-text-result embed-text -h

    Per un elenco completo di parametri e valori per i comandi CLI di OCI Generative AI, vedere Generative AI Inference CLI e Generative AI Management CLI.

  • Eseguire l'operazione EmbedText per creare incorporazioni di testo.

    Per informazioni sull'uso dell'API e delle richieste di firma, consulta la documentazione dell'API REST e le credenziali di sicurezza. Per informazioni sugli SDK, vedere SDK e l'interfaccia CLI.