0 / 0
Volver a la versión inglesa de la documentación

Añadir archivos a los que hacer referencia desde la API

Última actualización: 20 mar 2025
Añadir archivos a los que hacer referencia desde la API

Aprenda a agregar archivos a watsonx.ai al que desea hacer referencia mediante programación.

Para completar algunas tareas mediante programación, debe poder agregar archivos y hacer referencia a ellos desde la API. Por ejemplo, para ajustar un modelo de base mediante programación, debe proporcionar un archivo de datos de entrenamiento.

Puede añadir archivos creando uno de los siguientes tipos de activos:

  • activo de conexión
  • Activo de datos

Para obtener más información, consulte Referencias de datos en la documentación de IBM watsonx.ai como API de servicio.

Añadir archivos creando un activo de conexión desde la interfaz de usuario

Una forma de hacer que un archivo esté disponible es añadir el archivo a un nuevo bucket en la instancia de servicio IBM Cloud Object Storage que está asociada a su proyecto watsonx.ai. (Se le crea automáticamente una instancia de servicio IBM Cloud Object Storage cuando crea un proyecto watsonx.ai desde la interfaz de usuario)

Para añadir archivos creando un activo de conexión desde la interfaz de usuario del producto al que puede hacer referencia desde la API, siga estos pasos:

  1. Añade un bucket a la instancia IBM Cloud Object Storage asociada a tu proyecto watsonx.ai.

    En la Lista de recursos de IBM Cloud, expanda Almacenamiento y, a continuación, haga clic para abrir su instancia de servicio IBM Cloud Object Storage. Haz clic en Crear cubo.

  2. Añade un archivo al cubo.

    Desde la pestaña Objetos del cubo, sube el archivo.

  3. Para hacer referencia al archivo desde la API, debe crear una conexión a la instancia de servicio IBM Cloud Object Storage con el bucket donde se almacena el archivo.

    1. En el proyecto, seleccione Nuevo activo > Conectar a un origen de datos, elija IBM Cloud Object Storage y, a continuación, haga clic en Siguiente.

    2. Nombre del activo de conexión.

    3. Para los detalles de la conexión, añada la siguiente información:

      • El nombre del cubo que creó en el paso 1.

      • Para obtener el URL de inicio de sesión, abra el depósito en IBM Cloud Object Storage, haga clic en la pestaña Configuraciones y, a continuación, copie el punto de conexión público URL.

      • Para las credenciales, elija la opción de autenticación Clave de acceso y Clave secreta para conectarse a la fuente de datos. En la página de servicio principal de su instancia de servicio IBM Cloud Object Storage, haga clic en la pestaña Credenciales de servicio y, a continuación, busque la clave que desea utilizar y expándala para poder ver los detalles de la clave. La clave que utilices debe incluir una credencial HMAC. Si no tienes una clave existente con una credencial HMAC, crea una. Copie los siguientes valores para pegarlos en los campos correspondientes de la página de detalles del activo de conexión:

        Copiar del cubo Pegar en el activo de conexión
        access_key_id Clave de acceso
        secret_access_key Clave de secreto

      Para obtener más información sobre cómo crear una conexión a su instancia de servicio IBM Cloud Object Storage desde su proyecto watsonx.ai, consulte IBM Cloud Object Storage connection.

  4. Desde la página Activos de su proyecto, abra el activo de conexión de datos IBM Cloud Object Storage. En el URL de la página actual, copie el ID de conexión que se muestra después del segmento /connections/ del URL.

    Puede especificar este ID de conexión y otros detalles, como el nombre del depósito, cuando hace referencia al archivo desde la API.

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

Añadir archivos creando un activo de datos desde la interfaz de usuario

Para añadir archivos creando un activo de datos desde la interfaz de usuario del producto al que puede hacer referencia desde la API, siga estos pasos:

  1. En la página de resumen del proyecto, haga clic en el mosaico Añadir datos con los que trabajar.

  2. Haga clic en Archivo local y, a continuación, en Activo de datos.

  3. Haga clic en Examinar para buscar y seleccionar el archivo que desea cargar.

  4. Haga clic en Abrir y, a continuación, en Hecho.

  5. Haga clic para abrir el archivo que acaba de agregar de la lista Todos los activos.

  6. En el campo de ubicación del navegador web, copie el ID del activo de datos que se muestra entre los segmentos data-assets/ y /preview de la dirección URL de la página actual.

    Un ejemplo de ID de activo de datos es 1e6591a2-c69d-4716-92e3-73e8c2270956.

    Puede especificar este ID de activo de datos cuando haga referencia al archivo desde la API.

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

Tema principal: Extraer texto de documentos