Compartir a través de


AssistantsClient class

Control de clientes asistente operaciones relacionadas.

Constructores

AssistantsClient(KeyCredential, AssistantsClientOptions)

Inicializa una instancia de AssistantsClient para su uso con el punto de conexión de OpenAI que no es de Azure.

AssistantsClient(string, KeyCredential, AssistantsClientOptions)

Inicializa una instancia de AssistantsClient para su uso con un recurso openAI.

AssistantsClient(string, TokenCredential, AssistantsClientOptions)

Inicializa una instancia de AssistantsClient para su uso con un recurso de Azure OpenAI.

Propiedades

pipeline

Canalización usada por este cliente para realizar solicitudes

Métodos

cancelRun(string, string, CancelRunOptions)

Cancela una ejecución de un subproceso en curso.

createAssistant(AssistantCreationOptions, CreateAssistantOptions)

Crea un nuevo asistente.

createAssistantFile(string, string, CreateAssistantFileOptions)

Adjunta un archivo cargado previamente a un asistente para que lo usen las herramientas que pueden leer archivos.

createMessage(string, string, string, CreateMessageOptions)

Crea un nuevo mensaje en un subproceso especificado.

createRun(string, CreateRunOptions, CreateRunRequestOptions)

Crea una nueva ejecución para un subproceso de asistente.

createThread(AssistantThreadCreationOptions, CreateThreadOptions)

Crea un subproceso. Los subprocesos contienen mensajes y los asistentes pueden ejecutarlos.

createThreadAndRun(CreateAndRunThreadOptions, CreateThreadAndRunOptions)

Crea un nuevo subproceso de asistente e inicia inmediatamente una ejecución con ese nuevo subproceso.

deleteAssistant(string, DeleteAssistantOptions)

Elimina un asistente.

deleteAssistantFile(string, string, DeleteAssistantFileOptions)

Desvincula un archivo adjunto previamente de un asistente, lo que lo representa para que lo usen las herramientas que pueden leer archivos.

deleteFile(string, DeleteFileOptions)

Elimine un archivo cargado anteriormente.

deleteThread(string, DeleteThreadOptions)

Elimina un subproceso existente.

getAssistant(string, GetAssistantOptions)

Recupera un asistente existente.

getAssistantFile(string, string, GetAssistantFileOptions)

Recupera un archivo adjunto a un asistente.

getFile(string, GetFileOptions)

Devuelve información sobre un archivo específico. No recupera el contenido del archivo.

getMessage(string, string, GetMessageOptions)

Obtiene un mensaje existente de un subproceso existente.

getMessageFile(string, string, string, GetMessageFileOptions)

Obtiene información sobre los datos adjuntos de un archivo a un mensaje dentro de un subproceso.

getRun(string, string, GetRunOptions)

Obtiene una ejecución existente desde un subproceso existente.

getRunStep(string, string, string, GetRunStepOptions)

Obtiene un solo paso de ejecución de una ejecución de una ejecución de subprocesos.

getThread(string, GetThreadOptions)

Obtiene información sobre un subproceso existente.

listAssistantFiles(string, ListAssistantFilesOptions)

Obtiene una lista de archivos adjuntos a un asistente específico, tal como lo usan las herramientas que pueden leer archivos.

listAssistants(ListAssistantsOptions)

Obtiene una lista de asistentes creados anteriormente.

listFiles(ListFilesOptions)

Obtiene una lista de archivos cargados previamente.

listMessageFiles(string, string, ListMessageFilesOptions)

Obtiene una lista de archivos cargados previamente asociados a un mensaje de un subproceso.

listMessages(string, ListMessagesOptions)

Obtiene una lista de mensajes que existen en un subproceso.

listRuns(string, ListRunsOptions)

Obtiene una lista de ejecuciones para un subproceso especificado.

listRunSteps(string, string, ListRunStepsOptions)

Obtiene una lista de pasos de ejecución de una ejecución de subprocesos.

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

Envía salidas de las herramientas solicitadas por las llamadas de herramienta en una ejecución. Las ejecuciones que necesitan salidas de herramienta enviadas tendrán el estado "requires_action" con un required_action.type de "submit_tool_outputs".

updateAssistant(string, UpdateAssistantOptions, UpdateAssistantRequestOptions)

Modifica un asistente existente.

updateMessage(string, string, UpdateMessageOptions)

Modifica un mensaje existente en un subproceso existente.

updateRun(string, string, UpdateRunOptions)

Modifica una ejecución de subproceso existente.

updateThread(string, UpdateThreadOptions)

Modifica un subproceso existente.

uploadFile(Uint8Array, string, UploadFileOptions)

Carga un archivo para que lo usen otras operaciones.

Detalles del constructor

AssistantsClient(KeyCredential, AssistantsClientOptions)

Inicializa una instancia de AssistantsClient para su uso con el punto de conexión de OpenAI que no es de Azure.

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

Parámetros

openAiApiKey
KeyCredential

Clave de API que se va a usar al conectarse al punto de conexión de OpenAI que no es de Azure.

options
AssistantsClientOptions

Opciones para configurar el cliente.

Comentarios

Los objetos AssistantsClient inicializados con este constructor solo se pueden usar con el punto de conexión de inferencia de OpenAI que no es de Azure. Para usar AssistantsClient con un recurso de Azure OpenAI, use un constructor que acepte un URI de recurso y una credencial de autenticación de Azure en su lugar.

AssistantsClient(string, KeyCredential, AssistantsClientOptions)

Inicializa una instancia de AssistantsClient para su uso con un recurso openAI.

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

Parámetros

endpoint

string

El URI de un recurso de Azure OpenAI, incluido el protocolo y el nombre de host. Por ejemplo: https://my-resource.openai.azure.com.

credential
KeyCredential

Una credencial de clave que se usa para autenticarse en un recurso de Azure OpenAI.

options
AssistantsClientOptions

Opciones para configurar el cliente.

Comentarios

Este constructor inicializa un objeto AssistantsClient que solo se puede usar con recursos de Azure OpenAI. Para usar AssistantsClient con un punto de conexión de inferencia de OpenAI que no sea de Azure, use un constructor que acepte una clave de API openAI que no sea de Azure.

AssistantsClient(string, TokenCredential, AssistantsClientOptions)

Inicializa una instancia de AssistantsClient para su uso con un recurso de Azure OpenAI.

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

Parámetros

endpoint

string

El URI de un recurso de Azure OpenAI, incluido el protocolo y el nombre de host. Por ejemplo: https://my-resource.openai.azure.com.

credential
TokenCredential

Una credencial de token que se usa para autenticarse con un recurso de Azure OpenAI.

options
AssistantsClientOptions

Opciones para configurar el cliente.

Detalles de las propiedades

pipeline

Canalización usada por este cliente para realizar solicitudes

pipeline: Pipeline

Valor de propiedad

Detalles del método

cancelRun(string, string, CancelRunOptions)

Cancela una ejecución de un subproceso en curso.

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

Parámetros

threadId

string

runId

string

Devoluciones

Promise<ThreadRun>

createAssistant(AssistantCreationOptions, CreateAssistantOptions)

Crea un nuevo asistente.

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

Parámetros

Devoluciones

Promise<Assistant>

createAssistantFile(string, string, CreateAssistantFileOptions)

Adjunta un archivo cargado previamente a un asistente para que lo usen las herramientas que pueden leer archivos.

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

Parámetros

assistantId

string

fileId

string

Devoluciones

Promise<AssistantFile>

createMessage(string, string, string, CreateMessageOptions)

Crea un nuevo mensaje en un subproceso especificado.

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

Parámetros

threadId

string

role

string

content

string

Devoluciones

Promise<ThreadMessage>

createRun(string, CreateRunOptions, CreateRunRequestOptions)

Crea una nueva ejecución para un subproceso de asistente.

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

Parámetros

threadId

string

createRunOptions
CreateRunOptions

Devoluciones

Promise<ThreadRun>

createThread(AssistantThreadCreationOptions, CreateThreadOptions)

Crea un subproceso. Los subprocesos contienen mensajes y los asistentes pueden ejecutarlos.

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

Parámetros

Devoluciones

Promise<AssistantThread>

createThreadAndRun(CreateAndRunThreadOptions, CreateThreadAndRunOptions)

Crea un nuevo subproceso de asistente e inicia inmediatamente una ejecución con ese nuevo subproceso.

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

Parámetros

Devoluciones

Promise<ThreadRun>

deleteAssistant(string, DeleteAssistantOptions)

Elimina un asistente.

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

Parámetros

assistantId

string

Devoluciones

deleteAssistantFile(string, string, DeleteAssistantFileOptions)

Desvincula un archivo adjunto previamente de un asistente, lo que lo representa para que lo usen las herramientas que pueden leer archivos.

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

Parámetros

assistantId

string

fileId

string

Devoluciones

deleteFile(string, DeleteFileOptions)

Elimine un archivo cargado anteriormente.

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

Parámetros

fileId

string

Devoluciones

deleteThread(string, DeleteThreadOptions)

Elimina un subproceso existente.

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

Parámetros

threadId

string

Devoluciones

getAssistant(string, GetAssistantOptions)

Recupera un asistente existente.

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

Parámetros

assistantId

string

Devoluciones

Promise<Assistant>

getAssistantFile(string, string, GetAssistantFileOptions)

Recupera un archivo adjunto a un asistente.

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

Parámetros

assistantId

string

fileId

string

Devoluciones

Promise<AssistantFile>

getFile(string, GetFileOptions)

Devuelve información sobre un archivo específico. No recupera el contenido del archivo.

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

Parámetros

fileId

string

options
GetFileOptions

Devoluciones

Promise<InputFile>

getMessage(string, string, GetMessageOptions)

Obtiene un mensaje existente de un subproceso existente.

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

Parámetros

threadId

string

messageId

string

Devoluciones

Promise<ThreadMessage>

getMessageFile(string, string, string, GetMessageFileOptions)

Obtiene información sobre los datos adjuntos de un archivo a un mensaje dentro de un subproceso.

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

Parámetros

threadId

string

messageId

string

fileId

string

Devoluciones

Promise<MessageFile>

getRun(string, string, GetRunOptions)

Obtiene una ejecución existente desde un subproceso existente.

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

Parámetros

threadId

string

runId

string

options
GetRunOptions

Devoluciones

Promise<ThreadRun>

getRunStep(string, string, string, GetRunStepOptions)

Obtiene un solo paso de ejecución de una ejecución de una ejecución de subprocesos.

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

Parámetros

threadId

string

runId

string

stepId

string

Devoluciones

Promise<RunStep>

getThread(string, GetThreadOptions)

Obtiene información sobre un subproceso existente.

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

Parámetros

threadId

string

Devoluciones

Promise<AssistantThread>

listAssistantFiles(string, ListAssistantFilesOptions)

Obtiene una lista de archivos adjuntos a un asistente específico, tal como lo usan las herramientas que pueden leer archivos.

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

Parámetros

assistantId

string

Devoluciones

listAssistants(ListAssistantsOptions)

Obtiene una lista de asistentes creados anteriormente.

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

Parámetros

Devoluciones

listFiles(ListFilesOptions)

Obtiene una lista de archivos cargados previamente.

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

Parámetros

Devoluciones

Promise<FileListResponse>

listMessageFiles(string, string, ListMessageFilesOptions)

Obtiene una lista de archivos cargados previamente asociados a un mensaje de un subproceso.

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

Parámetros

threadId

string

messageId

string

Devoluciones

listMessages(string, ListMessagesOptions)

Obtiene una lista de mensajes que existen en un subproceso.

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

Parámetros

threadId

string

Devoluciones

listRuns(string, ListRunsOptions)

Obtiene una lista de ejecuciones para un subproceso especificado.

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

Parámetros

threadId

string

options
ListRunsOptions

Devoluciones

listRunSteps(string, string, ListRunStepsOptions)

Obtiene una lista de pasos de ejecución de una ejecución de subprocesos.

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

Parámetros

threadId

string

runId

string

Devoluciones

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

Envía salidas de las herramientas solicitadas por las llamadas de herramienta en una ejecución. Las ejecuciones que necesitan salidas de herramienta enviadas tendrán el estado "requires_action" con un required_action.type de "submit_tool_outputs".

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

Parámetros

threadId

string

runId

string

toolOutputs

ToolOutput[]

Devoluciones

Promise<ThreadRun>

updateAssistant(string, UpdateAssistantOptions, UpdateAssistantRequestOptions)

Modifica un asistente existente.

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

Parámetros

assistantId

string

Devoluciones

Promise<Assistant>

updateMessage(string, string, UpdateMessageOptions)

Modifica un mensaje existente en un subproceso existente.

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

Parámetros

threadId

string

messageId

string

Devoluciones

Promise<ThreadMessage>

updateRun(string, string, UpdateRunOptions)

Modifica una ejecución de subproceso existente.

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

Parámetros

threadId

string

runId

string

Devoluciones

Promise<ThreadRun>

updateThread(string, UpdateThreadOptions)

Modifica un subproceso existente.

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

Parámetros

threadId

string

Devoluciones

Promise<AssistantThread>

uploadFile(Uint8Array, string, UploadFileOptions)

Carga un archivo para que lo usen otras operaciones.

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

Parámetros

file

Uint8Array

purpose

string

Devoluciones

Promise<InputFile>