0 / 0
Torna alla versione inglese della documentazione

Aggiunta di file da referenziare dall'API

Ultimo aggiornamento: 20 mar 2025
Aggiunta di file da referenziare dall'API

Scopri come aggiungere file a watsonx.ai a cui vuoi fare riferimento a livello di codice.

Per completare alcune attività a livello di codice, devi essere in grado di aggiungere file e farvi riferimento dall'API. Ad esempio, per sintonizzare un modello di fondazione in modo programmatico, è necessario fornire un file di dati di addestramento.

È possibile aggiungere file creando uno dei seguenti tipi di risorse:

  • asset di connessione
  • Asset di dati

Per ulteriori informazioni, vedere Riferimenti dati nella documentazione dell'API del servizio IBM watsonx.ai.

Aggiunta di file creando una risorsa di connessione dall'interfaccia utente

Un modo per rendere disponibile un file è aggiungere il file a un nuovo bucket nell'istanza del servizio IBM Cloud Object Storage associato al progetto watsonx.ai. (Un'istanza del servizio IBM Cloud Object Storage viene creata automaticamente quando si crea un progetto watsonx.ai dall'interfaccia utente)

Per aggiungere file creando una risorsa di connessione dall'interfaccia utente del prodotto a cui è possibile fare riferimento dall'API, completare i seguenti passaggi:

  1. Aggiungete un bucket all'istanza IBM Cloud Object Storage associata al progetto watsonx.ai.

    Dall'elenco Risorse in IBM Cloud, espandere Storage, quindi fare clic per aprire l'istanza del servizio IBM Cloud Object Storage. Fai clic su Crea bucket.

  2. Aggiungere un file al bucket.

    Dalla scheda Objects del bucket, caricare il file.

  3. Per fare riferimento al file dall'API, è necessario creare una connessione all'istanza del servizio IBM Cloud Object Storage con il bucket in cui è memorizzato il file.

    1. Dal progetto, scegliere Nuova risorsa > Connetti a un'origine dati e scegliere IBM Cloud Object Storage, quindi fare clic su Avanti.

    2. Assegnare un nome all'asset di connessione.

    3. Per i dettagli della connessione, aggiungere le seguenti informazioni:

      • Il nome del bucket creato al punto 1.

      • Per ottenere il login URL, aprire lo storage bucket in IBM Cloud Object Storage, fare clic sulla scheda Configurazioni e copiare l'endpoint pubblico URL.

      • Per le credenziali, scegliere l'opzione di autenticazione Access Key e Secret Key per connettersi all'origine dati. Dalla pagina principale del servizio per l'istanza del servizio IBM Cloud Object Storage, fare clic sulla scheda Credenziali del servizio, quindi individuare la chiave che si desidera utilizzare ed espanderla in modo da visualizzare i dettagli della chiave. La chiave utilizzata deve includere una credenziale HMAC. Se non si dispone di una chiave esistente con una credenziale HMAC, crearne una. Copiare i seguenti valori per incollarli nei campi corrispondenti della pagina dei dettagli dell'asset di connessione:

        Copia dal secchio Incolla nell'asset di connessione
        ACCESS_KEY_ID Chiave di accesso
        SECRET_ACCESS_KEY Chiave segreta

      Per ulteriori informazioni su come creare una connessione all'istanza del servizio IBM Cloud Object Storage dal progetto watsonx.ai, vedere IBM Cloud Object Storage.

  4. Dalla pagina Assets del progetto, aprire l'asset IBM Cloud Object Storage della connessione dati. Nel sito URL per la pagina corrente, copiare l'ID di connessione visualizzato dopo il segmento /connections/ del sito URL.

    Puoi specificare questo ID di connessione e altri dettagli, come il nome del bucket, quando fai riferimento al file dall'API.

    "type": "connection_asset",
       "connection": {
         "id": "<connection_id>"
       }
    

Aggiunta di file creando una risorsa dati dall'interfaccia utente

Per aggiungere file creando una risorsa dati dall'interfaccia utente del prodotto a cui è possibile fare riferimento dall'API, completare i seguenti passaggi:

  1. Dalla pagina di panoramica del progetto, fare clic sul riquadro Aggiungi dati con cui lavorare.

  2. Fare clic su File locale, quindi su Risorsa dati.

  3. Fare clic su Sfoglia per trovare e selezionare il file che si desidera caricare.

  4. Fare clic su Apri, quindi su Fine.

  5. Fare clic per aprire il file appena aggiunto dall'elenco Tutte le risorse.

  6. Nel campo della posizione per il browser web, copiare l'ID del dato che viene visualizzato tra i segmenti data-assets/ e /preview dell' URL e per la pagina corrente.

    Un esempio di ID di risorsa dati è 1e6591a2-c69d-4716-92e3-73e8c2270956.

    È possibile specificare questo ID di asset dati quando si fa riferimento al file dall'API.

    {
      "training_data_references": [
      {
        "type": "data_asset",
        "location": {
          "href": "/v2/assets/<asset_id>?project_id=<project_id>"
        }
      }
     ]
    }
    

Argomento principale: Estrazione di testo dai documenti