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.

Remarque

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.

Conseil

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

Créer un fichier conteneur

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",
)