Em 11 de março de 2025, lançamos os blocos de construção da nossa nova plataforma de agentes. Para obter detalhes, consulte nossa documentação de API para a Responses API, ferramentas incluindo Web Search, File Search e Computer Use, e nosso Agents SDK com Tracing. Com base no seu feedback sobre a versão beta da Assistants API, incorporamos melhorias importantes à Responses API. Depois de alcançarmos paridade total de recursos, anunciaremos um plano de descontinuação da Assistants API ainda este ano, com data-alvo de encerramento no primeiro semestre de 2026.
Perguntas frequentes
O que é a API de Assistentes?
A API de Assistentes permite que desenvolvedores criem facilmente assistentes de IA poderosos em seus aplicativos. Essa API elimina a necessidade de gerenciar o histórico de conversas e oferece acesso a ferramentas hospedadas pela OpenAI, como o Code Interpreter e a busca em arquivos. A API também oferece suporte aprimorado à chamada de função para ferramentas de terceiros.
Ainda posso usar a versão beta v1 da API Assistants?
Não. Desde 18 de dezembro de 2024, os usuários não têm mais acesso à versão v1 beta da API Assistants. Atualmente, oferecemos suporte apenas à v2. Consulte este guia de migração para converter suas chamadas de API da v1 para a v2.
Como faço para acessá-la?
A Assistants API está disponível para qualquer pessoa com uma conta da API da OpenAI, mas foi descontinuada e será removida em agosto de 2026. Para novos projetos, use a Responses API. Se você já usa a Assistants API, planeje sua migração para a Responses API. Você ainda pode acessar assistentes existentes no Assistants Playground enquanto a API permanecer disponível.
O que é um assistente?
Um assistente representa uma IA criada para uma finalidade específica, que usa os modelos da OpenAI e pode acessar arquivos, manter threads persistentes e chamar ferramentas.
O que é uma thread?
Uma thread é uma sessão de conversa entre um assistente e um usuário. As threads simplificam o desenvolvimento de aplicações ao armazenar o histórico de mensagens e truncá-lo quando a conversa ultrapassa o limite de contexto do modelo.
O que é a ferramenta de busca em arquivos?
A ferramenta file_search já implementa diversas boas práticas de recuperação para ajudar você a extrair os dados certos dos seus arquivos e enriquecer as respostas do modelo.
Por padrão, a ferramenta file_search usa as seguintes configurações:
Tamanho do bloco: 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 para o envio de arquivos?
As restrições para o envio de arquivos são:
512 MB por arquivo
5 milhões de tokens por arquivo
10 mil arquivos por armazenamento vetorial
1 armazenamento vetorial por assistente
1 armazenamento vetorial por thread
O limite total de armazenamento para cada projeto em uma organização é de 100 GB.
Quais são as limitações da ferramenta de busca em arquivos?
Há algumas limitações conhecidas que estamos trabalhando para resolver nos próximos meses:
Atualmente, não é possível modificar as configurações de divisão em blocos, embeddings ou recuperação.
Não oferecemos suporte à análise de imagens em documentos.
Não oferecemos suporte à recuperação de dados em formatos de arquivo estruturados (como arquivos .csv ou .jsonl). Veja os tipos de arquivo compatíveis.
Quais são os limites de taxa da API de Assistentes?
Os limites de taxa da API de Assistentes não estão vinculados ao nível de uso e ao modelo. Em vez disso, há limites padrão por tipo de solicitação, com algumas exceções:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 solicitações por minuto
Como é cobrado o Code Interpreter na API?
O Code Interpreter custa US$ 0,03 por sessão. Se o seu assistente chamar o Code Interpreter simultaneamente em duas threads diferentes, serão criadas duas sessões do Code Interpreter (2 * US$ 0,03). Por padrão, cada sessão fica ativa por uma hora. Isso significa que você paga essa taxa apenas uma vez se o usuário continuar enviando instruções ao Code Interpreter na mesma thread por até uma hora.
Como é cobrada a busca em arquivos na API?
A busca em arquivos custa US$ 0,10 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 arquivo, sua divisão em blocos e a geração dos embeddings.
Todos os armazenamentos vetoriais criados antes de 17 de abril de 2024 serão gratuitos até o fim de 2024. Depois disso, serão:
Cobrados pelas tarifas vigentes (atualmente US$ 0,10/GB/dia) se tiverem sido usados pelo menos uma vez em um Run criado após 17 de abril de 2024.
Excluídos se não tiverem sido usados em nenhum Run entre 17 de abril de 2024 e 31 de dezembro de 2024 — para evitar cobranças por armazenamentos vetoriais que você possa ter criado antes do anúncio dessa mudança de preço, mas nunca tenha usado.
Há um limite para quantos assistentes posso criar?
Não há limite para quantos assistentes uma organização pode criar.
O streaming está disponível na API?
Sim, o streaming está disponível na API de Assistentes.
O modo JSON está disponível na API de Assistentes?
Sim, o modo JSON está disponível na API de Assistentes pelo parâmetro response_format nos objetos Assistants ou Run.
A API de Assistentes também gerencia solicitações de chamadas de função de terceiros?
Não. Embora a chamada de função permita que o modelo selecione ferramentas e formate solicitações para elas, a execução de chamadas a ferramentas de terceiros não é gerenciada pela OpenAI.
Como são tratados os dados que envio à OpenAI?
Assim como no restante da nossa plataforma, os dados e arquivos enviados à API da OpenAI nunca são usados para treinar nossos modelos, e você pode excluir seus dados sempre que precisar. Os dados enviados à API de Assistentes ficam armazenados por tempo indeterminado, até que um usuário os exclua manualmente.
O DALL-E está disponível pela API de Assistentes?
No momento, o DALL-E não está disponível.
Há uma interface para a Assistants API?
Você pode conferir o Playground da Assistants API. Verifique se você está na visualização Assistants na barra lateral esquerda e usando um modelo compatível com as Tools que deseja ativar.
Qual é o limite de caracteres para as instruções do assistente na API de Assistentes?
O campo de instruções do assistente tem um limite de 256.000 caracteres.
Estou recebendo um erro como "Ocorreu um erro no servidor ao processar sua solicitação. Pedimos desculpas! Você pode tentar enviar a solicitação novamente ou entrar em contato conosco pela nossa central de ajuda em help.openai.com se o erro persistir. " O que devo fazer?
Se você está recebendo esse erro, pode ser que seu prompt não esteja configurado corretamente. Se a solicitação continuar falhando após várias tentativas, tente o seguinte:
reestruture seu prompt para tratar como funções todos os comandos que se assemelhem a funções
adicione cada comando do seu prompt como uma função em tools
Por que minha ferramenta de busca em arquivos não está funcionando bem?
Ao usar a ferramenta de busca em arquivos, recomendamos definir max_prompt_tokens como pelo menos 20.000. Para conversas mais longas ou várias interações com a busca em arquivos, considere aumentar esse limite para 50.000 ou, idealmente, remover os limites de max_prompt_tokens por completo para obter resultados da melhor qualidade possível.
Como posso enviar feedback?
Adoraríamos receber seu feedback no nosso Fórum de Desenvolvedores, pela Central de Ajuda em help.openai.com ou no Twitter @OpenAIDevs.