Capa do módulo OpenAI Assistants na plataforma do ibe.IA com o índice de 32 aulas no painel lateral direito e o player de vídeo aberto.

Chamar a API da OpenAI gera texto. Um Assistant cria um agente com memória, personalidade e ferramentas.

A diferença é enorme. A API gera uma resposta por chamada. O Assistant mantém o contexto de uma conversa inteira, lembra do que foi dito, executa funções específicas quando necessário e acessa arquivos enviados pelo usuário.

Esse módulo da Formação em Agentes IA e Automações do ibe.IA cobre os Assistants da OpenAI de ponta a ponta: do entendimento do que são threads e runs até a integração completa dentro do Bubble, com 32 aulas práticas.

O problema que esse módulo resolve

Quem constrói chatbots sem os Assistants da OpenAI esbarra num problema logo no começo: a memória tem que ser gerenciada manualmente.

Cada chamada de API é stateless. Para manter contexto de conversa, você precisa reenviar todo o histórico toda vez, o que complica o código, aumenta o custo por token e cria um limite prático de quanto contexto você consegue manter.

Os Assistants resolvem isso com threads. Uma thread mantém o histórico automaticamente. Você cria uma vez, adiciona mensagens, executa runs, e a OpenAI cuida do contexto.

Além disso, os Assistants suportam tools nativas: Function Calling (para executar ações no seu sistema), File Search (para buscar em documentos enviados) e Code Interpreter (para rodar código).

Esse módulo ensina tudo isso, com integração prática no Bubble.

O que tem dentro do módulo

32 aulas organizadas em quatro blocos.

Fundamentos

3 aulas que explicam a base antes de qualquer implementação.

O que diferencia a API de chat dos Assistants, como funciona o modelo de threads e runs, e quais são os casos de uso reais onde um Assistant faz mais sentido do que uma chamada simples de API.

Criação do assistente

8 aulas de construção do assistente passo a passo.

Você aprende como criar um assistente no painel da OpenAI, escolher o modelo, escrever as instruções de sistema, configurar as tools disponíveis (file retrieval, code interpreter, custom functions) e ajustar parâmetros como response format e temperature.

As aulas de Custom Functions são as mais densas do bloco: 22 minutos explicando como integrar funções externas no assistente, o que permite que ele chame APIs, consulte bancos de dados ou execute ações no seu sistema durante a conversa.

Integração com Bubble

20 aulas de implementação real dentro do Bubble.

O bloco começa com o fluxo geral de como uma conversa com o Assistant funciona na prática: create thread, add message, create run, poll status, retrieve messages. Cada uma dessas chamadas vira um passo explicado em detalhe.

As aulas seguintes implementam esse fluxo dentro do Bubble: modelagem do banco de dados, backend workflows para cada chamada de API, tela de interação com o usuário, e as funções de leitura e gravação de dados.

As aulas de Function Calling no Bubble fecham o bloco mostrando como fazer o assistente interagir com dados reais do aplicativo durante uma conversa.

Segunda aula do módulo OpenAI Assistants com o player de vídeo e o índice lateral mostrando os casos de uso da API.

Conclusão

1 aula de avaliação do módulo.

Pra quem é esse módulo

Esse módulo é pra três perfis dentro da Formação em Agentes IA e Automações:

Quem está construindo chatbots no Bubble e quer parar de gerenciar histórico de conversa manualmente, usando a estrutura de threads dos Assistants para isso.

Quem quer criar agentes que acessam documentos do usuário (como PDFs, planilhas, relatórios) e respondem perguntas sobre esses arquivos usando o File Search.

Quem está construindo automações mais complexas e precisa que o agente execute funções específicas durante a conversa: consultar estoque, registrar pedido, buscar cliente.

O pré-requisito recomendado é ter feito o módulo de OpenAI API Chat antes, que cobre a API básica de geração de texto.

Tempo total e nível

32 aulas.

Os blocos de Fundamentos e Criação do assistente somam entre 2 e 3 horas. O bloco de Integração com Bubble é o mais longo, com aulas de até 41 minutos nas partes mais complexas de implementação.

Nível: intermediário.

O módulo pressupõe que você já tem noção básica de como funciona a API da OpenAI e como funciona o Bubble. Quem nunca mexeu com nenhum dos dois vai ter mais dificuldade para acompanhar as aulas de integração.

Próximo passo

Esse módulo faz parte da Formação em Agentes IA e Automações do ibe.IA.

Ele é o passo seguinte depois da OpenAI API Chat, e o ponto de partida para quem quer construir agentes com estado, memória persistente e capacidade de executar ações no sistema a partir de uma conversa.

Conhecer a Formação em Agentes IA e Automações