AssistantsClient class

Processamento de clientes assistente operações relacionadas com o .

Construtores

AssistantsClient(KeyCredential, AssistantsClientOptions)

Inicializa uma instância de AssistantsClient para utilização com o ponto final não Azure OpenAI.

AssistantsClient(string, KeyCredential, AssistantsClientOptions)

Inicializa uma instância de AssistantsClient para utilização com um recurso OpenAI.

AssistantsClient(string, TokenCredential, AssistantsClientOptions)

Inicializa uma instância de AssistantsClient para utilização com um recurso do Azure OpenAI.

Propriedades

pipeline

O pipeline utilizado por este cliente para fazer pedidos

Métodos

cancelRun(string, string, CancelRunOptions)

Cancela uma execução de um thread em curso.

createAssistant(AssistantCreationOptions, CreateAssistantOptions)

Cria uma nova assistente.

createAssistantFile(string, string, CreateAssistantFileOptions)

Anexa um ficheiro carregado anteriormente a um assistente para utilização por ferramentas que podem ler ficheiros.

createMessage(string, string, string, CreateMessageOptions)

Cria uma nova mensagem num thread especificado.

createRun(string, CreateRunOptions, CreateRunRequestOptions)

Cria uma nova execução para um thread de assistente.

createThread(AssistantThreadCreationOptions, CreateThreadOptions)

Cria um novo thread. Os threads contêm mensagens e podem ser executados por assistentes.

createThreadAndRun(CreateAndRunThreadOptions, CreateThreadAndRunOptions)

Cria um novo assistente thread e inicia imediatamente uma execução com esse novo thread.

deleteAssistant(string, DeleteAssistantOptions)

Elimina uma assistente.

deleteAssistantFile(string, string, DeleteAssistantFileOptions)

Desassocia um ficheiro previamente anexado de um assistente, tornando-o indisponível para utilização por ferramentas que podem ler ficheiros.

deleteFile(string, DeleteFileOptions)

Elimine um ficheiro carregado anteriormente.

deleteThread(string, DeleteThreadOptions)

Elimina um thread existente.

getAssistant(string, GetAssistantOptions)

Obtém uma assistente existente.

getAssistantFile(string, string, GetAssistantFileOptions)

Obtém um ficheiro anexado a um assistente.

getFile(string, GetFileOptions)

Devolve informações sobre um ficheiro específico. Não obtém conteúdo de ficheiro.

getMessage(string, string, GetMessageOptions)

Obtém uma mensagem existente a partir de um thread existente.

getMessageFile(string, string, string, GetMessageFileOptions)

Obtém informações sobre um anexo de ficheiro para uma mensagem dentro de um tópico.

getRun(string, string, GetRunOptions)

Obtém uma execução existente a partir de um thread existente.

getRunStep(string, string, string, GetRunStepOptions)

Obtém um único passo de execução de uma execução de thread.

getThread(string, GetThreadOptions)

Obtém informações sobre um thread existente.

listAssistantFiles(string, ListAssistantFilesOptions)

Obtém uma lista de ficheiros anexados a um assistente específico, conforme utilizado pelas ferramentas que podem ler ficheiros.

listAssistants(ListAssistantsOptions)

Obtém uma lista de assistentes que foram criados anteriormente.

listFiles(ListFilesOptions)

Obtém uma lista de ficheiros carregados anteriormente.

listMessageFiles(string, string, ListMessageFilesOptions)

Obtém uma lista de ficheiros carregados anteriormente associados a uma mensagem de um thread.

listMessages(string, ListMessagesOptions)

Obtém uma lista de mensagens que existem num tópico.

listRuns(string, ListRunsOptions)

Obtém uma lista de execuções para um thread especificado.

listRunSteps(string, string, ListRunStepsOptions)

Obtém uma lista de passos de execução de uma execução de thread.

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

Submete saídas de ferramentas, conforme pedido por chamadas de ferramentas numa execução. As execuções que precisam de saídas de ferramentas submetidas terão o estado "requires_action" com um required_action.tipo de "submit_tool_outputs".

updateAssistant(string, UpdateAssistantOptions, UpdateAssistantRequestOptions)

Modifica uma assistente existente.

updateMessage(string, string, UpdateMessageOptions)

Modifica uma mensagem existente num thread existente.

updateRun(string, string, UpdateRunOptions)

Modifica uma execução de thread existente.

updateThread(string, UpdateThreadOptions)

Modifica um thread existente.

uploadFile(Uint8Array, string, UploadFileOptions)

Carrega um ficheiro para utilização por outras operações.

Detalhes do Construtor

AssistantsClient(KeyCredential, AssistantsClientOptions)

Inicializa uma instância de AssistantsClient para utilização com o ponto final não Azure OpenAI.

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

Parâmetros

openAiApiKey
KeyCredential

A chave de API a utilizar ao ligar ao ponto final não Azure OpenAI.

options
AssistantsClientOptions

As opções para configurar o cliente.

Observações

AssistantsClient objects initialized with this constructor can only be used with the non-Azure OpenAI inference endpoint. Para utilizar AssistantsClient com um recurso do Azure OpenAI, utilize um construtor que aceite um URI de recurso e uma credencial de autenticação do Azure.

AssistantsClient(string, KeyCredential, AssistantsClientOptions)

Inicializa uma instância de AssistantsClient para utilização com um recurso OpenAI.

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

Parâmetros

endpoint

string

O URI de um recurso do Azure OpenAI, incluindo o protocolo e o nome do anfitrião. Por exemplo: https://my-resource.openai.azure.com.

credential
KeyCredential

Uma credencial de chave utilizada para autenticar num recurso do Azure OpenAI.

options
AssistantsClientOptions

As opções para configurar o cliente.

Observações

Este construtor inicializa um objeto AssistantsClient que só pode ser utilizado com recursos do Azure OpenAI. Para utilizar AssistantsClient com um ponto final de inferência não Azure OpenAI, utilize um construtor que aceite uma chave de API OpenAI que não seja do Azure.

AssistantsClient(string, TokenCredential, AssistantsClientOptions)

Inicializa uma instância de AssistantsClient para utilização com um recurso do Azure OpenAI.

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

Parâmetros

endpoint

string

O URI de um recurso do Azure OpenAI, incluindo o protocolo e o nome do anfitrião. Por exemplo: https://my-resource.openai.azure.com.

credential
TokenCredential

Uma credencial de token utilizada para autenticar com um recurso do Azure OpenAI.

options
AssistantsClientOptions

As opções para configurar o cliente.

Detalhes de Propriedade

pipeline

O pipeline utilizado por este cliente para fazer pedidos

pipeline: Pipeline

Valor de Propriedade

Detalhes de Método

cancelRun(string, string, CancelRunOptions)

Cancela uma execução de um thread em curso.

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

Parâmetros

threadId

string

runId

string

Devoluções

Promise<ThreadRun>

createAssistant(AssistantCreationOptions, CreateAssistantOptions)

Cria uma nova assistente.

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

Parâmetros

Devoluções

Promise<Assistant>

createAssistantFile(string, string, CreateAssistantFileOptions)

Anexa um ficheiro carregado anteriormente a um assistente para utilização por ferramentas que podem ler ficheiros.

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

Parâmetros

assistantId

string

fileId

string

Devoluções

Promise<AssistantFile>

createMessage(string, string, string, CreateMessageOptions)

Cria uma nova mensagem num thread especificado.

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

Parâmetros

threadId

string

role

string

content

string

Devoluções

Promise<ThreadMessage>

createRun(string, CreateRunOptions, CreateRunRequestOptions)

Cria uma nova execução para um thread de assistente.

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

Parâmetros

threadId

string

createRunOptions
CreateRunOptions

Devoluções

Promise<ThreadRun>

createThread(AssistantThreadCreationOptions, CreateThreadOptions)

Cria um novo thread. Os threads contêm mensagens e podem ser executados por assistentes.

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

Parâmetros

Devoluções

Promise<AssistantThread>

createThreadAndRun(CreateAndRunThreadOptions, CreateThreadAndRunOptions)

Cria um novo assistente thread e inicia imediatamente uma execução com esse novo thread.

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

Parâmetros

Devoluções

Promise<ThreadRun>

deleteAssistant(string, DeleteAssistantOptions)

Elimina uma assistente.

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

Parâmetros

assistantId

string

Devoluções

deleteAssistantFile(string, string, DeleteAssistantFileOptions)

Desassocia um ficheiro previamente anexado de um assistente, tornando-o indisponível para utilização por ferramentas que podem ler ficheiros.

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

Parâmetros

assistantId

string

fileId

string

Devoluções

deleteFile(string, DeleteFileOptions)

Elimine um ficheiro carregado anteriormente.

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

Parâmetros

fileId

string

Devoluções

deleteThread(string, DeleteThreadOptions)

Elimina um thread existente.

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

Parâmetros

threadId

string

Devoluções

getAssistant(string, GetAssistantOptions)

Obtém uma assistente existente.

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

Parâmetros

assistantId

string

Devoluções

Promise<Assistant>

getAssistantFile(string, string, GetAssistantFileOptions)

Obtém um ficheiro anexado a um assistente.

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

Parâmetros

assistantId

string

fileId

string

Devoluções

Promise<AssistantFile>

getFile(string, GetFileOptions)

Devolve informações sobre um ficheiro específico. Não obtém conteúdo de ficheiro.

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

Parâmetros

fileId

string

options
GetFileOptions

Devoluções

Promise<InputFile>

getMessage(string, string, GetMessageOptions)

Obtém uma mensagem existente a partir de um thread existente.

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

Parâmetros

threadId

string

messageId

string

Devoluções

Promise<ThreadMessage>

getMessageFile(string, string, string, GetMessageFileOptions)

Obtém informações sobre um anexo de ficheiro para uma mensagem dentro de um tópico.

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

Parâmetros

threadId

string

messageId

string

fileId

string

Devoluções

Promise<MessageFile>

getRun(string, string, GetRunOptions)

Obtém uma execução existente a partir de um thread existente.

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

Parâmetros

threadId

string

runId

string

options
GetRunOptions

Devoluções

Promise<ThreadRun>

getRunStep(string, string, string, GetRunStepOptions)

Obtém um único passo de execução de uma execução de thread.

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

Parâmetros

threadId

string

runId

string

stepId

string

Devoluções

Promise<RunStep>

getThread(string, GetThreadOptions)

Obtém informações sobre um thread existente.

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

Parâmetros

threadId

string

Devoluções

Promise<AssistantThread>

listAssistantFiles(string, ListAssistantFilesOptions)

Obtém uma lista de ficheiros anexados a um assistente específico, conforme utilizado pelas ferramentas que podem ler ficheiros.

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

Parâmetros

assistantId

string

Devoluções

listAssistants(ListAssistantsOptions)

Obtém uma lista de assistentes que foram criados anteriormente.

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

Parâmetros

Devoluções

listFiles(ListFilesOptions)

Obtém uma lista de ficheiros carregados anteriormente.

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

Parâmetros

Devoluções

Promise<FileListResponse>

listMessageFiles(string, string, ListMessageFilesOptions)

Obtém uma lista de ficheiros carregados anteriormente associados a uma mensagem de um thread.

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

Parâmetros

threadId

string

messageId

string

Devoluções

listMessages(string, ListMessagesOptions)

Obtém uma lista de mensagens que existem num tópico.

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

Parâmetros

threadId

string

Devoluções

listRuns(string, ListRunsOptions)

Obtém uma lista de execuções para um thread especificado.

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

Parâmetros

threadId

string

options
ListRunsOptions

Devoluções

listRunSteps(string, string, ListRunStepsOptions)

Obtém uma lista de passos de execução de uma execução de thread.

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

Parâmetros

threadId

string

runId

string

Devoluções

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

Submete saídas de ferramentas, conforme pedido por chamadas de ferramentas numa execução. As execuções que precisam de saídas de ferramentas submetidas terão o estado "requires_action" com um required_action.tipo de "submit_tool_outputs".

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

Parâmetros

threadId

string

runId

string

toolOutputs

ToolOutput[]

Devoluções

Promise<ThreadRun>

updateAssistant(string, UpdateAssistantOptions, UpdateAssistantRequestOptions)

Modifica uma assistente existente.

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

Parâmetros

assistantId

string

Devoluções

Promise<Assistant>

updateMessage(string, string, UpdateMessageOptions)

Modifica uma mensagem existente num thread existente.

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

Parâmetros

threadId

string

messageId

string

Devoluções

Promise<ThreadMessage>

updateRun(string, string, UpdateRunOptions)

Modifica uma execução de thread existente.

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

Parâmetros

threadId

string

runId

string

Devoluções

Promise<ThreadRun>

updateThread(string, UpdateThreadOptions)

Modifica um thread existente.

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

Parâmetros

threadId

string

Devoluções

Promise<AssistantThread>

uploadFile(Uint8Array, string, UploadFileOptions)

Carrega um ficheiro para utilização por outras operações.

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

Parâmetros

file

Uint8Array

purpose

string

Devoluções

Promise<InputFile>