Condividi tramite


AssistantsClient class

Gestione client assistente operazioni correlate.

Costruttori

AssistantsClient(KeyCredential, AssistantsClientOptions)

Inizializza un'istanza di AssistantsClient da usare con l'endpoint OpenAI non di Azure.

AssistantsClient(string, KeyCredential, AssistantsClientOptions)

Inizializza un'istanza di AssistantsClient da usare con una risorsa OpenAI.

AssistantsClient(string, TokenCredential, AssistantsClientOptions)

Inizializza un'istanza di AssistantsClient da usare con una risorsa OpenAI di Azure.

Proprietà

pipeline

Pipeline usata da questo client per effettuare richieste

Metodi

cancelRun(string, string, CancelRunOptions)

Annulla un'esecuzione di un thread in corso.

createAssistant(AssistantCreationOptions, CreateAssistantOptions)

Crea una nuova assistente.

createAssistantFile(string, string, CreateAssistantFileOptions)

Collega un file caricato in precedenza a un assistente da usare dagli strumenti che possono leggere i file.

createMessage(string, string, string, CreateMessageOptions)

Crea un nuovo messaggio in un thread specificato.

createRun(string, CreateRunOptions, CreateRunRequestOptions)

Crea una nuova esecuzione per un thread assistente.

createThread(AssistantThreadCreationOptions, CreateThreadOptions)

Crea un nuovo thread. I thread contengono messaggi e possono essere eseguiti da assistenti.

createThreadAndRun(CreateAndRunThreadOptions, CreateThreadAndRunOptions)

Crea un nuovo thread assistente e avvia immediatamente un'esecuzione usando tale nuovo thread.

deleteAssistant(string, DeleteAssistantOptions)

Elimina un assistente.

deleteAssistantFile(string, string, DeleteAssistantFileOptions)

Scollega un file collegato in precedenza da un assistente, rendendolo non disponibile per l'uso da parte di strumenti che possono leggere i file.

deleteFile(string, DeleteFileOptions)

Eliminare un file caricato in precedenza.

deleteThread(string, DeleteThreadOptions)

Elimina un thread esistente.

getAssistant(string, GetAssistantOptions)

Recupera un assistente esistente.

getAssistantFile(string, string, GetAssistantFileOptions)

Recupera un file collegato a un assistente.

getFile(string, GetFileOptions)

Restituisce informazioni su un file specifico. Non recupera il contenuto del file.

getMessage(string, string, GetMessageOptions)

Ottiene un messaggio esistente da un thread esistente.

getMessageFile(string, string, string, GetMessageFileOptions)

Ottiene informazioni su un allegato di file a un messaggio all'interno di un thread.

getRun(string, string, GetRunOptions)

Ottiene un'esecuzione esistente da un thread esistente.

getRunStep(string, string, string, GetRunStepOptions)

Ottiene un singolo passaggio di esecuzione da un thread eseguito.

getThread(string, GetThreadOptions)

Ottiene informazioni su un thread esistente.

listAssistantFiles(string, ListAssistantFilesOptions)

Ottiene un elenco di file collegati a un assistente specifico, come usato dagli strumenti che possono leggere i file.

listAssistants(ListAssistantsOptions)

Ottiene un elenco di assistenti creati in precedenza.

listFiles(ListFilesOptions)

Ottiene un elenco di file caricati in precedenza.

listMessageFiles(string, string, ListMessageFilesOptions)

Ottiene un elenco di file caricati in precedenza associati a un messaggio da un thread.

listMessages(string, ListMessagesOptions)

Ottiene un elenco di messaggi esistenti in un thread.

listRuns(string, ListRunsOptions)

Ottiene un elenco di esecuzioni per un thread specificato.

listRunSteps(string, string, ListRunStepsOptions)

Ottiene un elenco di passaggi di esecuzione da un'esecuzione di thread.

submitToolOutputsToRun(string, string, ToolOutput[], SubmitToolOutputsToRunOptions)

Invia output dagli strumenti richiesti dalle chiamate degli strumenti in un'esecuzione. Le esecuzioni necessarie per gli output degli strumenti inviati avranno uno stato "requires_action" con un required_action.tipo di "submit_tool_outputs".

updateAssistant(string, UpdateAssistantOptions, UpdateAssistantRequestOptions)

Modifica un assistente esistente.

updateMessage(string, string, UpdateMessageOptions)

Modifica un messaggio esistente in un thread esistente.

updateRun(string, string, UpdateRunOptions)

Modifica un'esecuzione di thread esistente.

updateThread(string, UpdateThreadOptions)

Modifica un thread esistente.

uploadFile(Uint8Array, string, UploadFileOptions)

Carica un file da usare da altre operazioni.

Dettagli costruttore

AssistantsClient(KeyCredential, AssistantsClientOptions)

Inizializza un'istanza di AssistantsClient da usare con l'endpoint OpenAI non di Azure.

new AssistantsClient(openAiApiKey: KeyCredential, options?: AssistantsClientOptions)

Parametri

openAiApiKey
KeyCredential

Chiave API da usare per la connessione all'endpoint OpenAI non di Azure.

options
AssistantsClientOptions

Opzioni per la configurazione del client.

Commenti

Gli oggetti AssistantsClient inizializzati con questo costruttore possono essere usati solo con l'endpoint di inferenza non Azure OpenAI. Per usare AssistantsClient con una risorsa OpenAI di Azure, usare un costruttore che accetta invece un URI di risorsa e credenziali di autenticazione di Azure.

AssistantsClient(string, KeyCredential, AssistantsClientOptions)

Inizializza un'istanza di AssistantsClient da usare con una risorsa OpenAI.

new AssistantsClient(endpoint: string, credential: KeyCredential, options?: AssistantsClientOptions)

Parametri

endpoint

string

URI per una risorsa OpenAI di Azure, incluso il protocollo e il nome host. Ad esempio: https://my-resource.openai.azure.com.

credential
KeyCredential

Credenziali chiave usate per l'autenticazione in una risorsa OpenAI di Azure.

options
AssistantsClientOptions

Opzioni per la configurazione del client.

Commenti

Questo costruttore inizializza un oggetto AssistantsClient che può essere usato solo con le risorse OpenAI di Azure. Per usare AssistantsClient con un endpoint di inferenza non Azure OpenAI, usare invece un costruttore che accetta una chiave API non Azure OpenAI.

AssistantsClient(string, TokenCredential, AssistantsClientOptions)

Inizializza un'istanza di AssistantsClient da usare con una risorsa OpenAI di Azure.

new AssistantsClient(endpoint: string, credential: TokenCredential, options?: AssistantsClientOptions)

Parametri

endpoint

string

URI per una risorsa OpenAI di Azure, incluso il protocollo e il nome host. Ad esempio: https://my-resource.openai.azure.com.

credential
TokenCredential

Credenziali del token usate per l'autenticazione con una risorsa OpenAI di Azure.

options
AssistantsClientOptions

Opzioni per la configurazione del client.

Dettagli proprietà

pipeline

Pipeline usata da questo client per effettuare richieste

pipeline: Pipeline

Valore della proprietà

Dettagli metodo

cancelRun(string, string, CancelRunOptions)

Annulla un'esecuzione di un thread in corso.

function cancelRun(threadId: string, runId: string, options?: CancelRunOptions): Promise<ThreadRun>

Parametri

threadId

string

runId

string

Restituisce

Promise<ThreadRun>

createAssistant(AssistantCreationOptions, CreateAssistantOptions)

Crea una nuova assistente.

function createAssistant(body: AssistantCreationOptions, options?: CreateAssistantOptions): Promise<Assistant>

Parametri

Restituisce

Promise<Assistant>

createAssistantFile(string, string, CreateAssistantFileOptions)

Collega un file caricato in precedenza a un assistente da usare dagli strumenti che possono leggere i file.

function createAssistantFile(assistantId: string, fileId: string, options?: CreateAssistantFileOptions): Promise<AssistantFile>

Parametri

assistantId

string

fileId

string

Restituisce

Promise<AssistantFile>

createMessage(string, string, string, CreateMessageOptions)

Crea un nuovo messaggio in un thread specificato.

function createMessage(threadId: string, role: string, content: string, options?: CreateMessageOptions): Promise<ThreadMessage>

Parametri

threadId

string

role

string

content

string

Restituisce

Promise<ThreadMessage>

createRun(string, CreateRunOptions, CreateRunRequestOptions)

Crea una nuova esecuzione per un thread assistente.

function createRun(threadId: string, createRunOptions: CreateRunOptions, options?: CreateRunRequestOptions): Promise<ThreadRun>

Parametri

threadId

string

createRunOptions
CreateRunOptions

Restituisce

Promise<ThreadRun>

createThread(AssistantThreadCreationOptions, CreateThreadOptions)

Crea un nuovo thread. I thread contengono messaggi e possono essere eseguiti da assistenti.

function createThread(body?: AssistantThreadCreationOptions, options?: CreateThreadOptions): Promise<AssistantThread>

Parametri

Restituisce

Promise<AssistantThread>

createThreadAndRun(CreateAndRunThreadOptions, CreateThreadAndRunOptions)

Crea un nuovo thread assistente e avvia immediatamente un'esecuzione usando tale nuovo thread.

function createThreadAndRun(body: CreateAndRunThreadOptions, options?: CreateThreadAndRunOptions): Promise<ThreadRun>

Parametri

Restituisce

Promise<ThreadRun>

deleteAssistant(string, DeleteAssistantOptions)

Elimina un assistente.

function deleteAssistant(assistantId: string, options?: DeleteAssistantOptions): Promise<AssistantDeletionStatus>

Parametri

assistantId

string

Restituisce

deleteAssistantFile(string, string, DeleteAssistantFileOptions)

Scollega un file collegato in precedenza da un assistente, rendendolo non disponibile per l'uso da parte di strumenti che possono leggere i file.

function deleteAssistantFile(assistantId: string, fileId: string, options?: DeleteAssistantFileOptions): Promise<AssistantFileDeletionStatus>

Parametri

assistantId

string

fileId

string

Restituisce

deleteFile(string, DeleteFileOptions)

Eliminare un file caricato in precedenza.

function deleteFile(fileId: string, options?: DeleteFileOptions): Promise<FileDeletionStatus>

Parametri

fileId

string

Restituisce

deleteThread(string, DeleteThreadOptions)

Elimina un thread esistente.

function deleteThread(threadId: string, options?: DeleteThreadOptions): Promise<ThreadDeletionStatus>

Parametri

threadId

string

Restituisce

getAssistant(string, GetAssistantOptions)

Recupera un assistente esistente.

function getAssistant(assistantId: string, options?: GetAssistantOptions): Promise<Assistant>

Parametri

assistantId

string

Restituisce

Promise<Assistant>

getAssistantFile(string, string, GetAssistantFileOptions)

Recupera un file collegato a un assistente.

function getAssistantFile(assistantId: string, fileId: string, options?: GetAssistantFileOptions): Promise<AssistantFile>

Parametri

assistantId

string

fileId

string

Restituisce

Promise<AssistantFile>

getFile(string, GetFileOptions)

Restituisce informazioni su un file specifico. Non recupera il contenuto del file.

function getFile(fileId: string, options?: GetFileOptions): Promise<InputFile>

Parametri

fileId

string

options
GetFileOptions

Restituisce

Promise<InputFile>

getMessage(string, string, GetMessageOptions)

Ottiene un messaggio esistente da un thread esistente.

function getMessage(threadId: string, messageId: string, options?: GetMessageOptions): Promise<ThreadMessage>

Parametri

threadId

string

messageId

string

Restituisce

Promise<ThreadMessage>

getMessageFile(string, string, string, GetMessageFileOptions)

Ottiene informazioni su un allegato di file a un messaggio all'interno di un thread.

function getMessageFile(threadId: string, messageId: string, fileId: string, options?: GetMessageFileOptions): Promise<MessageFile>

Parametri

threadId

string

messageId

string

fileId

string

Restituisce

Promise<MessageFile>

getRun(string, string, GetRunOptions)

Ottiene un'esecuzione esistente da un thread esistente.

function getRun(threadId: string, runId: string, options?: GetRunOptions): Promise<ThreadRun>

Parametri

threadId

string

runId

string

options
GetRunOptions

Restituisce

Promise<ThreadRun>

getRunStep(string, string, string, GetRunStepOptions)

Ottiene un singolo passaggio di esecuzione da un thread eseguito.

function getRunStep(threadId: string, runId: string, stepId: string, options?: GetRunStepOptions): Promise<RunStep>

Parametri

threadId

string

runId

string

stepId

string

Restituisce

Promise<RunStep>

getThread(string, GetThreadOptions)

Ottiene informazioni su un thread esistente.

function getThread(threadId: string, options?: GetThreadOptions): Promise<AssistantThread>

Parametri

threadId

string

Restituisce

Promise<AssistantThread>

listAssistantFiles(string, ListAssistantFilesOptions)

Ottiene un elenco di file collegati a un assistente specifico, come usato dagli strumenti che possono leggere i file.

function listAssistantFiles(assistantId: string, options?: ListAssistantFilesOptions): Promise<ListResponseOf<AssistantFile>>

Parametri

assistantId

string

Restituisce

listAssistants(ListAssistantsOptions)

Ottiene un elenco di assistenti creati in precedenza.

function listAssistants(options?: ListAssistantsOptions): Promise<ListResponseOf<Assistant>>

Parametri

Restituisce

listFiles(ListFilesOptions)

Ottiene un elenco di file caricati in precedenza.

function listFiles(options?: ListFilesOptions): Promise<FileListResponse>

Parametri

Restituisce

Promise<FileListResponse>

listMessageFiles(string, string, ListMessageFilesOptions)

Ottiene un elenco di file caricati in precedenza associati a un messaggio da un thread.

function listMessageFiles(threadId: string, messageId: string, options?: ListMessageFilesOptions): Promise<ListResponseOf<MessageFile>>

Parametri

threadId

string

messageId

string

Restituisce

listMessages(string, ListMessagesOptions)

Ottiene un elenco di messaggi esistenti in un thread.

function listMessages(threadId: string, options?: ListMessagesOptions): Promise<ListResponseOf<ThreadMessage>>

Parametri

threadId

string

Restituisce

listRuns(string, ListRunsOptions)

Ottiene un elenco di esecuzioni per un thread specificato.

function listRuns(threadId: string, options?: ListRunsOptions): Promise<ListResponseOf<ThreadRun>>

Parametri

threadId

string

options
ListRunsOptions

Restituisce

listRunSteps(string, string, ListRunStepsOptions)

Ottiene un elenco di passaggi di esecuzione da un'esecuzione di thread.

function listRunSteps(threadId: string, runId: string, options?: ListRunStepsOptions): Promise<ListResponseOf<RunStep>>

Parametri

threadId

string

runId

string

Restituisce

submitToolOutputsToRun(string, string, ToolOutput[], SubmitToolOutputsToRunOptions)

Invia output dagli strumenti richiesti dalle chiamate degli strumenti in un'esecuzione. Le esecuzioni necessarie per gli output degli strumenti inviati avranno uno stato "requires_action" con un required_action.tipo di "submit_tool_outputs".

function submitToolOutputsToRun(threadId: string, runId: string, toolOutputs: ToolOutput[], options?: SubmitToolOutputsToRunOptions): Promise<ThreadRun>

Parametri

threadId

string

runId

string

toolOutputs

ToolOutput[]

Restituisce

Promise<ThreadRun>

updateAssistant(string, UpdateAssistantOptions, UpdateAssistantRequestOptions)

Modifica un assistente esistente.

function updateAssistant(assistantId: string, body: UpdateAssistantOptions, options?: UpdateAssistantRequestOptions): Promise<Assistant>

Parametri

assistantId

string

Restituisce

Promise<Assistant>

updateMessage(string, string, UpdateMessageOptions)

Modifica un messaggio esistente in un thread esistente.

function updateMessage(threadId: string, messageId: string, options?: UpdateMessageOptions): Promise<ThreadMessage>

Parametri

threadId

string

messageId

string

Restituisce

Promise<ThreadMessage>

updateRun(string, string, UpdateRunOptions)

Modifica un'esecuzione di thread esistente.

function updateRun(threadId: string, runId: string, options?: UpdateRunOptions): Promise<ThreadRun>

Parametri

threadId

string

runId

string

Restituisce

Promise<ThreadRun>

updateThread(string, UpdateThreadOptions)

Modifica un thread esistente.

function updateThread(threadId: string, options?: UpdateThreadOptions): Promise<AssistantThread>

Parametri

threadId

string

Restituisce

Promise<AssistantThread>

uploadFile(Uint8Array, string, UploadFileOptions)

Carica un file da usare da altre operazioni.

function uploadFile(file: Uint8Array, purpose: string, options?: UploadFileOptions): Promise<InputFile>

Parametri

file

Uint8Array

purpose

string

Restituisce

Promise<InputFile>