Assistentes do OpenAI (Editor Independente) (versão prévia)
Os Assistentes do OpenAI permitem que você crie assistentes de IA em seus próprios aplicativos. Um Assistente tem instruções e pode aproveitar modelos, ferramentas e conhecimento para responder a consultas de usuário. Atualmente, o serviço Assistentes dá suporte a três tipos de ferramentas: Interpretação de Código, Recuperação e Chamada de Função.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| ttaylor@hitachisolutions.com |
| Metadados do conector | |
|---|---|
| Publicador | Troy Taylor |
| Site | https://openai.com/ |
| Política de privacidade | https://openai.com/policies/privacy-policy |
| Categorias | IA |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | 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.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API (no formato 'Portador $OPENAI_API_KEY') | secureString | A chave de API (no formato 'Bearer $OPENAI_API_KEY') para esta api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Acessar thread |
Recuperar um thread. |
| 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. |
| 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 de 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 de ferramenta quando todas elas forem concluídas. |
| Etapas de execução de lista |
Recupere uma lista de etapas de execução para um thread. |
| Excluir arquivo do assistente |
Exclui um arquivo de assistente. |
| Excluir assistente |
Exclui um 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 mensagens |
Recupere uma lista de mensagens para um determinado thread. |
| Listar modelos |
Lista os modelos disponíveis no momento e fornece informações básicas sobre cada um deles, 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 a etapa de execução |
Recupere uma etapa de execução para um thread. |
| Obter arquivos de assistente |
Recupera uma lista de arquivos de assistente. |
| Obter execução |
Recuperar uma execução de um thread. |
| Recuperar arquivo de mensagem |
Recupera um arquivo de mensagem de um thread. |
| Recuperar arquivo do assistente |
Recupera um arquivo de assistente. |
Acessar thread
Recuperar um thread.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
object | string |
O objeto. |
|
Criado em
|
created_at | integer |
Quando criado em. |
Assistente de recuperação
Recupera informações sobre um assistente.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
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
Cancele uma execução para um thread que está em andamento.
Parâmetros
| Nome | Chave | Obrigató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. |
|
Executar ID
|
run_id | True | string |
O identificador de execução. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
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. |
|
Iniciado em
|
started_at | integer |
Quando começou. |
|
Expira em
|
expires_at | integer |
Quando expirar em. |
|
Cancelado em
|
cancelled_at | string |
Quando cancelado em. |
|
Falha em
|
failed_at | string |
Quando falhou. |
|
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. |
Criar arquivo de assistente
Crie um arquivo de assistente anexando um arquivo a um assistente.
Parâmetros
| Nome | Chave | Obrigató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 de Arquivo
|
file_id | True | string |
O identificador de arquivo. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
object | string |
O objeto. |
|
Criado em
|
created_at | integer |
Quando criado em. |
|
ID do assistente
|
assistant_id | string |
O identificador do assistente. |
Criar assistente
Crie um assistente com um modelo e instruções.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
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
Cria uma execução para um thread.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
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. |
|
Iniciado em
|
started_at | integer |
Quando começou. |
|
Expira em
|
expires_at | string |
Quando expirar em. |
|
Cancelado em
|
cancelled_at | string |
Quando cancelado em. |
|
Falha em
|
failed_at | string |
Quando falhou. |
|
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
Crie uma mensagem dentro de um thread.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
object | string |
O objeto. |
|
Criado em
|
created_at | integer |
Quando criado em. |
|
Thread ID
|
thread_id | string |
O identificador de thread. |
|
Função
|
role | string |
A função. |
|
Content
|
content | array of object | |
|
Tipo
|
content.type | string |
O tipo de ferramentas. |
|
Value
|
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. |
|
Executar ID
|
run_id | string |
O identificador de execução. |
Criar thread
Cria um thread com o qual os assistentes podem interagir.
Parâmetros
| Nome | Chave | Obrigató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. |
|
|
Object
|
object | string |
O objeto. |
|
|
Criado em
|
created_at | integer |
Quando criado em. |
|
|
Thread ID
|
thread_id | string |
O identificador de thread. |
|
|
Função
|
role | True | string |
A função. |
|
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. |
|
|
Executar ID
|
run_id | string |
O identificador de execução. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
object | string |
O objeto. |
|
Criado em
|
created_at | integer |
Quando criado em. |
Criar thread e executar
Cria um thread e o executa em uma solicitação.
Parâmetros
| Nome | Chave | Obrigató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ção
|
role | string |
A função. |
|
|
Content
|
content | string |
O conteúdo. |
|
|
Modelo
|
model | string |
O modelo. |
|
|
Instruções
|
instructions | string |
As instruções. |
|
|
Tipo
|
type | string |
O tipo de ferramentas. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
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. |
|
Iniciado em
|
started_at | string |
Quando começou. |
|
Expira em
|
expires_at | integer |
Quando expirar em. |
|
Cancelado em
|
cancelled_at | string |
Quando cancelado em. |
|
Falha em
|
failed_at | string |
Quando falhou. |
|
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 de 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 de ferramenta quando todas elas forem concluídas.
Parâmetros
| Nome | Chave | Obrigató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. |
|
Executar ID
|
run_id | True | string |
O identificador de execução. |
|
ID da chamada da ferramenta
|
tool_call_id | string |
O identificador de chamada de pedágio. |
|
|
Saída
|
output | string |
A saída. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
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. |
|
Iniciado em
|
started_at | integer |
Quando começou. |
|
Expira em
|
expires_at | integer |
Quando expirar em. |
|
Cancelado em
|
cancelled_at | string |
Quando cancelado em. |
|
Falha em
|
failed_at | string |
Quando falhou. |
|
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. |
Etapas de execução de lista
Recupere uma lista de etapas de execução para um thread.
Parâmetros
| Nome | Chave | Obrigató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. |
|
Executar ID
|
run_id | True | string |
O identificador de execução. |
|
Limit
|
limit | integer |
O limite. |
|
|
Pedido
|
order | string |
A ordem. |
|
|
Após
|
after | string |
O depois. |
|
|
Antes
|
before | string |
O anterior. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Object
|
object | string |
O objeto. |
|
Dados
|
data | array of object | |
|
ID
|
data.id | string |
O identificador. |
|
Object
|
data.object | string |
O objeto. |
|
Criado em
|
data.created_at | integer |
Quando criado em. |
|
Executar ID
|
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 expirou em. |
|
Falha em
|
data.failed_at | string |
Quando falhou. |
|
Ú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. |
|
Primeira ID
|
first_id | string |
O primeiro identificador. |
|
Última ID
|
last_id | string |
O último identificador. |
|
Tem mais
|
has_more | boolean |
Se tem mais. |
Excluir arquivo do assistente
Exclui um arquivo de assistente.
Parâmetros
| Nome | Chave | Obrigató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 de Arquivo
|
file_id | True | string |
O identificador de arquivo. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
object | string |
O objeto. |
|
Excluído(a)
|
deleted | boolean |
Se excluído. |
Excluir assistente
Exclui um assistente.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
object | string |
O objeto. |
|
Excluído(a)
|
deleted | boolean |
Se excluído. |
Excluir thread
Exclui um thread.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
object | string |
O objeto. |
|
Excluído(a)
|
deleted | boolean |
Se excluído. |
Execuções de lista
Recupere uma lista de execuções para um thread.
Parâmetros
| Nome | Chave | Obrigató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. |
|
Limit
|
limit | integer |
O limite. |
|
|
Pedido
|
order | string |
A ordem. |
|
|
Após
|
after | string |
O depois. |
|
|
Antes
|
before | string |
O anterior. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Object
|
object | string |
O objeto. |
|
Dados
|
data | array of object | |
|
ID
|
data.id | string |
O identificador. |
|
Object
|
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. |
|
Iniciado em
|
data.started_at | integer |
Quando começou. |
|
Expira em
|
data.expires_at | string |
Quando expirar em. |
|
Cancelado em
|
data.cancelled_at | string |
Quando cancelado em. |
|
Falha em
|
data.failed_at | string |
Quando falhou. |
|
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. |
|
Primeira ID
|
first_id | string |
O primeiro identificador. |
|
Última ID
|
last_id | string |
O último identificador. |
|
Tem mais
|
has_more | boolean |
Se tem mais. |
Listar arquivos de mensagem
Recupera uma lista de arquivos de mensagem para um thread.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Object
|
object | string |
O objeto. |
|
Dados
|
data | array of object | |
|
ID
|
data.id | string |
O identificador. |
|
Object
|
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. |
|
Primeira ID
|
first_id | string |
O primeiro identificador. |
|
Última ID
|
last_id | string |
O último identificador. |
|
Tem mais
|
has_more | boolean |
Se tem mais. |
Listar assistentes
Recupera uma lista de assistentes.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Object
|
object | string |
O objeto. |
|
Dados
|
data | array of object | |
|
ID
|
data.id | string |
O identificador. |
|
Object
|
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. |
|
Primeira ID
|
first_id | string |
O primeiro identificador. |
|
Última ID
|
last_id | string |
O último identificador. |
|
Tem mais
|
has_more | boolean |
Se tem mais. |
Listar mensagens
Recupere uma lista de mensagens para um determinado thread.
Parâmetros
| Nome | Chave | Obrigató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. |
|
Limit
|
limit | integer |
O limite. |
|
|
Pedido
|
order | string |
A ordem. |
|
|
Após
|
after | string |
O depois. |
|
|
Antes
|
before | string |
O anterior. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Object
|
object | string |
O objeto. |
|
Dados
|
data | array of object | |
|
ID
|
data.id | string |
O identificador. |
|
Object
|
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ção
|
data.role | string |
A função. |
|
Content
|
data.content | array of object | |
|
Tipo
|
data.content.type | string |
O tipo. |
|
Value
|
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. |
|
Executar ID
|
data.run_id | string |
O identificador de execução. |
|
Primeira ID
|
first_id | string |
O primeiro identificador. |
|
Última ID
|
last_id | string |
O último identificador. |
|
Tem mais
|
has_more | boolean |
Se tem mais. |
Listar modelos
Lista os modelos disponíveis no momento e fornece informações básicas sobre cada um deles, como o proprietário e a disponibilidade.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Object
|
object | string |
O objeto. |
|
Dados
|
data | array of object | |
|
ID
|
data.id | string |
O identificador. |
|
Object
|
data.object | string |
O objeto. |
|
Criado
|
data.created | integer |
Quando criado. |
|
Propriedade por
|
data.owned_by | string |
De propriedade. |
Modificar execução
Modifica uma execução para um thread.
Parâmetros
| Nome | Chave | Obrigató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. |
|
Executar ID
|
run_id | True | string |
O identificador de execução. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
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. |
|
Iniciado em
|
started_at | integer |
Quando começou. |
|
Expira em
|
expires_at | string |
Quando expirar em. |
|
Cancelado em
|
cancelled_at | string |
Quando cancelado em. |
|
Falha em
|
failed_at | string |
Quando falhou. |
|
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
Modifica uma mensagem.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
object | string |
O objeto. |
|
Criado em
|
created_at | integer |
Quando criado em. |
|
Thread ID
|
thread_id | string |
O identificador de thread. |
|
Função
|
role | string |
A função. |
|
Content
|
content | array of object | |
|
Tipo
|
content.type | string |
O tipo de ferramentas. |
|
Value
|
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. |
|
Executar ID
|
run_id | string |
O identificador de execução. |
Modificar um thread
Modifica um thread.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
object | string |
O objeto. |
|
Criado em
|
created_at | integer |
Quando criado em. |
Obter a etapa de execução
Recupere uma etapa de execução para um thread.
Parâmetros
| Nome | Chave | Obrigató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. |
|
Executar ID
|
run_id | True | string |
O identificador de execução. |
|
ID da etapa
|
step_id | True | string |
O identificador da etapa. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
object | string |
O objeto. |
|
Criado em
|
created_at | integer |
Quando criado em. |
|
Executar ID
|
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 expirou em. |
|
Falha em
|
failed_at | string |
Quando falhou. |
|
Ú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 arquivos de assistente
Recupera uma lista de arquivos de assistente.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Object
|
object | string |
O objeto. |
|
Dados
|
data | array of object | |
|
ID
|
data.id | string |
O identificador. |
|
Object
|
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. |
|
Primeira ID
|
first_id | string |
O primeiro identificador. |
|
Última ID
|
last_id | string |
O último identificador. |
|
Tem mais
|
has_more | boolean |
Se tem mais. |
Obter execução
Recuperar uma execução de um thread.
Parâmetros
| Nome | Chave | Obrigató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. |
|
Executar ID
|
run_id | True | string |
O identificador de execução. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
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. |
|
Iniciado em
|
started_at | integer |
Quando começou. |
|
Expira em
|
expires_at | string |
Quando expirar em. |
|
Cancelado em
|
cancelled_at | string |
Quando cancelado em. |
|
Falha em
|
failed_at | string |
Quando falhou. |
|
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. |
Recuperar arquivo de mensagem
Recupera um arquivo de mensagem de um thread.
Parâmetros
| Nome | Chave | Obrigató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 de Arquivo
|
file_id | True | string |
O identificador de arquivo. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
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
Recupera um arquivo de assistente.
Parâmetros
| Nome | Chave | Obrigató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 de Arquivo
|
file_id | True | string |
O identificador de arquivo. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador. |
|
Object
|
object | string |
O objeto. |
|
Criado em
|
created_at | integer |
Quando criado em. |
|
ID do assistente
|
assistant_id | string |
O identificador do assistente. |