Evolução da Nossa Assistente de IA

Vue.js
AI SDK
TypeScript
Node.js

Redesenhando a assistente de IA da Layers de uma funcionalidade escondida em drawer para um sistema inline orientado por ações com respostas em streaming.

Sobre o Projeto

Comunicados é um dos apps mais usados da nossa plataforma. Foi nele que a LIA (Layers AI) nasceu para ajudar administradores escolares a escreverem melhor. A primeira versão, porém, tinha muita fricção: prompt curto, acesso escondido e fluxo em múltiplos drawers.

O Desafio

Os principais pontos de atrito eram:

  • Acesso escondido: muitos cliques para chegar na IA.
  • Saída genérica: respostas sem contexto da tarefa real.
  • Sem streaming: o usuário aguardava a resposta completa sem feedback.

A Solução

1. IA Inline

Movemos a IA para perto do campo de descrição do comunicado, reduzindo troca de contexto e deixando o uso natural no fluxo de escrita.

2. Streaming em Tempo Real

Com o AI SDK, os usuários passaram a acompanhar a resposta sendo gerada em tempo real.

3. Sistema de Ações

Estruturei a arquitetura para que cada interação da UI dispare uma ação específica (ex.: revise, expand, shorten) com prompt e parâmetros próprios.

4. Flexibilidade de Modelo

A implementação com AI SDK permite trocar provedor/modelo sem reescrever o frontend.

O que Eu Construi

  • Planejamento da arquitetura orientada a ações.
  • Implementação de UI em parceria com design.
  • Backend do registry de ações e templates de prompt.
  • Tratamento de erro, limite de uso e cenários de falha.
  • Streaming ponta a ponta.

Resultados

  • Maior engajamento com IA.
  • Menos contexto fora da plataforma.
  • Base reutilizável para outras funcionalidades de IA no produto.

O projeto tinha prazo curto e foi entregue no tempo planejado. O diferencial foi definir arquitetura cedo e focar no que realmente reduzia fricção para o usuário final.