Oracle Cloud Infrastructure-Dokumentation

Datei-API

Mit der Files-API können Sie Dokumente und andere Daten, die Agents während der Ausführung verwenden können, sicher hochladen und verwalten.

Durch das Anhängen von Dateien an Workflows wie das Abrufen und Zusammenfassen von Aufgaben können Agents mit großen oder komplexen Quellmaterialien arbeiten, ohne dass Sie Inhalt in Prompts einfügen müssen. Auf diese Weise können Sie leistungsfähigere Agents erstellen, die Wissensdatenbanken, Berichte, Protokolle und Datasets skalierbar und wiederverwendbar verwenden können. Gleichzeitig bleibt die Datenverarbeitung zentral und konsistent.

Warnung

Dieser Service ist nicht dazu bestimmt, personenbezogene Daten oder Daten (z. B. bestimmte regulierte Gesundheits- oder Zahlungskartendaten) zu verarbeiten, die Oracle spezifische Datensicherheits-, Datenschutz- oder regulatorische Verpflichtungen auferlegen, die über die in Ihrem Vertrag mit Oracle festgelegten Verpflichtungen hinausgehen oder von diesen abweichen.

Wichtig

Die Dateien-API verwendet dasselbe Format wie die OpenAI-Dateien-API. Siehe Dokumentation zur OpenAI-Dateien-API.

Datei wird hochgeladen

POST/files

Textparameter
  • file (erforderlich): Hochzuladendes Dateiobjekt
  • purpose (erforderlich): Der beabsichtigte Zweck der Datei. Unterstützte Werte:
    • assistants
    • batch
    • fine-tune
    • vision
    • user_data
    • evals
  • expires_after (optional): Ablauf-Policy für die Datei
Dateitypbeschränkungen (nach Zweck)
  • batch: .jsonl
  • fine-tune: .jsonl
  • evals: .jsonl
  • vision: .gif, .jpeg, .jpg, .png, .webp

Beispiel:

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

Auflisten von Dateien

GET/files

Eingabeparameter
  • after (optional): Cursor für Paginierung
  • limit (optional): Anzahl der zurückzugebenden Objekte
  • order (optional): Sortierreihenfolge nach created_at ("asc" oder "desc")
  • purpose (optional): Dateien nach Zweck filtern

Beispiel:

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

Dateiinformationen werden abgerufen

GET/files/{file_id}

Eingabeparameter
  • file_id (erforderlich): ID der abgerufenen Datei

Beispiel:

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

Dateiinhalt wird abgerufen

GET/files/{file_id}/content

Eingabeparameter
  • file_id (erforderlich): ID der Datei, deren Inhalt Sie abrufen möchten

Beispiel:

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

Datei wird gelöscht

DELETE/files/{file_id}

Eingabeparameter
  • file_id (erforderlich): ID der zu löschenden Datei

Beispiel:

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