Documentazione dell'infrastruttura Oracle Cloud

API Container Files

L'utente o gli agenti possono utilizzare l'API Containers per caricare, rendere persistenti e recuperare i file all'interno di un ambiente contenitore sicuro e in sandbox.

Questo file system localizzato mantiene i set di dati e gli output generati (ad esempio grafici o log) disponibili in diversi passaggi di un'attività, consentendo flussi di lavoro in più fasi e scambi di dati programmatici senza passare manualmente il contenuto tra i passi.

Nota

L'API OCI Container Files utilizza lo stesso formato dell'API OpenAI Container Files con l'endpoint OCI compatibile con OpenAI. Per i dettagli di sintassi e richiesta, consulta la documentazione API OpenAI Container Files.

Endpoint API supportato

URL di base Percorso endpoint Autenticazione
https://inference.generativeai.${region}.oci.oraclecloud.com/openai/v1 /containers/{id}/files Chiave API o sessione IAM

Sostituire ${region} con un'area OCI supportata come us-chicago-1.

Sebbene il formato della richiesta sia compatibile con OpenAI, l'autenticazione utilizza le credenziali OCI, le richieste vengono instradate tramite gli endpoint di inferenza OCI Generative AI e le risorse e l'esecuzione rimangono in OCI.

Suggerimento

Per i passi da eseguire prima di utilizzare questa interfaccia API, vedere QuickStart.

Autenticazione

È possibile accedere agli endpoint compatibili con OCI OpenAI in due modi:

Utilizza le API key per test e sviluppo precoce. Utilizza l'autenticazione basata su IAM per i carichi di lavoro di produzione e gli ambienti gestiti da OCI.

Creazione di un file contenitore

POST /containers/{container_id}/files

Di riferimento

Crea file contenitore

Esempio:

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

Lista dei file contenitore

GET /containers/{container_id}/files

Di riferimento

Elenca file contenitore

Esempio:

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

Recupero delle informazioni sul file contenitore

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

Di riferimento

Recupera file contenitore

Esempio:

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

Eliminazione di un file contenitore

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

Di riferimento

Elimina file contenitore

Esempio:

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