AssistantsClient class
Processamento de clientes assistente operações relacionadas com o .
Construtores
Assistants |
Inicializa uma instância de AssistantsClient para utilização com o ponto final não Azure OpenAI. |
Assistants |
Inicializa uma instância de AssistantsClient para utilização com um recurso OpenAI. |
Assistants |
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
cancel |
Cancela uma execução de um thread em curso. |
create |
Cria uma nova assistente. |
create |
Anexa um ficheiro carregado anteriormente a um assistente para utilização por ferramentas que podem ler ficheiros. |
create |
Cria uma nova mensagem num thread especificado. |
create |
Cria uma nova execução para um thread de assistente. |
create |
Cria um novo thread. Os threads contêm mensagens e podem ser executados por assistentes. |
create |
Cria um novo assistente thread e inicia imediatamente uma execução com esse novo thread. |
delete |
Elimina uma assistente. |
delete |
Desassocia um ficheiro previamente anexado de um assistente, tornando-o indisponível para utilização por ferramentas que podem ler ficheiros. |
delete |
Elimine um ficheiro carregado anteriormente. |
delete |
Elimina um thread existente. |
get |
Obtém uma assistente existente. |
get |
Obtém um ficheiro anexado a um assistente. |
get |
Devolve informações sobre um ficheiro específico. Não obtém conteúdo de ficheiro. |
get |
Obtém uma mensagem existente a partir de um thread existente. |
get |
Obtém informações sobre um anexo de ficheiro para uma mensagem dentro de um tópico. |
get |
Obtém uma execução existente a partir de um thread existente. |
get |
Obtém um único passo de execução de uma execução de thread. |
get |
Obtém informações sobre um thread existente. |
list |
Obtém uma lista de ficheiros anexados a um assistente específico, conforme utilizado pelas ferramentas que podem ler ficheiros. |
list |
Obtém uma lista de assistentes que foram criados anteriormente. |
list |
Obtém uma lista de ficheiros carregados anteriormente. |
list |
Obtém uma lista de ficheiros carregados anteriormente associados a uma mensagem de um thread. |
list |
Obtém uma lista de mensagens que existem num tópico. |
list |
Obtém uma lista de execuções para um thread especificado. |
list |
Obtém uma lista de passos de execução de uma execução de thread. |
submit |
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". |
update |
Modifica uma assistente existente. |
update |
Modifica uma mensagem existente num thread existente. |
update |
Modifica uma execução de thread existente. |
update |
Modifica um thread existente. |
upload |
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
- options
- CancelRunOptions
Devoluções
Promise<ThreadRun>
createAssistant(AssistantCreationOptions, CreateAssistantOptions)
Cria uma nova assistente.
function createAssistant(body: AssistantCreationOptions, options?: CreateAssistantOptions): Promise<Assistant>
Parâmetros
- options
- CreateAssistantOptions
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
- options
- CreateAssistantFileOptions
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
- options
- CreateMessageOptions
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
- options
- CreateRunRequestOptions
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
- options
- CreateThreadOptions
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
- options
- CreateThreadAndRunOptions
Devoluções
Promise<ThreadRun>
deleteAssistant(string, DeleteAssistantOptions)
Elimina uma assistente.
function deleteAssistant(assistantId: string, options?: DeleteAssistantOptions): Promise<AssistantDeletionStatus>
Parâmetros
- assistantId
-
string
- options
- DeleteAssistantOptions
Devoluções
Promise<AssistantDeletionStatus>
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
- options
- DeleteAssistantFileOptions
Devoluções
Promise<AssistantFileDeletionStatus>
deleteFile(string, DeleteFileOptions)
Elimine um ficheiro carregado anteriormente.
function deleteFile(fileId: string, options?: DeleteFileOptions): Promise<FileDeletionStatus>
Parâmetros
- fileId
-
string
- options
- DeleteFileOptions
Devoluções
Promise<FileDeletionStatus>
deleteThread(string, DeleteThreadOptions)
Elimina um thread existente.
function deleteThread(threadId: string, options?: DeleteThreadOptions): Promise<ThreadDeletionStatus>
Parâmetros
- threadId
-
string
- options
- DeleteThreadOptions
Devoluções
Promise<ThreadDeletionStatus>
getAssistant(string, GetAssistantOptions)
Obtém uma assistente existente.
function getAssistant(assistantId: string, options?: GetAssistantOptions): Promise<Assistant>
Parâmetros
- assistantId
-
string
- options
- GetAssistantOptions
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
- options
- GetAssistantFileOptions
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
- options
- GetMessageOptions
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
- options
- GetMessageFileOptions
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
- options
- GetRunStepOptions
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
- options
- GetThreadOptions
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
- options
- ListAssistantFilesOptions
Devoluções
Promise<ListResponseOf<AssistantFile>>
listAssistants(ListAssistantsOptions)
Obtém uma lista de assistentes que foram criados anteriormente.
function listAssistants(options?: ListAssistantsOptions): Promise<ListResponseOf<Assistant>>
Parâmetros
- options
- ListAssistantsOptions
Devoluções
Promise<ListResponseOf<Assistant>>
listFiles(ListFilesOptions)
Obtém uma lista de ficheiros carregados anteriormente.
function listFiles(options?: ListFilesOptions): Promise<FileListResponse>
Parâmetros
- options
- ListFilesOptions
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
- options
- ListMessageFilesOptions
Devoluções
Promise<ListResponseOf<MessageFile>>
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
- options
- ListMessagesOptions
Devoluções
Promise<ListResponseOf<ThreadMessage>>
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
Promise<ListResponseOf<ThreadRun>>
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
- options
- ListRunStepsOptions
Devoluções
Promise<ListResponseOf<RunStep>>
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
- options
- SubmitToolOutputsToRunOptions
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
- options
- UpdateAssistantRequestOptions
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
- options
- UpdateMessageOptions
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
- options
- UpdateRunOptions
Devoluções
Promise<ThreadRun>
updateThread(string, UpdateThreadOptions)
Modifica um thread existente.
function updateThread(threadId: string, options?: UpdateThreadOptions): Promise<AssistantThread>
Parâmetros
- threadId
-
string
- options
- UpdateThreadOptions
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
- options
- UploadFileOptions
Devoluções
Promise<InputFile>
Azure SDK for JavaScript