Documentazione dell'infrastruttura Oracle Cloud

API batch file Vector Store

I batch di file della memoria di vettore consentono di gestire molti file contemporaneamente.

Nota

L'API batch di file di OCI Vector Store utilizza lo stesso formato dell'API batch di file di OpenAI Vector Store con l'endpoint compatibile con OCI OpenAI. Per i dettagli relativi alla sintassi e alle richieste, consulta la documentazione dell'API OpenAI Vector Store File Batch Batch.

Endpoint API supportato

URL di base Percorso endpoint Autenticazione
https://inference.generativeai.${region}.oci.oraclecloud.com/openai/v1 /vector_stores/{id}/file_batches 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 batch di file Vector Store

POST /vector_stores/{vector_store_id}/file_batches

Di riferimento

Crea batch di file della memoria di vettore

Esempio:

# create vector store file batch

vector_store_file_batch = client.vector_stores.file_batches.create(
  vector_store_id="xxx",
  files=[
    ...
)
print(vector_store_file_batch)

Lista di batch file Vector Store

GET /vector_stores/{vector_store_id}/file_batches

Di riferimento

Elenca batch di file della memoria di vettore

Esempio:

# list vector store file batches

vector_store_files = client.vector_stores.file_batches.list_files(
    vector_store_id="xxx"
    batch_id="xxx"
)
print(vector_store_files)

Recupero informazioni batch file area di memorizzazione vettore

GET /vector_stores/{vector_store_id}/file_batches/{batch_id}

Di riferimento

Recupera batch file memoria di vettore

Esempio:

# retrieve vector store file batch

vector_store_file_batch = client.vector_stores.file_batches.retrieve(
  vector_store_id="xxx",
  batch_id="xxx"
)
print(vector_store_file_batch)

Annullamento di un batch di file di Vector Store

POST /vector_stores/{vector_store_id}/file_batches/{batch_id}/cancel

Di riferimento

Annulla batch di file della memoria di vettore

Esempio:

# cancle a vector store file batch

canceled_vector_store_file_batch = client.vector_stores.file_batches.cancel(
    vector_store_id="xxx",
    file_id="xxx"
)
print(canceled_vector_store_file_batch)