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.
Perguntas frequentes
O que é a API Assistants?
A API Assistants permite aos programadores criar facilmente assistentes de IA poderosos nas suas aplicações. Esta API elimina a necessidade de gerir o histórico de conversas e dá acesso a ferramentas alojadas pela OpenAI, como o Code Interpreter e o File Search. A API também oferece uma funcionalidade melhorada de chamada de funções 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 é uma IA criada para um fim 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 guardar o histórico de mensagens e ao truncá-lo quando a conversa excede o tamanho do contexto do modelo.
O que é a ferramenta File Search?
A ferramenta file_search aplica de origem várias boas práticas de recuperação de informação para ajudar a extrair dos seus ficheiros os dados certos para enriquecer as respostas do modelo.
Por predefinição, a ferramenta file_search utiliza as seguintes definições:
Tamanho dos blocos: 800 tokens
Sobreposição entre blocos: 400 tokens
Modelo de embeddings: text-embedding-3-large com 256 dimensões
Número máximo de blocos adicionados ao contexto: 20
Quais são as restrições ao carregamento de ficheiros?
As restrições ao carregamento de ficheiros são:
512 MB por ficheiro
5 milhões de tokens por ficheiro
10 000 ficheiros por armazenamento vetorial
1 armazenamento vetorial por assistente
1 armazenamento vetorial por thread
O limite total de armazenamento para cada projeto de uma organização é de 100 GB.
Quais são as limitações da ferramenta File Search?
Existem algumas limitações conhecidas que estamos a trabalhar para resolver nos próximos meses:
Atualmente, não é possível alterar as definições de divisão em blocos, de embeddings ou de recuperação de informação.
Não é suportada a análise de imagens em documentos.
Não é suportada a recuperação de informação em formatos de ficheiro estruturados (como ficheiros .csv ou .jsonl). Consulte os tipos de ficheiro suportados.
Quais são os limites de pedidos da API Assistants?
Os limites de pedidos da API Assistants não dependem do nível de utilização e do 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
Quanto custa o Code Interpreter na API?
O Code Interpreter custa 0,03 USD por sessão. Se o seu assistente chamar o Code Interpreter em simultâneo em duas threads diferentes, serão criadas duas sessões do Code Interpreter (2 * 0,03 USD). Por predefinição, cada sessão fica ativa durante uma hora. Isto significa que só paga este valor uma vez se o seu utilizador continuar a dar instruções ao Code Interpreter na mesma thread durante esse período.
Quanto custa o File Search na API?
O File Search custa 0,10 USD por GB de armazenamento vetorial por dia (o primeiro GB de armazenamento é gratuito). O tamanho do armazenamento vetorial é calculado após a análise do ficheiro, a sua divisão em blocos e a criação dos respetivos embeddings.
Os armazenamentos vetoriais criados antes de 17 de abril de 2024 serão gratuitos até ao final de 2024. Depois disso, serão:
Faturados às tarifas em vigor (atualmente, 0,10 USD/GB/dia), se tiverem sido utilizados pelo menos uma vez num Run criado após 17 de abril de 2024.
Eliminados, se não tiverem sido utilizados em nenhum Run entre 17 de abril de 2024 e 31 de dezembro de 2024 — isto evita a cobrança de armazenamentos vetoriais que possa ter criado antes do anúncio desta alteração de preços, mas que nunca tenha utilizado.
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 API Assistants.
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 nos objetos Assistants ou Run.
A API Assistants também gere pedidos de chamada de funções de terceiros?
Não. Embora a chamada de funções permita ao modelo selecionar ferramentas e formatar os pedidos que lhes são dirigidos, a execução de chamadas a ferramentas de terceiros não é gerida pela OpenAI.
Como são tratados os dados que envio à OpenAI?
Tal como no resto da nossa plataforma, os dados e ficheiros enviados à 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 API Assistants são armazenados por tempo indeterminado, até que um utilizador os elimine manualmente.
O DALL-E está disponível através da API Assistants?
De 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 das instruções do assistente na API Assistants?
O campo de instruções do assistente tem um limite de 256 000 caracteres.
Estou a receber um erro como «Ocorreu um erro no servidor ao processar o seu pedido. Pedimos desculpa! Pode tentar enviar o pedido novamente 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, o seu prompt poderá não estar configurado corretamente. Se o pedido continuar a falhar após várias tentativas, experimente o seguinte:
reestruture o seu prompt para tratar como funções quaisquer comandos semelhantes a funções
adicione cada comando do seu prompt como uma função em 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, pelo menos, 20 000. Para conversas mais longas ou múltiplas 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.
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 em @OpenAIDevs.