Partilhar via

Assistentes OpenAI (Editora Independente) (Pré-visualização)

OpenAI Assistants permite que você construa assistentes de IA dentro de seus próprios aplicativos. Um Assistente tem instruções e pode aproveitar modelos, ferramentas e conhecimento para responder às consultas dos usuários. Atualmente, o serviço Assistentes suporta três tipos de ferramentas: Interpretador de Código, Recuperação e Chamada de Função.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Troia Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Metadados do conector
Editora Troia Taylor
Sítio Web https://openai.com/
Política de privacidade https://openai.com/policies/privacy-policy
Categorias IA

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Chave API (no formato 'Portador $OPENAI_API_KEY') securestring A chave da API (no formato 'Portador $OPENAI_API_KEY') para esta api Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Assistente de exclusão

Exclui um assistente.
Assistente de recuperação

Recupera informações sobre um assistente.
Cancelar uma execução

Cancele uma execução para um thread que está em andamento.
Comece a correr

Recupere uma execução de um thread.
Criar arquivo de assistente

Crie um arquivo de assistente anexando um arquivo a um assistente.
Criar assistente

Crie um assistente com um modelo e instruções.
Criar execução

Cria uma execução para um thread.
Criar mensagem

Crie uma mensagem dentro de um thread.
Criar thread

Cria um thread com o qual os assistentes podem interagir.
Criar thread e executar

Cria um thread e o executa em uma solicitação.
Enviar saídas da ferramenta para execução

Quando uma execução tem o status: "requires_action" e required_action.type é submit_tool_outputs, essa ação pode ser usada para enviar as saídas das chamadas da ferramenta assim que todas forem concluídas.
Excluir arquivo do assistente

Exclui um arquivo de assistente.
Excluir thread

Exclui um thread.
Execuções de lista

Recupere uma lista de execuções para um thread.
Listar arquivos de mensagem

Recupera uma lista de arquivos de mensagem para um thread.
Listar assistentes

Recupera uma lista de assistentes.
Listar etapas de execução

Recupere uma lista de etapas de execução para um thread.
Listar mensagens

Recupere uma lista de mensagens para um determinado thread.
Listar modelos

Lista os modelos atualmente disponíveis e fornece informações básicas sobre cada um, como o proprietário e a disponibilidade.
Modificar execução

Modifica uma execução para um thread.
Modificar mensagem

Modifica uma mensagem.
Modificar um thread

Modifica um thread.
Obter arquivos do assistente

Recupera uma lista de arquivos do assistente.
Obter etapa de execução

Recupere uma etapa de execução para um thread.
Obter thread

Recuperar um thread.
Recuperar arquivo de mensagem

Recupera um arquivo de mensagem de um thread.
Recuperar arquivo do assistente

Recupera um arquivo de assistente.

Assistente de exclusão

ID da Operação:
AssistantDelete

Exclui um assistente.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
ID do assistente
 assistant_id True string

O identificador do assistente.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Suprimido
 deleted boolean

Se excluído.

Assistente de recuperação

ID da Operação:
AssistantGet

Recupera informações sobre um assistente.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
ID do assistente
 assistant_id True string

O identificador do assistente.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
Nome
 name string

O nome.
Description
 description string

A descrição.
Modelo
 model string

O modelo.
Instruções
 instructions string

As instruções.
Tools
 tools array of object
Tipo
 tools.type string

O tipo de ferramentas.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.

Cancelar uma execução

ID da Operação:
RunCancelPost

Cancele uma execução para um thread que está em andamento.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
ID de execução
 run_id True string

O identificador de execução.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
ID do assistente
 assistant_id string

O identificador do assistente.
Thread ID
 thread_id string

O identificador de thread.
Situação
 status string

O status.
Começou em
 started_at integer

Quando iniciado em.
Expira em
 expires_at integer

Quando expira em.
Cancelado em
 cancelled_at string

Quando cancelado em.
Falhou em
 failed_at string

Quando falhou em.
Concluído em
 completed_at string

Quando concluído em.
Último erro
 last_error string

O último erro.
Modelo
 model string

O modelo.
Instruções
 instructions string

As instruções.
Tools
 tools array of object
Tipo
 tools.type string

O tipo de ferramentas.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.

Comece a correr

ID da Operação:
RunGet

Recupere uma execução de um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
ID de execução
 run_id True string

O identificador de execução.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
ID do assistente
 assistant_id string

O identificador do assistente.
Thread ID
 thread_id string

O identificador de thread.
Situação
 status string

O status.
Começou em
 started_at integer

Quando iniciado em.
Expira em
 expires_at string

Quando expira em.
Cancelado em
 cancelled_at string

Quando cancelado em.
Falhou em
 failed_at string

Quando falhou em.
Concluído em
 completed_at integer

Quando concluído em.
Último erro
 last_error string

O último erro.
Modelo
 model string

O modelo.
Instruções
 instructions string

As instruções.
Tools
 tools array of object
Tipo
 tools.type string

O tipo de ferramentas.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.

Criar arquivo de assistente

ID da Operação:
FilePost

Crie um arquivo de assistente anexando um arquivo a um assistente.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
ID do assistente
 assistant_id True string

O identificador do assistente.
ID do ficheiro
 file_id True string

O identificador de arquivo.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
ID do assistente
 assistant_id string

O identificador do assistente.

Criar assistente

ID da Operação:
AssistantPost

Crie um assistente com um modelo e instruções.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Modelo
 model True string

O modelo.
Instruções
 instructions string

As instruções.
Nome
 name string

O nome.
Description
 description string

A descrição.
Tipo
 type string

O tipo de ferramentas.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
Nome
 name string

O nome.
Description
 description string

A descrição.
Modelo
 model string

O modelo.
Instruções
 instructions string

As instruções.
Tools
 tools array of object
Tipo
 tools.type string

O tipo de ferramenta.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.

Criar execução

ID da Operação:
RunPost

Cria uma execução para um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
ID do assistente
 assistant_id string

O identificador do assistente.
Modelo
 model True string

O modelo.
Instruções
 instructions string

As instruções.
Tipo
 type string

O tipo de ferramentas.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
ID do assistente
 assistant_id string

O identificador do assistente.
Thread ID
 thread_id string

O identificador de thread.
Situação
 status string

O status.
Começou em
 started_at integer

Quando iniciado em.
Expira em
 expires_at string

Quando expira em.
Cancelado em
 cancelled_at string

Quando cancelado em.
Falhou em
 failed_at string

Quando falhou em.
Concluído em
 completed_at integer

Quando concluído em.
Último erro
 last_error string

O último erro.
Modelo
 model string

O modelo.
Instruções
 instructions string

As instruções.
Tools
 tools array of object
Tipo
 tools.type string

O tipo de ferramentas.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.

Criar mensagem

ID da Operação:
MessagePost

Crie uma mensagem dentro de um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
Thread ID
 thread_id string

O identificador de thread.
Funções
 role string

O papel.
Content
 content array of object
Tipo
 content.type string

O tipo de ferramentas.
Valor
 content.text.value string

O valor.
Annotations
 content.text.annotations array of string

As anotações.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.
ID do assistente
 assistant_id string

O identificador do assistente.
ID de execução
 run_id string

O identificador de execução.

Criar thread

ID da Operação:
ThreadPost

Cria um thread com o qual os assistentes podem interagir.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
Thread ID
 thread_id string

O identificador de thread.
Funções
 role True string

O papel.
Content
 content True string

O conteúdo.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.
ID do assistente
 assistant_id string

O identificador do assistente.
ID de execução
 run_id string

O identificador de execução.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.

Criar thread e executar

ID da Operação:
ThreadRunPost

Cria um thread e o executa em uma solicitação.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
ID do assistente
 assistant_id string

O identificador do assistente.
Funções
 role string

O papel.
Content
 content string

O conteúdo.
Modelo
 model string

O modelo.
Intrusões
 instructions string

As instruções.
Tipo
 type string

O tipo de ferramentas.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
ID do assistente
 assistant_id string

O identificador do assistente.
Thread ID
 thread_id string

O identificador de thread.
Situação
 status string

O status.
Começou em
 started_at string

Quando iniciado em.
Expira em
 expires_at integer

Quando expira em.
Cancelado em
 cancelled_at string

Quando cancelado em.
Falhou em
 failed_at string

Quando falhou em.
Concluído em
 completed_at string

Quando concluído em.
Último erro
 last_error string

O último erro.
Modelo
 model string

O modelo.
Instruções
 instructions string

As instruções.
Tools
 tools array of object
Tipo
 tools.type string

O tipo de ferramentas.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.

Enviar saídas da ferramenta para execução

ID da Operação:
RunToolOutputsPost

Quando uma execução tem o status: "requires_action" e required_action.type é submit_tool_outputs, essa ação pode ser usada para enviar as saídas das chamadas da ferramenta assim que todas forem concluídas.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
ID de execução
 run_id True string

O identificador de execução.
ID de chamada da ferramenta
 tool_call_id string

O identificador de chamada de pedágio.
Resultado
 output string

A saída.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
ID do assistente
 assistant_id string

O identificador do assistente.
Thread ID
 thread_id string

O identificador de thread.
Situação
 status string

O status.
Começou em
 started_at integer

Quando iniciado em.
Expira em
 expires_at integer

Quando expira em.
Cancelado em
 cancelled_at string

Quando cancelado em.
Falhou em
 failed_at string

Quando falhou em.
Concluído em
 completed_at string

Quando concluído em.
Último erro
 last_error string

O último erro.
Modelo
 model string

O modelo.
Instruções
 instructions string

As instruções.
Tools
 tools array of object
Tipo
 tools.type string

O tipo de ferramentas.
Nome
 tools.function.name string

O nome.
Description
 tools.function.description string

A descrição.
Tipo
 tools.function.parameters.type string

O tipo.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.

Excluir arquivo do assistente

ID da Operação:
FileDelete

Exclui um arquivo de assistente.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
ID do assistente
 assistant_id True string

O identificador do assistente.
ID do ficheiro
 file_id True string

O identificador de arquivo.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Suprimido
 deleted boolean

Se excluído.

Excluir thread

ID da Operação:
ThreadDelete

Exclui um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Suprimido
 deleted boolean

Se excluído.

Execuções de lista

ID da Operação:
RunsGet

Recupere uma lista de execuções para um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
Limite
 limit integer

O limite.
Encomenda
 order string

A ordem.
Depois
 after string

O depois.
Antes
 before string

O antes.

Devoluções

Name Caminho Tipo Description
Objeto
 object string

O objeto.
Data
 data array of object
ID
 data.id string

O identificador.
Objeto
 data.object string

O objeto.
Criado em
 data.created_at integer

Quando criado em.
ID do assistente
 data.assistant_id string

O identificador do assistente.
Thread ID
 data.thread_id string

O identificador de thread.
Situação
 data.status string

O status.
Começou em
 data.started_at integer

Quando iniciado em.
Expira em
 data.expires_at string

Quando expira em.
Cancelado em
 data.cancelled_at string

Quando cancelado em.
Falhou em
 data.failed_at string

Quando falhou em.
Concluído em
 data.completed_at integer

Quando concluído em.
Último erro
 data.last_error string

O último erro.
Modelo
 data.model string

O modelo.
Instruções
 data.instructions string

As instruções.
Tools
 data.tools array of object
Tipo
 data.tools.type string

O tipo.
IDs de arquivo
 data.file_ids array of string

Os identificadores de arquivo.
Primeiro ID
 first_id string

O primeiro identificador.
Último documento de identificação
 last_id string

O último identificador.
Tem mais
 has_more boolean

Se tem mais.

Listar arquivos de mensagem

ID da Operação:
MessageFilesGet

Recupera uma lista de arquivos de mensagem para um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
ID da mensagem
 message_id True string

O identificador da mensagem.

Devoluções

Name Caminho Tipo Description
Objeto
 object string

O objeto.
Data
 data array of object
ID
 data.id string

O identificador.
Objeto
 data.object string

O objeto.
Criado em
 data.created_at integer

Quando criado em.
ID da mensagem
 data.message_id string

O identificador da mensagem.
Primeiro ID
 first_id string

O primeiro identificador.
Último documento de identificação
 last_id string

O último identificador.
Tem mais
 has_more boolean

Se tem mais.

Listar assistentes

ID da Operação:
AssistantsGet

Recupera uma lista de assistentes.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.

Devoluções

Name Caminho Tipo Description
Objeto
 object string

O objeto.
Data
 data array of object
ID
 data.id string

O identificador.
Objeto
 data.object string

O objeto.
Criado em
 data.created_at integer

Quando criado em.
Nome
 data.name string

O nome.
Description
 data.description string

A descrição.
Modelo
 data.model string

O modelo.
Instruções
 data.instructions string

As instruções.
Tools
 data.tools array of object
Tipo
 data.tools.type string

O tipo.
IDs de arquivo
 data.file_ids array of string

Os identificadores de arquivo.
Primeiro ID
 first_id string

O primeiro identificador.
Último documento de identificação
 last_id string

O último identificador.
Tem mais
 has_more boolean

Se tem mais.

Listar etapas de execução

ID da Operação:
RunStepsGet

Recupere uma lista de etapas de execução para um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
ID de execução
 run_id True string

O identificador de execução.
Limite
 limit integer

O limite.
Encomenda
 order string

A ordem.
Depois
 after string

O depois.
Antes
 before string

O antes.

Devoluções

Name Caminho Tipo Description
Objeto
 object string

O objeto.
Data
 data array of object
ID
 data.id string

O identificador.
Objeto
 data.object string

O objeto.
Criado em
 data.created_at integer

Quando criado em.
ID de execução
 data.run_id string

O identificador de execução.
ID do assistente
 data.assistant_id string

O identificador do assistente.
Thread ID
 data.thread_id string

O identificador de thread.
Tipo
 data.type string

O tipo de ferramentas.
Situação
 data.status string

O status.
Cancelado em
 data.cancelled_at string

Quando cancelado em.
Concluído em
 data.completed_at integer

Quando concluído em.
Expirado em
 data.expired_at string

Quando expirado em.
Falhou em
 data.failed_at string

Quando falhou em.
Último erro
 data.last_error string

O último erro.
Tipo
 data.step_details.type string

O tipo.
ID da mensagem
 data.step_details.message_creation.message_id string

O identificador da mensagem.
Primeiro ID
 first_id string

O primeiro identificador.
Último documento de identificação
 last_id string

O último identificador.
Tem mais
 has_more boolean

Se tem mais.

Listar mensagens

ID da Operação:
MessagesGet

Recupere uma lista de mensagens para um determinado thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
Limite
 limit integer

O limite.
Encomenda
 order string

A ordem.
Depois
 after string

O depois.
Antes
 before string

O antes.

Devoluções

Name Caminho Tipo Description
Objeto
 object string

O objeto.
Data
 data array of object
ID
 data.id string

O identificador.
Objeto
 data.object string

O objeto.
Criado em
 data.created_at integer

Quando criado em.
Thread ID
 data.thread_id string

O identificador de thread.
Funções
 data.role string

O papel.
Content
 data.content array of object
Tipo
 data.content.type string

O tipo.
Valor
 data.content.text.value string

O valor.
Annotations
 data.content.text.annotations array of string

As anotações.
IDs de arquivo
 data.file_ids array of string

Os identificadores de arquivo.
ID do assistente
 data.assistant_id string

O identificador do assistente.
ID de execução
 data.run_id string

O identificador de execução.
Primeiro ID
 first_id string

O primeiro identificador.
Último documento de identificação
 last_id string

O último identificador.
Tem mais
 has_more boolean

Se tem mais.

Listar modelos

ID da Operação:
ModelsGet

Lista os modelos atualmente disponíveis e fornece informações básicas sobre cada um, como o proprietário e a disponibilidade.

Devoluções

Name Caminho Tipo Description
Objeto
 object string

O objeto.
Data
 data array of object
ID
 data.id string

O identificador.
Objeto
 data.object string

O objeto.
Criado
 data.created integer

Quando criado.
Propriedade de
 data.owned_by string

Propriedade de.

Modificar execução

ID da Operação:
RunModifyPost

Modifica uma execução para um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
ID de execução
 run_id True string

O identificador de execução.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
ID do assistente
 assistant_id string

O identificador do assistente.
Thread ID
 thread_id string

O identificador de thread.
Situação
 status string

O status.
Começou em
 started_at integer

Quando iniciado em.
Expira em
 expires_at string

Quando expira em.
Cancelado em
 cancelled_at string

Quando cancelado em.
Falhou em
 failed_at string

Quando falhou em.
Concluído em
 completed_at integer

Quando concluído em.
Último erro
 last_error string

O último erro.
Modelo
 model string

O modelo.
Instruções
 instructions string

As instruções.
Tools
 tools array of object
Tipo
 tools.type string

O tipo de ferramentas.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.

Modificar mensagem

ID da Operação:
MessageModifyPost

Modifica uma mensagem.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
ID da mensagem
 message_id True string

O identificador da mensagem.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
Thread ID
 thread_id string

O identificador de thread.
Funções
 role string

O papel.
Content
 content array of object
Tipo
 content.type string

O tipo de ferramentas.
Valor
 content.text.value string

O valor.
Annotations
 content.text.annotations array of string

As anotações.
IDs de arquivo
 file_ids array of string

Os identificadores de arquivo.
ID do assistente
 assistant_id string

O identificador do assistente.
ID de execução
 run_id string

O identificador de execução.

Modificar um thread

ID da Operação:
ThreadModifyPost

Modifica um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.

Obter arquivos do assistente

ID da Operação:
FilesGet

Recupera uma lista de arquivos do assistente.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
ID do assistente
 assistant_id True string

O identificador do assistente.

Devoluções

Name Caminho Tipo Description
Objeto
 object string

O objeto.
Data
 data array of object
ID
 data.id string

O identificador.
Objeto
 data.object string

O objeto.
Criado em
 data.created_at integer

Quando criado em.
ID do assistente
 data.assistant_id string

O identificador do assistente.
Primeiro ID
 first_id string

O primeiro identificador.
Último documento de identificação
 last_id string

O último identificador.
Tem mais
 has_more boolean

Se tem mais.

Obter etapa de execução

ID da Operação:
RunStepGet

Recupere uma etapa de execução para um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
ID de execução
 run_id True string

O identificador de execução.
ID do passo
 step_id True string

O identificador de etapa.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
ID de execução
 run_id string

O identificador de execução.
ID do assistente
 assistant_id string

O identificador do assistente.
Thread ID
 thread_id string

O identificador de thread.
Tipo
 type string

O tipo.
Situação
 status string

O status.
Cancelado em
 cancelled_at string

Quando cancelado em.
Concluído em
 completed_at integer

Quando concluído em.
Expirado em
 expired_at string

Quando expirado em.
Falhou em
 failed_at string

Quando falhou em.
Último erro
 last_error string

O último erro.
Tipo
 step_details.type string

O tipo.
ID da mensagem
 step_details.message_creation.message_id string

O identificador da mensagem.

Obter thread

ID da Operação:
ThreadGet

Recuperar um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.

Recuperar arquivo de mensagem

ID da Operação:
MessageFileGet

Recupera um arquivo de mensagem de um thread.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
Thread ID
 thread_id True string

O identificador de thread.
ID da mensagem
 message_id True string

O identificador da mensagem.
ID do ficheiro
 file_id True string

O identificador de arquivo.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
ID da mensagem
 message_id string

O identificador da mensagem.

Recuperar arquivo do assistente

ID da Operação:
FileGet

Recupera um arquivo de assistente.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Beta
 OpenAI-Beta True string

O cabeçalho beta. Necessário para ser definido enquanto a API está em beta.
ID do assistente
 assistant_id True string

O identificador do assistente.
ID do ficheiro
 file_id True string

O identificador de arquivo.

Devoluções

Name Caminho Tipo Description
ID
 id string

O identificador.
Objeto
 object string

O objeto.
Criado em
 created_at integer

Quando criado em.
ID do assistente
 assistant_id string

O identificador do assistente.