Partager via


AssistantsClient class

Gestion du client assistant opérations liées.

Constructeurs

AssistantsClient(KeyCredential, AssistantsClientOptions)

Initialise une instance d’AssistantsClient pour une utilisation avec le point de terminaison OpenAI non Azure.

AssistantsClient(string, KeyCredential, AssistantsClientOptions)

Initialise un instance d’AssistantsClient pour une utilisation avec une ressource OpenAI.

AssistantsClient(string, TokenCredential, AssistantsClientOptions)

Initialise une instance d’AssistantsClient pour une utilisation avec une ressource Azure OpenAI.

Propriétés

pipeline

Pipeline utilisé par ce client pour effectuer des requêtes

Méthodes

cancelRun(string, string, CancelRunOptions)

Annule une exécution d’un thread en cours.

createAssistant(AssistantCreationOptions, CreateAssistantOptions)

Crée un assistant.

createAssistantFile(string, string, CreateAssistantFileOptions)

Joint un fichier précédemment chargé à un assistant à utiliser par des outils capables de lire des fichiers.

createMessage(string, string, string, CreateMessageOptions)

Crée un message sur un thread spécifié.

createRun(string, CreateRunOptions, CreateRunRequestOptions)

Crée une nouvelle exécution pour un thread assistant.

createThread(AssistantThreadCreationOptions, CreateThreadOptions)

Crée un thread. Les threads contiennent des messages et peuvent être exécutés par des assistants.

createThreadAndRun(CreateAndRunThreadOptions, CreateThreadAndRunOptions)

Crée un thread assistant et démarre immédiatement une exécution à l’aide de ce nouveau thread.

deleteAssistant(string, DeleteAssistantOptions)

Supprime un assistant.

deleteAssistantFile(string, string, DeleteAssistantFileOptions)

Dissocie un fichier précédemment attaché d’un assistant, le rendant indisponible pour une utilisation par les outils capables de lire des fichiers.

deleteFile(string, DeleteFileOptions)

Supprimez un fichier précédemment chargé.

deleteThread(string, DeleteThreadOptions)

Supprime un thread existant.

getAssistant(string, GetAssistantOptions)

Récupère un assistant existant.

getAssistantFile(string, string, GetAssistantFileOptions)

Récupère un fichier joint à un assistant.

getFile(string, GetFileOptions)

Retourne des informations sur un fichier spécifique. Ne récupère pas le contenu du fichier.

getMessage(string, string, GetMessageOptions)

Obtient un message existant à partir d’un thread existant.

getMessageFile(string, string, string, GetMessageFileOptions)

Obtient des informations sur une pièce jointe à un message dans un thread.

getRun(string, string, GetRunOptions)

Obtient une exécution existante à partir d’un thread existant.

getRunStep(string, string, string, GetRunStepOptions)

Obtient une seule étape d’exécution à partir d’une exécution de thread.

getThread(string, GetThreadOptions)

Obtient des informations sur un thread existant.

listAssistantFiles(string, ListAssistantFilesOptions)

Obtient la liste des fichiers joints à un assistant spécifique, tel qu’utilisé par les outils qui peuvent lire des fichiers.

listAssistants(ListAssistantsOptions)

Obtient la liste des assistants qui ont été créés précédemment.

listFiles(ListFilesOptions)

Obtient une liste des fichiers précédemment chargés.

listMessageFiles(string, string, ListMessageFilesOptions)

Obtient une liste des fichiers précédemment chargés associés à un message à partir d’un thread.

listMessages(string, ListMessagesOptions)

Obtient la liste des messages qui existent sur un thread.

listRuns(string, ListRunsOptions)

Obtient une liste d’exécutions pour un thread spécifié.

listRunSteps(string, string, ListRunStepsOptions)

Obtient la liste des étapes d’exécution d’une exécution de thread.

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

Envoie les sorties des outils comme demandé par les appels d’outils dans une exécution. Les exécutions qui nécessitent des sorties d’outil soumises auront un status de « requires_action » avec un required_action.type de « submit_tool_outputs ».

updateAssistant(string, UpdateAssistantOptions, UpdateAssistantRequestOptions)

Modifie un assistant existant.

updateMessage(string, string, UpdateMessageOptions)

Modifie un message existant sur un thread existant.

updateRun(string, string, UpdateRunOptions)

Modifie une exécution de thread existante.

updateThread(string, UpdateThreadOptions)

Modifie un thread existant.

uploadFile(Uint8Array, string, UploadFileOptions)

Charge un fichier à utiliser par d’autres opérations.

Détails du constructeur

AssistantsClient(KeyCredential, AssistantsClientOptions)

Initialise une instance d’AssistantsClient pour une utilisation avec le point de terminaison OpenAI non Azure.

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

Paramètres

openAiApiKey
KeyCredential

Clé API à utiliser lors de la connexion au point de terminaison OpenAI non Azure.

options
AssistantsClientOptions

Options de configuration du client.

Remarques

Les objets AssistantsClient initialisés avec ce constructeur ne peuvent être utilisés qu’avec le point de terminaison d’inférence OpenAI non Azure. Pour utiliser AssistantsClient avec une ressource Azure OpenAI, utilisez un constructeur qui accepte plutôt un URI de ressource et des informations d’identification d’authentification Azure.

AssistantsClient(string, KeyCredential, AssistantsClientOptions)

Initialise un instance d’AssistantsClient pour une utilisation avec une ressource OpenAI.

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

Paramètres

endpoint

string

URI d’une ressource Azure OpenAI, y compris le protocole et le nom d’hôte. Par exemple : https://my-resource.openai.azure.com.

credential
KeyCredential

Informations d’identification de clé utilisées pour l’authentification auprès d’une ressource Azure OpenAI.

options
AssistantsClientOptions

Options de configuration du client.

Remarques

Ce constructeur initialise un objet AssistantsClient qui ne peut être utilisé qu’avec des ressources Azure OpenAI. Pour utiliser AssistantsClient avec un point de terminaison d’inférence Non-Azure OpenAI, utilisez un constructeur qui accepte une clé d’API OpenAI non-Azure à la place.

AssistantsClient(string, TokenCredential, AssistantsClientOptions)

Initialise une instance d’AssistantsClient pour une utilisation avec une ressource Azure OpenAI.

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

Paramètres

endpoint

string

URI d’une ressource Azure OpenAI, y compris le protocole et le nom d’hôte. Par exemple : https://my-resource.openai.azure.com.

credential
TokenCredential

Informations d’identification de jeton utilisées pour l’authentification auprès d’une ressource Azure OpenAI.

options
AssistantsClientOptions

Options de configuration du client.

Détails de la propriété

pipeline

Pipeline utilisé par ce client pour effectuer des requêtes

pipeline: Pipeline

Valeur de propriété

Détails de la méthode

cancelRun(string, string, CancelRunOptions)

Annule une exécution d’un thread en cours.

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

Paramètres

threadId

string

runId

string

Retours

Promise<ThreadRun>

createAssistant(AssistantCreationOptions, CreateAssistantOptions)

Crée un assistant.

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

Paramètres

Retours

Promise<Assistant>

createAssistantFile(string, string, CreateAssistantFileOptions)

Joint un fichier précédemment chargé à un assistant à utiliser par des outils capables de lire des fichiers.

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

Paramètres

assistantId

string

fileId

string

Retours

Promise<AssistantFile>

createMessage(string, string, string, CreateMessageOptions)

Crée un message sur un thread spécifié.

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

Paramètres

threadId

string

role

string

content

string

Retours

Promise<ThreadMessage>

createRun(string, CreateRunOptions, CreateRunRequestOptions)

Crée une nouvelle exécution pour un thread assistant.

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

Paramètres

threadId

string

createRunOptions
CreateRunOptions

Retours

Promise<ThreadRun>

createThread(AssistantThreadCreationOptions, CreateThreadOptions)

Crée un thread. Les threads contiennent des messages et peuvent être exécutés par des assistants.

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

Paramètres

Retours

Promise<AssistantThread>

createThreadAndRun(CreateAndRunThreadOptions, CreateThreadAndRunOptions)

Crée un thread assistant et démarre immédiatement une exécution à l’aide de ce nouveau thread.

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

Paramètres

Retours

Promise<ThreadRun>

deleteAssistant(string, DeleteAssistantOptions)

Supprime un assistant.

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

Paramètres

assistantId

string

Retours

deleteAssistantFile(string, string, DeleteAssistantFileOptions)

Dissocie un fichier précédemment attaché d’un assistant, le rendant indisponible pour une utilisation par les outils capables de lire des fichiers.

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

Paramètres

assistantId

string

fileId

string

Retours

deleteFile(string, DeleteFileOptions)

Supprimez un fichier précédemment chargé.

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

Paramètres

fileId

string

Retours

deleteThread(string, DeleteThreadOptions)

Supprime un thread existant.

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

Paramètres

threadId

string

Retours

getAssistant(string, GetAssistantOptions)

Récupère un assistant existant.

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

Paramètres

assistantId

string

Retours

Promise<Assistant>

getAssistantFile(string, string, GetAssistantFileOptions)

Récupère un fichier joint à un assistant.

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

Paramètres

assistantId

string

fileId

string

Retours

Promise<AssistantFile>

getFile(string, GetFileOptions)

Retourne des informations sur un fichier spécifique. Ne récupère pas le contenu du fichier.

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

Paramètres

fileId

string

options
GetFileOptions

Retours

Promise<InputFile>

getMessage(string, string, GetMessageOptions)

Obtient un message existant à partir d’un thread existant.

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

Paramètres

threadId

string

messageId

string

Retours

Promise<ThreadMessage>

getMessageFile(string, string, string, GetMessageFileOptions)

Obtient des informations sur une pièce jointe à un message dans un thread.

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

Paramètres

threadId

string

messageId

string

fileId

string

Retours

Promise<MessageFile>

getRun(string, string, GetRunOptions)

Obtient une exécution existante à partir d’un thread existant.

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

Paramètres

threadId

string

runId

string

options
GetRunOptions

Retours

Promise<ThreadRun>

getRunStep(string, string, string, GetRunStepOptions)

Obtient une seule étape d’exécution à partir d’une exécution de thread.

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

Paramètres

threadId

string

runId

string

stepId

string

Retours

Promise<RunStep>

getThread(string, GetThreadOptions)

Obtient des informations sur un thread existant.

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

Paramètres

threadId

string

Retours

Promise<AssistantThread>

listAssistantFiles(string, ListAssistantFilesOptions)

Obtient la liste des fichiers joints à un assistant spécifique, tel qu’utilisé par les outils qui peuvent lire des fichiers.

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

Paramètres

assistantId

string

Retours

listAssistants(ListAssistantsOptions)

Obtient la liste des assistants qui ont été créés précédemment.

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

Paramètres

Retours

listFiles(ListFilesOptions)

Obtient une liste des fichiers précédemment chargés.

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

Paramètres

Retours

Promise<FileListResponse>

listMessageFiles(string, string, ListMessageFilesOptions)

Obtient une liste des fichiers précédemment chargés associés à un message à partir d’un thread.

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

Paramètres

threadId

string

messageId

string

Retours

listMessages(string, ListMessagesOptions)

Obtient la liste des messages qui existent sur un thread.

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

Paramètres

threadId

string

Retours

listRuns(string, ListRunsOptions)

Obtient une liste d’exécutions pour un thread spécifié.

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

Paramètres

threadId

string

options
ListRunsOptions

Retours

listRunSteps(string, string, ListRunStepsOptions)

Obtient la liste des étapes d’exécution d’une exécution de thread.

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

Paramètres

threadId

string

runId

string

Retours

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

Envoie les sorties des outils comme demandé par les appels d’outils dans une exécution. Les exécutions qui nécessitent des sorties d’outil soumises auront un status de « requires_action » avec un required_action.type de « submit_tool_outputs ».

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

Paramètres

threadId

string

runId

string

toolOutputs

ToolOutput[]

Retours

Promise<ThreadRun>

updateAssistant(string, UpdateAssistantOptions, UpdateAssistantRequestOptions)

Modifie un assistant existant.

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

Paramètres

assistantId

string

Retours

Promise<Assistant>

updateMessage(string, string, UpdateMessageOptions)

Modifie un message existant sur un thread existant.

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

Paramètres

threadId

string

messageId

string

Retours

Promise<ThreadMessage>

updateRun(string, string, UpdateRunOptions)

Modifie une exécution de thread existante.

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

Paramètres

threadId

string

runId

string

Retours

Promise<ThreadRun>

updateThread(string, UpdateThreadOptions)

Modifie un thread existant.

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

Paramètres

threadId

string

Retours

Promise<AssistantThread>

uploadFile(Uint8Array, string, UploadFileOptions)

Charge un fichier à utiliser par d’autres opérations.

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

Paramètres

file

Uint8Array

purpose

string

Retours

Promise<InputFile>