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.
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.
Authentification
Vous pouvez accéder aux points d'extrémité compatibles avec OCI OpenAI de deux façons :
- Clés d'API du service d'intelligence artificielle générative pour OCI
- Authentification basée sur OCI IAM
Utilisez des clés d'API pour les tests et le développement anticipé. Utiliser l'authentification basée sur IAM pour les charges de travail de production et les environnements OCI gérés.
Création d'un fichier conteneur
POST /containers/{container_id}/files
- Référence
-
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
-
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", )