Documentation sur Oracle Cloud Infrastructure

API Fichiers

Vous pouvez utiliser l'API Fichiers pour charger et gérer en toute sécurité les documents et autres données que les agents peuvent utiliser lors de leur exécution.

En joignant des fichiers à des flux de travail tels que les tâches d'extraction et de récapitulation, les agents peuvent travailler avec des documents sources volumineux ou complexes sans avoir à coller le contenu dans des invites. Cela vous aide à créer des agents plus compétents qui peuvent utiliser les bases de connaissances, les rapports, les journaux et les jeux de données de manière évolutive et réutilisable, tout en assurant une gestion centralisée et cohérente des données.

Avertissement

Ce service ne vise pas à traiter des renseignements personnels ou des données (par exemple, certains renseignements réglementés sur la santé ou les cartes de paiement) qui imposent à Oracle des obligations particulières en matière de sécurité des données, de protection des données ou de réglementation, en plus de celles précisées dans votre entente avec Oracle.

Important

L'API Files utilise le même format que l'API Files OpenAI. Voir la documentation relative à l'API Files OpenAI.

Chargement d'un fichier

POST/files

Paramètres du corps
  • file (obligatoire) : Objet de fichier à charger
  • purpose (obligatoire) : Objectif du fichier. Valeurs prises en charge :
    • assistants
    • batch
    • fine-tune
    • vision
    • user_data
    • evals
  • expires_after (facultatif) : Politique d'expiration pour le fichier
Restrictions de type de fichier (par usage)
  • batch: .jsonl
  • fine-tune: .jsonl
  • evals: .jsonl
  • vision: .gif, .jpeg, .jpg, .png, .webp

Exemple :

# 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)

Liste des fichiers

GET/files

Paramètres d'entrée
  • after (facultatif) : Curseur à utiliser dans la pagination
  • limit (facultatif) : Nombre d'objets à retourner
  • order (facultatif) : Ordre de tri par created_at ("asc" ou "desc")
  • purpose (facultatif) : Filtrer les fichiers par objectif

Exemple :

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

Extraction des informations sur le fichier

GET/files/{file_id}

Paramètre d'entrée
  • file_id (obligatoire) : ID du fichier à extraire

Exemple :

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

Extraction du contenu du fichier

GET/files/{file_id}/content

Paramètre d'entrée
  • file_id (obligatoire) : ID du fichier dont vous voulez extraire le contenu

Exemple :

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

Supprimer un fichier

DELETE/files/{file_id}

Paramètre d'entrée
  • file_id (obligatoire) : ID du fichier à supprimer

Exemple :

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