AssistantsClient class
Gestione client assistente operazioni correlate.
Costruttori
Assistants |
Inizializza un'istanza di AssistantsClient da usare con l'endpoint OpenAI non di Azure. |
Assistants |
Inizializza un'istanza di AssistantsClient da usare con una risorsa OpenAI. |
Assistants |
Inizializza un'istanza di AssistantsClient da usare con una risorsa OpenAI di Azure. |
Proprietà
pipeline | Pipeline usata da questo client per effettuare richieste |
Metodi
cancel |
Annulla un'esecuzione di un thread in corso. |
create |
Crea una nuova assistente. |
create |
Collega un file caricato in precedenza a un assistente da usare dagli strumenti che possono leggere i file. |
create |
Crea un nuovo messaggio in un thread specificato. |
create |
Crea una nuova esecuzione per un thread assistente. |
create |
Crea un nuovo thread. I thread contengono messaggi e possono essere eseguiti da assistenti. |
create |
Crea un nuovo thread assistente e avvia immediatamente un'esecuzione usando tale nuovo thread. |
delete |
Elimina un assistente. |
delete |
Scollega un file collegato in precedenza da un assistente, rendendolo non disponibile per l'uso da parte di strumenti che possono leggere i file. |
delete |
Eliminare un file caricato in precedenza. |
delete |
Elimina un thread esistente. |
get |
Recupera un assistente esistente. |
get |
Recupera un file collegato a un assistente. |
get |
Restituisce informazioni su un file specifico. Non recupera il contenuto del file. |
get |
Ottiene un messaggio esistente da un thread esistente. |
get |
Ottiene informazioni su un allegato di file a un messaggio all'interno di un thread. |
get |
Ottiene un'esecuzione esistente da un thread esistente. |
get |
Ottiene un singolo passaggio di esecuzione da un thread eseguito. |
get |
Ottiene informazioni su un thread esistente. |
list |
Ottiene un elenco di file collegati a un assistente specifico, come usato dagli strumenti che possono leggere i file. |
list |
Ottiene un elenco di assistenti creati in precedenza. |
list |
Ottiene un elenco di file caricati in precedenza. |
list |
Ottiene un elenco di file caricati in precedenza associati a un messaggio da un thread. |
list |
Ottiene un elenco di messaggi esistenti in un thread. |
list |
Ottiene un elenco di esecuzioni per un thread specificato. |
list |
Ottiene un elenco di passaggi di esecuzione da un'esecuzione di thread. |
submit |
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". |
update |
Modifica un assistente esistente. |
update |
Modifica un messaggio esistente in un thread esistente. |
update |
Modifica un'esecuzione di thread esistente. |
update |
Modifica un thread esistente. |
upload |
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
- options
- CancelRunOptions
Restituisce
Promise<ThreadRun>
createAssistant(AssistantCreationOptions, CreateAssistantOptions)
Crea una nuova assistente.
function createAssistant(body: AssistantCreationOptions, options?: CreateAssistantOptions): Promise<Assistant>
Parametri
- options
- CreateAssistantOptions
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
- options
- CreateAssistantFileOptions
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
- options
- CreateMessageOptions
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
- options
- CreateRunRequestOptions
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
- options
- CreateThreadOptions
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
- options
- CreateThreadAndRunOptions
Restituisce
Promise<ThreadRun>
deleteAssistant(string, DeleteAssistantOptions)
Elimina un assistente.
function deleteAssistant(assistantId: string, options?: DeleteAssistantOptions): Promise<AssistantDeletionStatus>
Parametri
- assistantId
-
string
- options
- DeleteAssistantOptions
Restituisce
Promise<AssistantDeletionStatus>
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
- options
- DeleteAssistantFileOptions
Restituisce
Promise<AssistantFileDeletionStatus>
deleteFile(string, DeleteFileOptions)
Eliminare un file caricato in precedenza.
function deleteFile(fileId: string, options?: DeleteFileOptions): Promise<FileDeletionStatus>
Parametri
- fileId
-
string
- options
- DeleteFileOptions
Restituisce
Promise<FileDeletionStatus>
deleteThread(string, DeleteThreadOptions)
Elimina un thread esistente.
function deleteThread(threadId: string, options?: DeleteThreadOptions): Promise<ThreadDeletionStatus>
Parametri
- threadId
-
string
- options
- DeleteThreadOptions
Restituisce
Promise<ThreadDeletionStatus>
getAssistant(string, GetAssistantOptions)
Recupera un assistente esistente.
function getAssistant(assistantId: string, options?: GetAssistantOptions): Promise<Assistant>
Parametri
- assistantId
-
string
- options
- GetAssistantOptions
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
- options
- GetAssistantFileOptions
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
- options
- GetMessageOptions
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
- options
- GetMessageFileOptions
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
- options
- GetRunStepOptions
Restituisce
Promise<RunStep>
getThread(string, GetThreadOptions)
Ottiene informazioni su un thread esistente.
function getThread(threadId: string, options?: GetThreadOptions): Promise<AssistantThread>
Parametri
- threadId
-
string
- options
- GetThreadOptions
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
- options
- ListAssistantFilesOptions
Restituisce
Promise<ListResponseOf<AssistantFile>>
listAssistants(ListAssistantsOptions)
Ottiene un elenco di assistenti creati in precedenza.
function listAssistants(options?: ListAssistantsOptions): Promise<ListResponseOf<Assistant>>
Parametri
- options
- ListAssistantsOptions
Restituisce
Promise<ListResponseOf<Assistant>>
listFiles(ListFilesOptions)
Ottiene un elenco di file caricati in precedenza.
function listFiles(options?: ListFilesOptions): Promise<FileListResponse>
Parametri
- options
- ListFilesOptions
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
- options
- ListMessageFilesOptions
Restituisce
Promise<ListResponseOf<MessageFile>>
listMessages(string, ListMessagesOptions)
Ottiene un elenco di messaggi esistenti in un thread.
function listMessages(threadId: string, options?: ListMessagesOptions): Promise<ListResponseOf<ThreadMessage>>
Parametri
- threadId
-
string
- options
- ListMessagesOptions
Restituisce
Promise<ListResponseOf<ThreadMessage>>
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
Promise<ListResponseOf<ThreadRun>>
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
- options
- ListRunStepsOptions
Restituisce
Promise<ListResponseOf<RunStep>>
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
- options
- SubmitToolOutputsToRunOptions
Restituisce
Promise<ThreadRun>
updateAssistant(string, UpdateAssistantOptions, UpdateAssistantRequestOptions)
Modifica un assistente esistente.
function updateAssistant(assistantId: string, body: UpdateAssistantOptions, options?: UpdateAssistantRequestOptions): Promise<Assistant>
Parametri
- assistantId
-
string
- options
- UpdateAssistantRequestOptions
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
- options
- UpdateMessageOptions
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
- options
- UpdateRunOptions
Restituisce
Promise<ThreadRun>
updateThread(string, UpdateThreadOptions)
Modifica un thread esistente.
function updateThread(threadId: string, options?: UpdateThreadOptions): Promise<AssistantThread>
Parametri
- threadId
-
string
- options
- UpdateThreadOptions
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
- options
- UploadFileOptions
Restituisce
Promise<InputFile>
Azure SDK for JavaScript