<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Carlos Augusto Sempé Junior on Medium]]></title>
        <description><![CDATA[Stories by Carlos Augusto Sempé Junior on Medium]]></description>
        <link>https://medium.com/@carlos_sempe?source=rss-11ee6b31deae------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*W5CuBR-GSAxWpzHsZQWjCw.jpeg</url>
            <title>Stories by Carlos Augusto Sempé Junior on Medium</title>
            <link>https://medium.com/@carlos_sempe?source=rss-11ee6b31deae------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 01:32:11 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@carlos_sempe/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Clean Appless Architecture — Parte I]]></title>
            <link>https://medium.com/inside-picpay/clean-appless-architecture-parte-i-30cd12eafe54?source=rss-11ee6b31deae------2</link>
            <guid isPermaLink="false">https://medium.com/p/30cd12eafe54</guid>
            <category><![CDATA[picpay]]></category>
            <category><![CDATA[ai]]></category>
            <category><![CDATA[tech]]></category>
            <category><![CDATA[arquitetura-de-software]]></category>
            <category><![CDATA[llm]]></category>
            <dc:creator><![CDATA[Carlos Augusto Sempé Junior]]></dc:creator>
            <pubDate>Thu, 26 Jun 2025 19:42:43 GMT</pubDate>
            <atom:updated>2025-06-26T19:43:30.916Z</atom:updated>
            <content:encoded><![CDATA[<h3>Clean Appless Architecture — Parte I</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*OUTDdcCKtzzKcdTV" /><figcaption>Estamos vivendo a era pós-app: onde as experiências se concentram em diálogo, não em telas.</figcaption></figure><p>Com o advento de interfaces conversacionais movidas por LLMs (ex.: ChatGPT), o usuário troca cliques por linguagem natural. No PicPay, batizamos essa abordagem de **Appless**: oferecer a experiência de um “aplicativo” (pagamentos, consultas, ofertas, relatórios etc.) por meio de canais conversacionais.</p><p>Mas como estruturar a arquitetura que sustenta essa jornada “sem app”? Quais são os <strong>princípios</strong>, <strong>blocos de construção</strong> e <strong>padrões</strong> que garantem escalabilidade, segurança e manutenção sustentável para soluções Appless? Neste primeiro artigo da série <strong>Clean Appless Architecture</strong>, você vai conhecer:</p><ul><li><strong>O conceito Appless</strong> explicado de forma enxuta — por que ele vai além de uma interface conversacional e quais ganhos de negócio e experiência ele traz.</li><li><strong>Os pilares fundamentais</strong> — as cinco “camadas” que toda solução Appless deve contemplar, da interface conversacional ao monitoramento e feedback.</li></ul><h4>O que é Appless?</h4><p>A resposta mais simples para essa pergunta é: oferecer uma experiência completa sem precisar de um app. Isso pode ser uma nova forma de criação de “aplicativos”, sem que o usuário necessite de diversos apps instalados em seu celular. Ter uma experiência fluída onde o cliente pode através de linguagem natural ter suas necessidades atendidas e respondidas. <br><strong>Pontos positivos dessa abordagem para o usuário:<br></strong> — <strong>Economia de espaço:</strong> Cliente não precisa de múltiplos apps; <br> — <strong>Zero curva de aprendizado:</strong> Interação natural por texto ou voz.<br> — <strong>Adesão facilitada:</strong> zero fricção para starts, basta iniciar uma interação com a interface escolhida (no nosso primeiro case foi o Whatsapp) e conversar sobre sua necessidade;<br> — <strong>Respostas inteligentes</strong>: por ser uma abordagem AI First, o usuário tem respostas nas quais seus próprios dados são analisados baseados nas suas necessidades.</p><h4>Pilares da Clean Appless Architecture</h4><p>Para possibilitar esse padrão de arquitetura, é necessário que diversos pontos sejam atendidos. A mudança não é somente relacionada na forma como essa experiência é proposta para o usuário, mas também em como projetamos isso dentro de nossas arquiteturas. Muitos paradigmas precisam ser restabelecidos para uma arquitetura sem interfaces. Abaixo listo as 5 principais características para ter uma arquitetura escalável, segura e focada na experiência:</p><ul><li><strong>Interface Conversacional</strong></li><li><strong>Orquestração de Assistentes e Fluxos</strong></li><li><strong>Gestão de Contexto e Estado</strong></li><li><strong>Segurança e Privacidade</strong></li><li><strong>Observabilidade e Feedback Contínuo</strong></li></ul><h4>1. Interface Conversacional</h4><p>Como estamos deixando de lado um padrão de cliques para um padrão conversacional, existem diversos pontos a serem explorados, como qual será o canal e a forma da conversa? Como será o fluxo conversacional? Para ajudar nessa escolha, estes são os principais pontos a serem observados:</p><p><strong>1.1 Formato da Comunicação<br></strong>Antes de tudo, escolha o meio de interação que melhor equilibra custo, performance e acessibilidade:</p><ul><li><strong>Texto</strong> — o fluxo mais leve e de custo operacional reduzido; ideal para casos de uso onde agilidade e baixo custo são prioridades.</li><li><strong>Áudio</strong> — oferece maior naturalidade e conveniência ao usuário, mas requer conversão Speech-to-Text (STT) antes de qualquer processamento e resposta da LLM, isso cria um aumento no tempo de resposta e um aumento do custo da ferramenta.</li><li><strong>Vídeo</strong> — enriquece o contexto com sinais visuais (expressões, gestos), porém demanda processamento adicional (STT, OCR de imagem) e impacto significativo em custo e infra-estrutura de streaming.</li></ul><p><strong>1.2 Design de diálogo<br> </strong>O design do diálogo determina a liberdade do usuário e a sofisticação do backend necessário:</p><ul><li><strong>Fluxo guiado</strong> — oferece ao usuário uma espécie de menu de opções para ele interagir, e o usuário necessita qual fluxo/agente será responsável por sua resposta e interação. As principais vantagens dessa abordagem são implementação mais rápida, respostas previsíveis e baixo esforço gerenciamento de contexto e como principais desvantagens são a sensação de estar conversando com um e “chatbot tradicional” e menor naturalidade/fluidez na conversa.</li><li><strong>Fluxo livre</strong> — Esse tipo de fluxo oferece uma maior fluidez e uma sensação mais “humana” na conversa, pois o usuário apenas informa sua necessidade e o backend será responsável por identificar qual agente ou quais agentes conseguem oferecer a melhor resposta ao usuário. As principais vantagens estão relacionadas a experiência do usuário, mas como desvantagens exige um “supervisor” inteligente capaz de interpretar intenções, gerenciar ambiguidades e orquestrar múltiplos agentes, e por esse motivo gera uma maior complexidade de implementação, manutenção e rastreabilidade.</li></ul><p><strong>1.3 Fallback<br></strong>Escolher um fluxo de fallback também é um ponto importante, como estamos falando em uma arquitetura appless, não existe 404. Quando um usuário tem uma solicitação do qual não é mapeada, qual será a resposta? Para isso existem algumas opções que podem resolver esse problema, são elas:</p><ul><li><strong>Fallback automático</strong> — caso nenhum agente consiga responder a necessidade, um agente de fallback é chamado. Esse agente consulta uma base de FAQs ou KB e sugere soluções, informando passos para que o usuário resolva sua necessidade;</li><li><strong>Transbordo humano</strong> — quando o usuário demonstra insatisfação ou a intenção não foi mapeada, a conversa é redirecionada para um atendente humano que segue com o fluxo de exceção.</li><li><strong>Resposta genérica</strong> — esse fallback é o mais simples de ser implementado, pois dado uma necessidade não mapeada, uma resposta informando isso ao usuário é fornecida.</li></ul><h4>2. Orquestração de Assistentes e Fluxos</h4><p>A orquestração é o coração de uma arquitetura Appless de êxito. Dividimos essa responsabilidade em duas camadas principais:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*ru6I_dUA-3s7hPEJ" /><figcaption>Imagem ilustrativa de uma arquitetura conversacional utilizando um supervisor</figcaption></figure><p><strong>2.1 Broker<br></strong>O broker gerencia todos os eventos de mensagens entre o canal de comunicação e os agentes.</p><p><strong>Funções</strong>:</p><ol><li>Receber payloads de qualquer interface conversacional (áudio, vídeo e texto);</li><li>Enfileirar, priorizar mensagens e armazenar temporariamente arquivos com as devidas proteções alinhadas a segurança da informação;</li><li>Autenticar, validar autorização, criptografar e encaminhar ao(s) serviço(s) dos agentes ou microserviços de domínio.</li><li>Garantir retry e dead-letter para falhas transitórias.</li></ol><p><strong>2.2 Supervisor</strong></p><p>Tem como suas responsabilidades identificar qual ou quais agentes devem responder a uma pergunta. Ele é o orquestrador das conversas, deve ter conhecimento sobre todas as especialidades e ferramentas que os seus agentes possuem. Suas principais funções são:</p><p><strong>Funções</strong>:</p><ol><li>Receber as mensagens do broker e extrair a intenção principal.</li><li>Mapear agentes responsáveis com base em capabilities/skills.</li><li>Agregar respostas parciais de múltiplos agentes (se houver) e enviar a resposta final ao broker.</li><li>Emitir métricas de uso de agentes e alertas de inconsistência de fluxo.</li></ol><h4>3. Gestão de Contexto e Estado</h4><p>Em uma arquitetura Appless, a experiência do usuário depende diretamente da capacidade do sistema de lembrar onde ele parou, de informações importantes que ocorrem dentro do canal e de garantir que cada interação seja consistente e segura. Isso é papel da <strong>gestão de contexto</strong> e <strong>gestão de estado</strong>, dois elementos que evitam fluxos quebrados e efeitos colaterais indesejados.</p><p><strong>3.1 Gestão de Contexto<br></strong>Responsável por armazenar e resgatar as informações da sessão/conversa de cada usuário.<br> <strong>Principais funções:</strong></p><ul><li><em>Persistência de sessão</em> — manter dados como intenção, último agente acionado, e dados da transação em andamento.</li><li><em>Histórico da conversa</em> — registrar trocas recentes para retomada fluída após interrupções.</li><li><em>Personalização</em> — usar o contexto para respostas mais relevantes (ex: lembrar do produto que o usuário mencionou antes).</li></ul><p><strong>Exemplo prático:</strong> Quando o usuário começa um pagamento e abandona o fluxo, o contexto deve permitir que ele retome a operação sem precisar reiniciar todo o processo.</p><p><strong>3.2 Gestão de Estado<br></strong>A gestão de estado define como o sistema responde a cada etapa e garante a consistência da jornada.<br> <strong>Principais funções:</strong></p><ul><li><em>Idempotência</em> — garantir que uma mesma solicitação repetida (por falha de rede ou reenvio) não gere ações duplicadas (ex: dois pagamentos).</li><li><em>Controle de transições</em> — validar em que etapa o usuário está e impedir saltos de etapas (ex: não permitir a conclusão de pagamento sem a validação prévia).</li><li><em>Expiração de sessão</em> — definir regras de timeout para limpar estados inativos e evitar acúmulo de dados desnecessários.</li></ul><p><strong>4. Segurança e Privacidade<br></strong>Segurança e privacidade são pontos críticos em uma arquitetura Appless. Eles exigem uma revisão completa dos paradigmas tradicionais de proteção e autenticação, já que os fluxos não ocorrem dentro de um app proprietário, mas em canais de terceiros como WhatsApp e outros canais de conversacionais. Nesse cenário, o <strong>broker</strong> assume um papel central, funcionando como guardião da integridade, confidencialidade e rastreabilidade das mensagens trocadas no canal.</p><p>Veja a seguir os principais pilares de segurança que uma ferramenta Appless deve garantir:</p><ul><li><strong>Criptografia de mensagens recebidas</strong> — todas as mensagens recebidas do canal escolhido devem trafegar de forma criptografada, garantindo integridade e confidencialidade ponta a ponta.</li><li><strong>Webhook seguro com o canal</strong> — a conexão com ferramentas de terceiros, como no caso do Whatsapp geralmente ocorre via webhook. Essa comunicação deve ser feita por um microserviço dedicado, encapsulado, com chaves de segurança e criptografia para assegurar o tráfego seguro das mensagens.</li><li><strong>Autorização do usuário</strong> — o canal deve implementar mecanismos que garantam o consentimento explícito do usuário para uso do serviço e dos dados compartilhados.</li><li><strong>Controles de segurança adicionais</strong> — a ferramenta deve oferecer múltiplos controles, como autenticação forte, gestão de sessão, monitoramento de atividades suspeitas e validação contra possíveis “clonagens” de contas ou fraudes.</li><li><strong>Governança de LLM e Guardrails </strong>— Implemente filtros de conteúdo, red team e políticas de privacidade para evitar vazamento de prompts e dados, toxicidade ou viés.</li></ul><p><strong>5. Observabilidade e Feedback Contínuo<br></strong>Um fluxo de arquitetura sem uma ferramenta visual exige uma maior rastreabilidade e observabilidade de tudo que pode estar ocorrendo nos fluxos conversacionais. Outro ponto extremamente importante é a coleta de feedbacks para identificar pontos de melhorias e observar todos os fluxos nos quais um fallback foi acionado, pois a intenção é sempre fornecer as melhores respostas para os usuários. Para fazer isso, alguns pontos precisam ser seguidos, são eles:</p><p><strong>5.1 Logging estruturado e centralizado</strong></p><ul><li>Registre cada etapa do fluxo de forma segura (recepção, orquestração, resposta, fallback) com informações como: ID da sessão, ID do usuário, intenção detectada, agente chamado, tempo de resposta.</li><li>Use logs em formato estruturado (JSON, por exemplo) para facilitar consulta em ferramentas como CloudWatch, Datadog, Grafana.</li></ul><p><strong>5.2 Tracing distribuído</strong></p><ul><li>Cada mensagem/conversa deve carregar um <strong>correlation ID</strong> único para permitir rastrear ponta a ponta: desde a entrada no broker até o agente e retorno ao canal.</li><li>Permite identificar gargalos (ex.: onde houve latência acima do esperado).</li></ul><p><strong>5.3 Métricas chave (KPIs)</strong></p><ul><li>Taxa de acerto da LLM ou do fluxo escolhido para dar respostas ao usuário(quantas intenções corretamente identificadas).</li><li>Latência média e percentil (p95) das respostas.</li><li>Taxa de fallback acionado (% de fluxos que precisam do fallback).</li><li>Taxa de transbordo humano ou de fallbacks;</li><li>Conversão por fluxo (pagamentos concluídos, consultas bem-sucedidas).</li><li>Custo por sessão dos usuários</li></ul><p><strong>5.4 Alerta e monitoramento</strong></p><ul><li>Crie alertas para padrões anômalos: picos de fallback, aumento na latência, aumentos de custos;</li><li>Use dashboards em tempo real para que o time identifique e atue em incidentes rapidamente.</li></ul><p><strong>5.5 Feedback do usuário</strong></p><ul><li>Registre e analise explicitamente as avaliações do usuário após o atendimento (ex.: “essa resposta foi útil?”).</li><li>Use feedback passivo (ex.: se o usuário reformulou ou repetiu a pergunta) como sinal de insatisfação.</li></ul><p><strong>5.6 Loop de melhoria contínua</strong></p><ul><li>Mapeie os fluxos com mais acionamentos de fallback e defina quais são prioritários para serem resolvidos;</li><li>Use os dados de observabilidade para realizar fine tuning (retreinamento) do modelo de LLM ou revisar os fluxos conversacionais.</li></ul><p><strong>5.7 Testes automatizados de fluxos conversacionais<br></strong>Antes de qualquer nova versão ser publicada, é essencial validar os fluxos conversacionais com testes automatizados.<br> Monte suítes de testes que simulem os principais diálogos (felizes e críticos) para garantir que:</p><ul><li>As intenções continuem sendo corretamente mapeadas;</li><li>As respostas permaneçam consistentes;</li><li>Os fluxos mais usados não tenham sido quebrados acidentalmente.</li></ul><p>Esses testes devem ser executados em pipelines CI/CD e bloquear a publicação caso indicadores críticos (acurácia, regressões) estejam abaixo do esperado. Isso fecha o ciclo de qualidade, combinando <strong>observação em produção com prevenção antes do deploy</strong>.</p><h3>Conclusão</h3><p>Ao longo deste artigo, apresentamos os fundamentos da <strong>Clean Appless Architecture</strong>: um novo paradigma de experiência e arquitetura que vai além de simplesmente deixar de lado o app e mudar para um canal conversacional. Discutimos os pilares necessários para construir uma solução robusta, segura e escalável — da definição do fluxo conversacional à orquestração da ferramenta, da gestão de contexto ao monitoramento contínuo.</p><p>O Appless é mais que uma inovação: é uma mudança de paradigma que exige novas formas de projetar, desenvolver e operar experiências.</p><p>Nos próximos artigos da série:</p><ul><li>Vamos explorar como aplicamos esses princípios com exemplos práticos sobre como fizemos em nosso <strong>Broker do WhatsApp do PicPay</strong>, os desafios reais enfrentados e as soluções adotadas.</li><li>Apresentaremos o funcionamento da <strong>camada de supervisor com múltiplos agentes.</strong></li><li>E um <strong>roadmap prático para adoção Appless</strong>, com o passo a passo para mapear jornadas, escolher canais, organizar os microserviços e implantar com segurança e observabilidade, do MVP até a escala.</li></ul><p>✍️ <em>Este artigo foi inspirado por princípios do livro “Clean Architecture”, de Robert C. Martin, adaptando-os ao contexto de arquiteturas conversacionais baseadas em LLMs.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=30cd12eafe54" width="1" height="1" alt=""><hr><p><a href="https://medium.com/inside-picpay/clean-appless-architecture-parte-i-30cd12eafe54">Clean Appless Architecture — Parte I</a> was originally published in <a href="https://medium.com/inside-picpay">Inside PicPay</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>