Integração de Copiloto de IA

Perguntas frequentes #

• A quais tipos de produtos SaaS vocês podem adicionar um copiloto?

  Qualquer aplicação web com uma superfície de ações definida — mapas, dashboards, CRMs, ferramentas de projetos, monitoramento de IoT. O requisito principal é um frontend com mais de 10 ações distintas do usuário. Trabalhamos principalmente com frontends React e backends REST ou WebSocket, mas a arquitetura se adapta à sua stack.
• O que é um “contrato de comandos” e por que ele importa?

  O contrato de comandos é o schema tipado que define exatamente quais ações a IA pode executar — {type: "load_dataset", params: {...}}, por exemplo. Um contrato bem projetado impede que a IA alucine ações inválidas. Projetamos o schema antes de escrever qualquer código de implementação.
• Quanto tempo leva para adicionar um copiloto a um produto existente?

  A Auditoria Diagnóstica de Arquitetura de cinco dias entrega o schema de comandos, a arquitetura de backend e o plano de integração. Um primeiro copiloto funcionando em um fluxo principal vem em 10–15 dias; a implantação completa depende da sua superfície de comandos.
• A integração substitui a interface existente?

  Não. Entregamos um componente de painel de chat independente que se integra ao lado do seu frontend existente. A interface do seu produto permanece intacta — o copiloto é uma nova superfície de controle, não um substituto. Os usuários escolhem como interagir.
• Qual modelo de IA alimenta o copiloto?

  Anthropic Claude (atualmente Haiku, por velocidade e custo) por padrão. O proxy de backend é agnóstico de modelo — GPT-4o, Gemini ou o provedor de sua preferência são mudanças de configuração, não reescritas. Definimos o modelo durante a Auditoria Diagnóstica de Arquitetura.
• Como a chave da API de IA é protegida?

  A chave nunca chega ao navegador. Todas as chamadas de IA passam por um proxy de backend Rust/Axum na sua infraestrutura. O navegador envia uma mensagem simples; o backend adiciona a chave, chama a IA e retorna comandos tipados. Sem dangerouslyAllowBrowser, sem exposição da chave.
• O que acontece quando a IA retorna uma resposta inesperada ou malformada?

  Construímos um pipeline de parsing tolerante que lida com JSON cercado por markdown, respostas parciais e envelopes de erro — os formatos que os modelos de IA realmente retornam sob carga. Comandos desconhecidos ou malformados são descartados com um log de aviso, não com uma falha visível para o usuário.
• A prevenção de abuso está incluída?

  É padrão em todo projeto: limites de taxa em múltiplas janelas (por IP, por sessão, global — minuto/hora/dia/mês), imposição de orçamento de tokens, limites de tamanho de requisição e contadores persistidos em Postgres.
• O copiloto pode ser restrito a usuários ou sessões individuais?

  Sim — isso é definido durante a Auditoria Diagnóstica de Arquitetura. Sessões isoladas por usuário exigem autenticação; uma visão de histórico compartilhado atende dashboards com vários operadores. A arquitetura suporta ambos sem reescrita.
• Vocês assinam NDAs e contratos formais?

  Sim. NDA antes de qualquer acesso ao código. Contratos assinados com escopo fixo por fase. Empresa registrada no Brasil — você contrata uma pessoa jurídica registrada, não um indivíduo.