Documentation Oracle Cloud Infrastructure

API de fichiers

Vous pouvez utiliser l'API Files pour télécharger et gérer en toute sécurité des documents et d'autres données que les agents peuvent utiliser pendant leur exécution.

En joignant des fichiers à des workflows tels que l'extraction et la synthèse des tâches, les agents peuvent travailler avec des matériaux source volumineux ou complexes sans que vous ayez à coller du 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 gardant la gestion des données centralisée et cohérente.

Avertissement

Ce service n'a pas pour objet le traitement de données à caractère personnel ni de données (par exemple, certaines informations réglementées sur la santé ou sur les cartes de paiement) qui imposent à Oracle des obligations spécifiques en matière de sécurité, de protection des données ou de réglementation s'ajoutant à celles indiquées dans votre contrat avec Oracle ou qui diffèrent de celles-ci.

Important

L'API Files utilise le même format que l'API OpenAI Files. Reportez-vous à la documentation de l'API des fichiers OpenAI.

Chargement d'un fichier

POST/files

Paramètres du corps
  • file (obligatoire) : objet de fichier à télécharger
  • purpose (requis) : objet du fichier. Valeurs prises en charge :
    • assistants
    • batch
    • fine-tune
    • vision
    • user_data
    • evals
  • expires_after (facultatif) : stratégie d'expiration du fichier
Restrictions de type de fichier (par objectif)
  • batch: .jsonl
  • fine-tune: .jsonl
  • evals: .jsonl
  • vision: .gif, .jpeg, .jpg, .png, .webp

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

Répertorier les fichiers

GET/files

Paramètres d'entrée
  • after (facultatif) : curseur à utiliser dans la pagination
  • limit (facultatif) : nombre d'objets à renvoyer
  • order (facultatif) : tri par created_at ("asc" ou "desc")
  • purpose (facultatif) : filtre les fichiers par fonction

Par 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

Par 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

Par exemple :

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

Suppression d'un fichier

DELETE/files/{file_id}

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

Par exemple :

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