Documentación de Oracle Cloud Infrastructure

API de archivos

Puede utilizar la API de archivos para cargar y gestionar de forma segura documentos y otros datos que los agentes pueden utilizar mientras se ejecutan.

Al adjuntar archivos a flujos de trabajo como tareas de recuperación y resumen, los agentes pueden trabajar con materiales de origen grandes o complejos sin tener que pegar contenido en peticiones de datos. Esto le ayuda a crear agentes más capaces que puedan utilizar bases de conocimientos, informes, logs y conjuntos de datos de una manera escalable y reutilizable, al tiempo que mantiene el manejo de datos centralizado y coherente.

Advertencia

Este servicio no pretende procesar información personal ni ningún dato (por ejemplo, determinados datos sanitarios regulados o información sobre tarjetas de pago) que imponga a Oracle obligaciones normativas, de seguridad o protección de datos específicas además de las especificadas en su acuerdo con Oracle o distintas de estas.

Importante

La API de archivos utiliza el mismo formato que la API de archivos OpenAI. Consulte la OpenAI documentación de la API de archivos.

Carga de un archivo

POST/files

Parámetros del cuerpo
  • file (necesario): objeto de archivo que se va a cargar
  • purpose (necesario): finalidad del archivo. Valores soportados:
    • assistants
    • batch
    • fine-tune
    • vision
    • user_data
    • evals
  • expires_after (opcional): política de caducidad para el archivo
Restricciones de tipo de archivo (por finalidad)
  • batch: .jsonl
  • fine-tune: .jsonl
  • evals: .jsonl
  • vision: .gif, .jpeg, .jpg, .png, .webp

Ejemplo:

# upload files

file_path = "./demo_file.pdf"
with open(file_path, "rb") as f:
    file = client.files.create(
        file=f,
        purpose="user_data"
    )
    print(file)

Listado de archivos

GET/files

Parámetros de Entrada
  • after (opcional): cursor para su uso en la paginación
  • limit (opcional): número de objetos que se van a devolver
  • order (opcional): Ordenar por created_at ("asc" o "desc")
  • purpose (opcional): filtre los archivos por finalidad

Ejemplo:

# list files
files_list = client.files.list(order="asc")
print(files_list)

Recuperación de Información de Archivo

GET/files/{file_id}

Parámetro de Entrada
  • file_id (necesario): ID del archivo que se va a recuperar

Ejemplo:

# retrieve file
file = client.files.retrieve(file_id="file-fra-d5dd80c5-da8c-435e-b336-48ce9b346200")
print(file)

Recuperación de contenido de archivo

GET/files/{file_id}/content

Parámetro de Entrada
  • file_id (necesario): ID del archivo cuyo contenido desea recuperar

Ejemplo:

# retrieve file content
file = client.files.content(file_id="file-fra-d5dd80c5-da8c-435e-b336-48ce9b346200")
print(file.content)

Supresión de un archivo

DELETE/files/{file_id}

Parámetro de Entrada
  • file_id (necesario): ID del archivo que se va a suprimir

Ejemplo:

# delete file
delete_result = client.files.delete(file_id="file-xxx")
print(delete_result)