API Container Files
Les agents ou vous-même pouvez utiliser l'API Containers pour télécharger, rendre persistants et extraire des fichiers dans un environnement de conteneur sécurisé en environnement de simulation.
Ce système de fichiers localisé maintient les jeux de données et les sorties générées (comme les graphiques ou les journaux) disponibles en plusieurs étapes d'une tâche, ce qui permet des workflows multi-étapes transparents et un échange de données programmatiques sans transmettre manuellement le contenu entre les étapes.
L'API OCI Container Files utilise le même format que l'API OpenAI Container Files avec l'adresse compatible OCI OpenAI. Pour plus d'informations sur la syntaxe et les demandes, reportez-vous à la documentation de l'API OpenAI Container Files.
Adresse d'API prise en charge
| URL de base | Chemin de l'adresse | 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 demande soit compatible avec OpenAI, l'authentification utilise les informations d'identification OCI, les demandes sont acheminées via les adresses d'inférence OCI Generative AI et les ressources et l'exécution restent dans OCI.
Pour connaître les étapes à effectuer avant d'utiliser cette API, reportez-vous à Démarrage rapide.
Authentification
Vous pouvez accéder aux adresses compatibles avec OCI OpenAI de deux manières :
Utiliser des clés d'API pour les tests et le développement anticipé. Utilisez l'authentification basée sur IAM pour les workloads de production et les environnements gérés par OCI.
Création d'un fichier conteneur
POST /containers/{container_id}/files
- Référence
-
Par 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
-
Répertorier les fichiers de conteneur
Par exemple :
# list container files page = client.containers.files.list( container_id="container_id", ) page = page.data[0] print(page.id)
Récupération des informations sur le fichier conteneur
GET /containers/{container_id}/files/{file_id}
- Référence
-
Récupérer le fichier conteneur
Par 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 conteneur
DELETE /containers/{container_id}/files/{file_id}
- Référence
-
Supprimer le fichier conteneur
Par exemple :
# delete container file client.containers.files.delete( file_id="file_id", container_id="container_id", )