A 11 de março de 2025, lançámos os componentes básicos da nossa nova plataforma Agents. Para obter detalhes, consulte a nossa documentação da API para a Responses API, Ferramentas incluindo Web Search, File Search e Computer Use, bem como o nosso Agents SDK com Tracing. Com base no seu feedback sobre a Assistants API beta, incorporámos melhorias importantes na Responses API. Depois de alcançarmos paridade total de funcionalidades, anunciaremos um plano de descontinuação da Assistants API ainda este ano, com uma data prevista de encerramento no primeiro semestre de 2026.
O que é a Assistants API?
A Assistants API permite aos programadores criar facilmente assistentes de AI poderosos nas suas aplicações. Esta API elimina a necessidade de gerir o histórico de conversas e adiciona acesso a ferramentas alojadas pela OpenAI, como o Code Interpreter e o File Search. A API também suporta chamada de funções melhorada para ferramentas de terceiros.
Ainda posso utilizar a versão beta v1 da API Assistants?
Não. Desde 18 de dezembro de 2024, os utilizadores deixaram de ter acesso à versão v1 beta da API Assistants. Atualmente, apenas suportamos a v2. Consulte este guia de migração para converter as suas chamadas à API da v1 para a v2.
Como posso aceder-lhe?
A Assistants API está disponível para qualquer pessoa com uma conta da API da OpenAI, mas está obsoleta e será removida em agosto de 2026. Para novos projetos, utilize antes a Responses API. Se já utiliza a Assistants API, planeie a sua migração para a Responses API. Ainda pode aceder aos assistentes existentes no Assistants Playground enquanto a API continuar disponível.
O que é um Assistente?
Um assistente representa uma AI criada para um objetivo específico, que utiliza os modelos da OpenAI e pode aceder a ficheiros, manter threads persistentes e chamar ferramentas.
O que é uma Thread?
Uma thread é uma sessão de conversa entre um assistente e um utilizador. As threads simplificam o desenvolvimento de aplicações ao armazenarem o histórico de mensagens e truncá-lo quando a conversa fica demasiado longa para o comprimento de contexto do modelo.
O que é a ferramenta Pesquisa de Ficheiros?
A ferramenta file_search aplica de forma nativa várias boas práticas de recuperação para ajudar a extrair dos seus ficheiros os dados adequados e complementar as respostas do modelo. Para obter mais informações, consulte a nossa documentação para programadores.
Por predefinição, a ferramenta file_search utiliza as seguintes definições:
Tamanho do bloco: 800 tokens
Sobreposição de blocos: 400 tokens
Modelo de incorporação: text-embedding-3-large com 256 dimensões
Número máximo de blocos adicionados ao contexto: 20
Quais são as restrições para o carregamento de ficheiros?
As restrições para carregar um ficheiro são:
512 MB por ficheiro
5 M tokens por ficheiro
10 mil ficheiros por vector store
1 vector store por assistente
1 vector store por thread
O limite total de armazenamento de cada projeto numa organização é de 100 GB.
Quais são as limitações da ferramenta File Search?
Existem algumas limitações conhecidas para as quais estamos a trabalhar em suporte nos próximos meses:
Atualmente, não é possível modificar as definições de fragmentação, embeddings ou recuperação.
Não suportamos a análise de imagens dentro de documentos.
Não suportamos recuperações em formatos de ficheiro estruturados (como ficheiros .csv ou .jsonl). Consulte os tipos de ficheiro suportados.
Quais são os limites de taxa da Assistants API?
Os limites de taxa da Assistants API não estão associados ao escalão de utilização e ao modelo. Em vez disso, existem limites predefinidos por tipo de pedido, com algumas exceções:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 pedidos por minuto
Como é definido o preço do Code Interpreter na API?
O Code Interpreter tem o preço de $0.03 por sessão. Se o seu assistente invocar o Code Interpreter em simultâneo em duas threads diferentes, serão criadas duas sessões do Code Interpreter (2 * $0.03). Cada sessão fica ativa por predefinição durante uma hora, o que significa que só pagaria esta taxa uma vez se o seu utilizador continuasse a dar instruções ao Code Interpreter na mesma thread durante até uma hora.
Como é definido o preço do File Search na API?
O File Search tem o preço de $0.10/GB de armazenamento de vector store por dia (o primeiro GB de armazenamento é gratuito). O tamanho da vector store baseia-se no tamanho resultante da vector store depois de o seu ficheiro ser analisado, fragmentado e incorporado.
Todas as vector stores criadas antes de 17 de abril de 2024 serão gratuitas até ao final de 2024; depois disso, serão:
Cobradas às tarifas atuais (atualmente $0.10/GB/dia), se tiverem sido utilizadas pelo menos uma vez numa Run criada depois de 17 de abril de 2024.
Eliminadas se não tiverem sido utilizadas numa única Run entre 17 de abril de 2024 e 31 de dezembro de 2024 — isto serve para evitar que lhe sejam cobradas vector stores que possa ter criado antes de esta alteração de preços ser anunciada, mas que nunca utilizou.
Existe algum limite para o número de assistentes que posso criar?
Não existe limite para o número de assistentes que uma organização pode criar.
O streaming está disponível na API?
Sim, o streaming está disponível na Assistants API.
O modo JSON está disponível na API Assistants?
Sim, o modo JSON está disponível na API Assistants através do parâmetro response_format dos objetos Assistants ou Run.
A Assistants API também gere pedidos para chamadas de funções de terceiros?
Não. Embora a chamada de funções permita ao modelo selecionar ferramentas e formatar pedidos para elas, a execução de chamadas a ferramentas de terceiros não é gerida pela OpenAI.
Como são tratados os dados que envio para a OpenAI?
Tal como no resto da nossa plataforma, os dados e ficheiros enviados para a API da OpenAI nunca são utilizados para treinar os nossos modelos e pode eliminar os seus dados sempre que precisar. Os dados carregados para a Assistants API são armazenados indefinidamente até serem eliminados manualmente por um utilizador.
O DALL-E está disponível através da Assistants API?
Neste momento, o DALL-E não está disponível.
Existe uma IU para a Assistants API?
Pode experimentar o Playground da Assistants API. Certifique-se de que está na vista Assistants na barra lateral esquerda e de que utiliza um modelo compatível com as Ferramentas que pretende ativar.
Qual é o limite de caracteres para as instruções do assistente na Assistants API?
O campo de instruções do assistente tem um comprimento máximo de 256 000 caracteres.
Estou a receber um erro como «O servidor encontrou um erro ao processar o seu pedido. Lamentamos! Pode repetir o pedido ou contactar-nos através do nosso centro de apoio em help.openai.com, se o erro persistir. » O que devo fazer?
Se estiver a receber este erro, é possível que o seu prompt não esteja configurado corretamente. Se continuar a repetir o pedido sem sucesso, experimente o seguinte:
reestruture o prompt para que todos os comandos semelhantes a funções sejam tratados como funções
adicione todos os comandos do prompt como uma função a tools
Porque é que a minha ferramenta File Search não está a funcionar bem?
Ao utilizar a ferramenta File Search, recomendamos definir max_prompt_tokens para, no mínimo, 20 000. Para conversas mais longas ou várias interações com o File Search, considere aumentar este limite para 50 000 ou, idealmente, remover por completo os limites de max_prompt_tokens para obter resultados da melhor qualidade. Leia mais aqui.
Como posso dar feedback?
Gostaríamos muito de receber o seu feedback no nosso Fórum de Programadores, através do Centro de Apoio em help.openai.com ou no Twitter @OpenAIDevs.