API de fichiers conteneur

Vous ou les agents pouvez utiliser l'API Containers pour charger, conserver et extraire des fichiers dans un environnement de conteneur sécurisé avec bac à sable.

Ce système de fichiers localisé conserve les jeux de données et les sorties générées (telles que les graphiques ou les journaux) disponibles sur plusieurs étapes d'une tâche, ce qui permet des flux de travail en plusieurs étapes transparents et un échange de données programmatique sans transmettre manuellement le contenu entre les étapes.

Note

L'API Container Files d'OCI utilise le même format que l'API Container Files d'OpenAI avec le point d'extrémité compatible OCI OpenAI. Pour plus de détails sur la syntaxe et les demandes, consultez la documentation relative à l'API OpenAI Container Files.

Point d'extrémité d'API pris en charge

URL de base Chemin du point d'extrémité Authentification
https://inference.generativeai.${region}.oci.oraclecloud.com/openai/v1 /containers/{id}/files Clé d'API ou session IAM

Remplacez ${region} par une région OCI prise en charge telle que us-chicago-1.

Bien que le format de la demande soit compatible avec OpenAI, l'authentification utilise les données d'identification OCI, les demandes sont acheminées au moyen des points d'extrémité d'inférence du service d'intelligence artificielle générative pour OCI et les ressources et l'exécution restent dans OCI.

Conseil

Pour les étapes à effectuer avant d'utiliser cette API, voir QuickStart.

Création d'un fichier conteneur

POST /containers/{container_id}/files

Référence

Créer un fichier conteneur

Exemple :

# create container file
container_file = client.containers.files.create(
    container_id="container_id",
    file=open("data.csv", "rb"),
)
print(container_file.id)

Liste des fichiers de conteneur

GET /containers/{container_id}/files

Référence

Lister les fichiers de conteneur

Exemple :

# list container files
page = client.containers.files.list(
    container_id="container_id",
)
page = page.data[0]
print(page.id)

Extraction des informations sur le fichier de conteneur

GET /containers/{container_id}/files/{file_id}

Référence

Extraire le fichier conteneur

Exemple :

# retrieve container file content
content = client.containers.files.content.retrieve(
    file_id="file_id",
    container_id="container_id",
)
print(content)
data = content.read()
print(data)

Suppression d'un fichier de conteneur

DELETE /containers/{container_id}/files/{file_id}

Référence

Supprimer le fichier conteneur

Exemple :

# delete container file
client.containers.files.delete(
    file_id="file_id",
    container_id="container_id",
)