Estratégias de chunking RAG explicadas: fixo, sobreposição, frase, recursivo e títulos, medidos

  1. Início
  2. Blog
  3. Inteligência Artificial

Inteligência Artificial

Estratégias de chunking RAG explicadas: Fixo, Sobreposição, Frase, Recursivo e Títulos, Medidos

As estratégias de agrupamento RAG decidem como os documentos são cortados em pedaços antes de serem incorporados e recuperados. Dividimos o mesmo documento de política em cinco maneiras e medimos o que cada método quebra: fatos cortados pela metade, títulos separados de seu texto e tokens extras armazenados.

9 min de leitura
Estratégias de chunking RAG explicadas e medidas

Principais pontos

  • Estratégias de chunking RAG trocam simplicidade por manter o significado intacto. Nenhum método venceu em todas as medidas em nosso teste.
  • Pedaços simples de tamanho fixo de 100 tokens cortam pela metade um dos oito fatos principais: “Os reembolsos são emitidos em | 5 dias úteis”.
  • 20 tokens de sobreposição resgataram esse fato, mas armazenaram 545 tokens em vez de 445, cerca de 22% a mais.
  • A divisão recursiva manteve cada frase inteira, mas deixou 4 dos 6 pedaços terminando com o título da seção próxima.

A geração aumentada de recuperação (RAG) funciona encontrando as partes mais relevantes de seus documentos e entregando-as a um modelo de linguagem. Essas peças são pedaços, e a maneira como você as corta silenciosamente decide o que o modelo pode ver. Um fato dividido em dois pedaços nunca pode ser recuperado inteiro. Um título cortado de seu parágrafo torna um trecho ambíguo. Escolher entre estratégias de chunking RAG é uma das maneiras mais baratas de melhorar a qualidade das respostas.

Implementamos cinco estratégias comuns em Python 3.13 e contamos tokens com OpenAI tiktoken 0.14.0 usando a codificação o200k_base. Cada número abaixo vem dessa execução. Se o RAG em si for novo para você, leia primeiro nosso guia sobre o que é RAG.

O que é fragmentação no RAG?

Chunking é a etapa que divide os documentos de origem em passagens menores antes de serem transformados em embeddings e armazenados em um banco de dados vetorial. No momento da pergunta, o sistema incorpora a pergunta, encontra os pedaços mais próximos e os cola no prompt. Cada pedaço é recuperado ou ignorado como uma unidade.

Os pedaços devem ser pequenos o suficiente para serem específicos e caberem vários na janela de contexto do modelo, e grandes o suficiente para transportar um pensamento completo. Cada estratégia é uma resposta diferente para onde devem ir os cortes.

Por que a fragmentação é importante

  • Precisão de recuperação: um pedaço que mistura dois tópicos corresponde a perguntas sobre ambos, mas não responde bem a nenhum deles.
  • Completude: se uma regra e sua exceção ocorrerem em partes diferentes, o modelo poderá ver apenas metade da regra.
  • Custo: sobreposição e grandes pedaços significam mais tokens para incorporar, armazenar e enviar ao modelo.
  • Citações: os pedaços limpos são mapeados ordenadamente para uma seção, o que torna as respostas mais fáceis de verificar.

Nossa configuração de teste

Escrevemos uma política de cliente de 368 palavras para uma loja online fictícia, com cinco seções Markdown (Devoluções, Envio, Garantia, Contas e Pagamentos) e dois parágrafos cada. Chegou a 445 tokens. Escolhemos oito fatos que um bot de suporte deve responder corretamente, como “devolver a maioria dos itens em 30 dias” e “até 10.000 rúpias” para pagamento na entrega.

Cada estratégia usava uma meta de 100 tokens por pedaço, pequena o suficiente para forçar cortes em um documento curto. Para cada resultado que medimos:

  • Pedaços e tamanho médio e máximo em tokens.
  • Tokens armazenados, o total em todos os blocos, que mostra o custo de sobreposição.
  • Cortar no meio da frase: pedaços que terminam no meio de uma frase.
  • Título órfão: pedaços que terminam com um título cujo texto está no próximo pedaço.
  • Fatos intactos: quantos dos oito fatos aparecem inteiros em pelo menos um pedaço.

1. Pedaços de tamanho fixo

O método mais simples conta tokens e corta todos os N tokens, onde quer que caiam:

def fixed(size, overlap=0):
    ids = enc.encode(doc)
    step = size - overlap
    out = []
    for i in range(0, len(ids), step):
        out.append(enc.decode(ids[i:i + size]))
        if i + size >= len(ids):
            break
    return out

Produziu 5 pedaços sem fichas desperdiçadas, mas 3 deles terminaram no meio da frase e um terminou em um título órfão. Pior ainda, um fato foi dividido ao meio:

chunk 1 ends:   "... print the prepaid label. Refunds are issued within"
chunk 2 starts: " 5 business days after the warehouse receives and checks the"

Uma pergunta sobre o momento do reembolso pode recuperar o bloco 1, que não contém nenhum número. O chunking de tamanho fixo é rápido e previsível, o que o torna uma boa base, mas ignora completamente a linguagem.

2. Tamanho fixo com sobreposição

A sobreposição repete os últimos tokens de cada pedaço no início do próximo, de modo que o texto próximo a um corte apareça em ambos. Usamos 20 tokens, uma sobreposição de 20%. Todos os oito fatos estavam agora intactos em algum lugar, e o fato do reembolso foi resgatado. O custo: 6 pedaços e 545 tokens armazenados em vez de 445. Os cortes ainda ocorrem no meio da frase, cinco vezes desta vez, e o texto duplicado pode fazer com que dois pedaços quase idênticos atrapalhem outros resultados. A sobreposição é um patch para cortes arbitrários, não uma cura.

3. Embalagem de frases

Este método divide o texto em frases e, em seguida, agrupa frases inteiras em cada bloco até que o próximo exceda o limite:

def sentence_pack(size):
    sents = [s for p in doc.split("\n\n") for s in sent_split(p) if s]
    out, cur = [], ""
    for s in sents:
        if cur and T(cur + " " + s) > size:
            out.append(cur)
            cur = s
        else:
            cur = (cur + " " + s).strip()
    return out + [cur]

Produziu 5 pedaços, sem cortes no meio da frase e todos os oito fatos intactos, com 440 tokens armazenados. Dois trechos ainda terminavam com um título órfão, porque uma linha de título parece apenas mais uma frase curta. A divisão de frases com uma expressão regular também encontra abreviações como “por exemplo”; bibliotecas como spaCy ou NLTK fazem isso melhor.

4. Divisão recursiva

A divisão recursiva, popularizada por estruturas como LangChain, tenta primeiro o maior separador natural (linhas em branco entre parágrafos) e só recorre aos menores (quebras de linha, frases, palavras) para pedaços que ainda são muito grandes. Nossa própria implementação seguiu a mesma ideia.

Ele manteve todas as frases inteiras e todos os oito fatos intactos, com os menores pedaços em média (74 tokens). Mas revelou uma falha sutil: 4 de seus 6 pedaços terminavam com o título da seção seguinte. Por exemplo, um bloco terminava com “… verifica o pacote. ## Envio”, enquanto as regras de envio ficavam no bloco seguinte. O título se anexou ao texto errado, o que pode induzir em erro a recuperação de perguntas que mencionam “frete”.

Dica: sempre imprima uma amostra de seus pedaços e leia-os. Nosso problema de títulos órfãos era invisível nas médias e óbvio após a leitura de seis blocos.

5. Pedaços baseados em título

Documentos estruturados carregam seus próprios limites. A divisão nos títulos do Markdown resultou em um pedaço por seção: 5 pedaços, sem cortes no meio da frase, sem títulos órfãos e todos os fatos intactos. Cada pedaço começa com seu próprio título, o que fornece um contexto útil à incorporação.

O problema é o controle de tamanho. Uma seção atingiu 113 tokens, acima de nossa meta de 100 tokens, e documentos reais têm seções que variam de uma linha a várias páginas. Na prática, você combina métodos: primeiro divida por títulos, depois aplique divisão recursiva ou de frase dentro de qualquer seção que seja muito grande e repita o título no topo de cada peça.

Estratégias de chunking RAG comparadas

Estratégia Pedaços Média/máximo de tokens Tokens armazenados Cortar no meio da frase Título órfão Fatos intactos
Fixo 100 5 89 / 100 445 3 1 7 de 8
Sobreposição fixa de 100 + 20 6 91 / 100 545 5 0 8 de 8
Embalagem de frases 5 88 / 100 440 0 2 8 de 8
Recursivo 6 74 / 84 441 0 4 8 de 8
Por título 5 89 / 113 445 0 0 8 de 8

Este é um documento curto, portanto trate a tabela como uma ilustração dos modos de falha e não como uma referência. O padrão ainda é instrutivo: quanto mais um método respeita a própria estrutura do documento, menos cortes que quebram o sentido ele faz.

E quanto à fragmentação semântica?

O chunking semântico incorpora cada frase e inicia um novo pedaço onde o significado muda, medido por uma queda na semelhança entre sentenças vizinhas. Não precisa de títulos e pode acompanhar mudanças de tópico em prosa simples. Também custa uma chamada de incorporação por frase, e as comparações publicadas discordam sobre se ele supera os métodos mais simples, uma vez medido todo o pipeline RAG. Nós não executamos isso aqui. Experimente somente após uma linha de base consciente da estrutura e mantenha-a somente se sua própria avaliação mostrar um ganho.

Como escolher o tamanho e a sobreposição do pedaço

  1. Comece com a estrutura. Divida por títulos ou seções do documento, quando existirem.
  2. Limite o tamanho. Um intervalo inicial comum é algumas centenas de tokens por bloco, cerca de 200 a 500, e depois ajuste.
  3. Prefira limites claros em vez de sobreposição. Adicione 10 a 20% de sobreposição somente se os fatos ainda ultrapassarem os cortes.
  4. Anexar metadados. Armazene o título, o cabeçalho da seção e o URL de origem com cada bloco para filtragem e citações.
  5. Avalie a recuperação. Escreva de 20 a 50 perguntas reais com respostas conhecidas e verifique se o pedaço certo está classificado nos primeiros resultados. Altere uma configuração de cada vez.
  6. Conte os tokens corretamente com o tokenizer que seus modelos usam, conforme explicado em nosso guia de tokens LLM.

Armazene os pedaços em um banco de dados que suporte filtros de metadados, conforme abordado em nosso guia de banco de dados vetorial.

Considerações finais

As estratégias de chunking RAG são onde muitos problemas de recuperação começam e onde são mais baratos para serem corrigidos. Nosso teste mostrou a falha típica de cada método: o tamanho fixo corta os fatos pela metade, os custos de sobreposição de armazenamento, o empacotamento de frases e a divisão recursiva podem encalhar os títulos, e os pedaços baseados em títulos precisam de um limite de tamanho. Comece pela estrutura dos seus documentos, volte à divisão com reconhecimento de frase, leia seus pedaços e deixe um pequeno conjunto de avaliação decidir o resto.

Perguntas frequentes

Qual é a melhor estratégia de chunking para RAG?

Não existe um melhor universal. Para documentos estruturados, divida por títulos e, em seguida, limite o tamanho com divisão recursiva ou de frase. Valide a escolha com seus próprios testes de recuperação.

Qual tamanho de pedaço devo usar para RAG?

Algumas centenas de tokens, geralmente em torno de 200 a 500, são um ponto de partida comum. Pedaços menores são mais precisos, pedaços maiores carregam mais contexto; sintonize-se com perguntas reais.

A sobreposição de pedaços ajuda?

Pode resgatar fatos que abrangem um corte. Em nosso teste, 20 tokens de sobreposição mantiveram todos os oito fatos intactos, mas armazenaram cerca de 22% mais tokens e ainda cortaram sentenças.

O que é fragmentação recursiva?

Ele se divide primeiro no separador maior, como linhas em branco, e usa apenas separadores menores, como frases ou palavras, para partes que ainda são muito grandes.

A fragmentação semântica é melhor do que a fragmentação de tamanho fixo?

Não é confiável. Ele segue mudanças de tópico, mas custa chamadas extras de incorporação e os resultados publicados são mistos. Compare-o com uma linha de base mais simples baseada em seus próprios dados.

Continue aprendendo

Trabalhe com Stack Quora

Precisa de ajuda com testes, WordPress ou SEO?

Ajudamos as equipes a fornecer software melhor e a expandir seus sites. Diga-nos no que você está trabalhando e sugeriremos um próximo passo claro.

Continue lendo

Mais guias sobre testes, IA e desenvolvimento moderno

Gostou deste artigo? Escolha um tópico e vá direto para nossos tutoriais mais recentes.

Inteligência artificial

Estratégias de chunking RAG explicadas: fixo, sobreposição, frase, recursivo e títulos, medidos

Estratégias de chunking RAG comparadas em um documento com tiktoken 0.14: tamanho fixo, sobreposição, empacotamento de frases, divisão recursiva e p…

Leia o artigo →
Desenvolvimento de software

Explicação da idempotência da API: chaves de idempotência e novas tentativas seguras, testadas

A idempotência da API explicada com um servidor e cliente Python que executamos: uma resposta perdida causava uma cobrança dupla sem uma chave e uma…

Leia o artigo →
DevOps

Git Stash explicado: salvar, aplicar, abrir e não rastrear arquivos, testado

Git stash explicado com comandos que executamos no Git 2.56: push com uma mensagem, arquivos não rastreados, listar e mostrar, aplicar vs pop, mante…

Leia o artigo →
Teste de software

Explicação do teste em pares: como todos os pares reduzem 216 testes para 13, testados

Testes em pares explicados com um gerador que executamos em Python 3.13: um checkout com 216 combinações cobertas por 13 testes, cobertura verificad…

Leia o artigo →
Automação de testes

Duplas de teste explicadas: Dummy, Stub, Spy, Mock e Fake, com código Python testado

O teste duplo é explicado com um exemplo de Python executado no pytest 9.2: dummy, stub, spy, mock e fake, quando usar cada um, verificações de esta…

Leia o artigo →
Bancos de dados e SQL

SQL COALESCE explicado: padrões, NULLIF, IFNULL vs ISNULL e traps, testados

SQL COALESCE explicado com consultas que executamos no SQLite 3.50: primeiros valores não nulos, strings vazias, NULL em matemática, NULLIF para div…

Leia o artigo →
Bancos de dados e SQL

SQL Self Join explicado: funcionário-gerente, comparações de pares e linhas, testado

Auto-junção SQL explicada com consultas que executamos no SQLite 3.50: funcionário e gerente, ganhando mais que o gerente, pares únicos, alterações …

Leia o artigo →
Desenvolvimento de software

Explicação do operador JavaScript Spread: Spread vs Rest, cópias e pegadinhas, testado

O operador de propagação JavaScript explicado com o código que executamos no Nó 24: arrays, objetos, cópias superficiais, parâmetros restantes, o li…

Leia o artigo →
Desenvolvimento de software

Módulo de coleções Python explicado: contador, defaultdict, deque e mais, testado

Coleções Python explicadas com código que executamos em Python 3.13: Counter, defaultdict, deque, nomeadotuple, OrderedDict e ChainMap, além de um t…

Leia o artigo →
Inteligência artificial

Janela de contexto LLM explicada: tokens, limites e como ajustar mais, medidos

A janela de contexto do LLM explicada com contagens de tokens que medimos usando tiktoken: palavras versus tokens para prosa, código e hindi, orçame…

Leia o artigo →
Desenvolvimento de software

Webhooks explicados: como funcionam e como recebê-los com segurança

Webhooks explicados com um receptor e remetente que executamos em Python: push vs polling, assinaturas HMAC-SHA256, rejeição de solicitações adulter…

Leia o artigo →
DevOps

Git Cherry-Pick explicado: copie o commit que você precisa, com segurança e testado

Git cherry-pick explicado com comandos que executamos no Git 2.56: copiar um hotfix para um branch de lançamento, novos hashes e patch-ids, -x, -n, …

Leia o artigo →
Automação de testes

Explicação do teste instantâneo: como funciona, quando ajuda e quando dói

O teste de instantâneo foi explicado com uma demonstração pytest e xaroposa que executamos: criação de instantâneos, leitura da diferença após uma a…

Leia o artigo →
Teste de software

Explicação do teste de mutação: por que a cobertura de 100% ainda não percebeu nosso bug

Os testes de mutação explicados com uma pequena ferramenta de mutação que construímos e executamos: 14 mutantes, um conjunto de testes com 100% de c…

Leia o artigo →
Inteligência artificial

Explicação da injeção imediata: como os aplicativos de IA são enganados e como defendê-los

Injeção imediata explicada para construtores: ataques diretos e indiretos, por que os filtros de palavras-chave falham (nosso teste bloqueou 1 de 4)…

Leia o artigo →
DevOps

Registros DNS explicados: A, AAAA, CNAME, MX, TXT e TTL com pesquisas reais

Registros DNS explicados com pesquisas que executamos: como funciona a resolução, A e AAAA, regras CNAME, MX e MX nulo, TXT para SPF e verificação, …

Leia o artigo →
DevOps

Sinalizadores de recursos explicados: lançamentos seguros, lançamentos graduais e higiene de sinalizadores

Sinalizadores de recursos explicados com uma simulação de implementação que executamos: tipos de sinalizadores, implementações percentuais com hashi…

Leia o artigo →
Automação de testes

Geração de dados de teste com Python Faker: dados realistas, repetíveis e seguros

Teste a geração de dados com Python Faker, execute e meça: propagação de dados repetíveis, localidades, valores exclusivos, registros em formato de …

Leia o artigo →
Teste de software

Explicação do teste Shift-Left: Encontre bugs mais cedo, sem atrasar a equipe

O teste shift-left explicou: o que significa, por que os defeitos iniciais são mais baratos, práticas desde revisões de requisitos até verificações …

Leia o artigo →
Bancos de dados e SQL

Funções de string SQL explicadas: TRIM, SUBSTR, REPLACE, CONCAT e limpeza de dados

Funções de string SQL explicadas com consultas que executamos: concatenação e NULL, TRIM, UPPER e LOWER, SUBSTR e INSTR, REPLACE, preenchimento, com…

Leia o artigo →
Bancos de dados e SQL

Explicação dos gatilhos SQL: gatilhos ANTES e DEPOIS, registros de auditoria e armadilhas

Gatilhos SQL explicados com gatilhos que executamos: ANTES vs DEPOIS, ANTIGO e NOVO, logs de auditoria, validação, atualizações de estoque, condiçõe…

Leia o artigo →
Desenvolvimento de software

Módulo JSON Python explicado: dumps, carregamentos, tipos personalizados e erros comuns

O módulo Python JSON explicado com o código que executamos: dumps e carregamentos, arquivos, conversões de tipo, datas e decimais, codificadores per…

Leia o artigo →
Desenvolvimento de software

Módulos ES vs CommonJS: como funcionam as importações de JavaScript em Node.js, testado

Módulos ES vs CommonJS explicados com código que executamos em Node.js: sintaxe de importação e exportação, require, vinculações ativas, cache, espe…

Leia o artigo →
Desenvolvimento de software

Python Regex explicado: padrões, grupos, antecipações e armadilhas, testados

Regex Python explicado com padrões que executamos: pesquisa vs correspondência, findall, grupos e grupos nomeados, ganancioso vs preguiçoso, sub, lo…

Leia o artigo →
Inteligência artificial

Explicação da saída estruturada do LLM: obtendo JSON confiável de modelos de IA

Saída estruturada do LLM explicada com validação que executamos no Pydantic: modo JSON e esquemas, decodificação restrita, formas de quebra de saída…

Leia o artigo →
DevOps

Chaves SSH explicadas: como funcionam, ssh-keygen, Ed25519 e hábitos seguros

Chaves SSH explicadas com chaves que geramos: chaves públicas versus privadas, ssh-keygen, Ed25519 versus RSA, impressões digitais, senhas, agente s…

Leia o artigo →
DevOps

Cache HTTP explicado: controle de cache, ETag e respostas 304, com um teste ao vivo

Cache HTTP explicado com um pequeno servidor que executamos: diretivas Cache-Control, idade máxima, sem cache vs sem armazenamento, revalidação de E…

Leia o artigo →
Automação de testes

Teste de contrato de API explicado: detecte alterações importantes antes de serem enviadas

O teste de contrato de API foi explicado com uma verificação de esquema que executamos: o que é um contrato, contratos orientados ao consumidor, Pac…

Leia o artigo →
Teste de software

Testes baseados em riscos explicados: avalie os riscos, construa uma matriz e teste o que é importante

Testes baseados em riscos explicados passo a passo: identificação de riscos, pontuação de probabilidade e impacto, construção de uma matriz de risco…

Leia o artigo →
Bancos de dados e SQL

Restrições SQL explicadas: NOT NULL, UNIQUE, CHECK e FOREIGN KEY, testadas

Restrições SQL explicadas com testes que executamos: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY e FOREIGN KEY, as lacunas NULL, configuração de chave…

Leia o artigo →
Bancos de dados e SQL

Funções de data SQL explicadas: adicionando, comparando e agrupando datas sem bugs

Funções de data SQL explicadas com consultas que executamos: adição de intervalos, surpresas de final de mês, diferenças de data, armadilha BETWEEN,…

Leia o artigo →
Desenvolvimento de software

Python assíncio explicado: assíncrono, espera, coleta e TaskGroup com Real Timings

Python asyncio explicado com código que cronometramos: corrotinas, espera, coleta, TaskGroup, tratamento de erros, tempos limite, limitação de simul…

Leia o artigo →
Desenvolvimento de software

Debounce vs Throttle em JavaScript: como funcionam, quando usar cada um, testado

Debounce vs. acelerador em JavaScript explicado com tempos que medimos em Node.js: como cada um funciona, implementações simples, chamadas iniciais …

Leia o artigo →
Desenvolvimento de software

Gerenciadores de contexto Python explicados: a instrução with, contextlib e usos reais

Os gerenciadores de contexto Python explicados com o código que executamos: como funciona, __enter__ e __exit__, contextlib.contextmanager, supressã…

Leia o artigo →
Inteligência artificial

Temperatura LLM e Top-p explicados: como os modelos de IA escolhem sua próxima palavra

Temperatura LLM e top-p explicados com uma simulação que executamos: como as probabilidades são remodeladas, o que top-p mantém, configurações recom…

Leia o artigo →
DevOps

YAML explicado: sintaxe, o problema da Noruega e outras armadilhas que testamos

YAML explicado com um teste de analisador: sintaxe básica, listas e mapas, o problema da Noruega, versões que se transformam em carros flutuantes, c…

Leia o artigo →
DevOps

Cron Jobs explicado: sintaxe, programações reais e os erros que os quebram

Cron jobs explicados com cronogramas que verificamos: os cinco campos, operadores, exemplos reais, a armadilha do dia do mês OU do dia da semana, pr…

Leia o artigo →
Inteligência artificial

Explicação das alucinações de IA: por que os modelos de linguagem inventam as coisas e como reduzi-las

Explicação das alucinações de IA: o que são, por que os modelos de linguagem as produzem, tipos comuns, como reduzi-las com aterramento e instruções…

Leia o artigo →
DevOps

Variáveis de ambiente explicadas: arquivos .env, segredos e configuração bem feitos

Variáveis de ambiente explicadas com exemplos de Python que executamos: leitura e configuração, por que cada valor é uma string, arquivos .env, hera…

Leia o artigo →
Desenvolvimento de software

Explicação da limitação de taxa de API: algoritmos, cabeçalhos e tratamento de erros 429

Limitação de taxa de API explicada com uma simulação que executamos: token bucket, janela fixa, janela deslizante, 429 respostas, cabeçalhos de limi…

Leia o artigo →
Automação de testes

Zombando em Python: unittest.mock, patch e os erros que fazem os testes mentirem

Zombaria em Python com unittest.mock, testado: Mock e return_value, side_effect, patch onde um nome é usado, especificação e autospec, zombaria de d…

Leia o artigo →
Teste de software

Cobertura de código explicada: cobertura de linha versus filial e o que 100% realmente significa

Cobertura de código explicada com uma execução cobertura.py real: cobertura de linha, ramal e condição, leitura de um relatório, por que 100% de cob…

Leia o artigo →
Bancos de dados e SQL

DELETE vs TRUNCATE vs DROP em SQL: diferenças, reversão e quando usar cada um

DELETE vs TRUNCATE vs DROP explicado com SQL testado: o que cada um remove, rollback, aciona, redefinição de identidade, velocidade e como PostgreSQ…

Leia o artigo →
Bancos de dados e SQL

Exibições SQL explicadas: crie, use e evite as armadilhas, com exemplos

Visualizações SQL explicadas com consultas que executamos: criação de uma visualização, resultados ao vivo, ocultação de colunas, desempenho, visual…

Leia o artigo →
Desenvolvimento de software

Interface TypeScript vs tipo: diferenças reais, testadas com o compilador

Interface TypeScript versus tipo, verificada com o compilador real: o que ambos podem fazer, o que apenas um pode fazer, mesclagem de declarações, e…

Leia o artigo →
Desenvolvimento de software

Python *args e **kwargs explicados: funções flexíveis com exemplos claros

Python *args e **kwargs explicados com o código que executamos: empacotamento e descompactação, ordem dos parâmetros, argumentos somente de palavras…

Leia o artigo →
Desenvolvimento de software

Funções Python Lambda: sintaxe, usos reais e quando não usá-los

Funções lambda do Python explicadas com o código que executamos: sintaxe, classificação com chave, mapa e filtro, fechamentos, armadilha de ligação …

Leia o artigo →
Inteligência artificial

O que são agentes de IA? Como eles funcionam, com um loop de agente simples que você pode executar

O que são agentes de IA? Um guia simples para o loop do agente, ferramentas, memória e proteções, com um pequeno loop Python que executamos, riscos …

Leia o artigo →
DevOps

Monitoramento versus observabilidade: a verdadeira diferença, com logs, métricas e rastreamentos

Explicação do monitoramento versus observabilidade: falhas conhecidas e desconhecidas, logs, métricas e rastreamentos, um passo a passo do incidente…

Leia o artigo →
DevOps

Docker Volumes vs Bind Mounts: persista os dados do contêiner da maneira certa

Volumes Docker versus montagens de ligação explicadas: por que os dados do contêiner desaparecem, volumes nomeados, montagens de ligação, tmpfs, exe…

Leia o artigo →
Automação de testes

TDD vs BDD: principais diferenças, um recurso criado de ambas as maneiras e quando usar cada um

TDD vs BDD explicado com um recurso de desconto construído em ambos os sentidos: refatoração vermelho-verde com o código que executamos, cenários da…

Leia o artigo →
Teste de software

Teste de aceitação do usuário (UAT): processo, lista de verificação e exemplos reais

Explicação do teste de aceitação do usuário: quem o executa, como ele difere do controle de qualidade, um processo de sete etapas, um modelo de caso…

Leia o artigo →
Bancos de dados e SQL

Valores SQL NULL explicados: IS NULL, COALESCE, NULLIF e as armadilhas a serem evitadas

Valores SQL NULL explicados com consultas que executamos: lógica de três valores, IS NULL, COALESCE, NULLIF, como agregações, junções e classificaçã…

Leia o artigo →
Bancos de dados e SQL

Instrução SQL CASE WHEN: sintaxe, exemplos reais e erros comuns

SQL CASE WHEN explicado com consultas que executamos: formulários simples e pesquisados, ordem de condição, pivôs com SUM, truques COUNT, classifica…

Leia o artigo →
Desenvolvimento de software

O que é JWT? JSON Web Tokens explicados com um exemplo prático

O que é JWT? JSON Web Tokens explicados: as três partes, um token construído e adulterado no código que executamos, JWT vs sessões, armazenamento, t…

Leia o artigo →
Desenvolvimento de software

Loop de eventos JavaScript explicado: pilha de chamadas, microtarefas e temporizadores com exemplos

O loop de eventos JavaScript explicado com o código que executamos: pilha de chamadas, filas de tarefas e microtarefas, por que setTimeout 0 não é i…

Leia o artigo →
Desenvolvimento de software

Geradores Python e rendimento explicado: economize memória com exemplos reais

Geradores Python e rendimento explicados com o código que executamos: como eles pausam e reiniciam, medem economia de memória, pipelines, sequências…

Leia o artigo →
Inteligência artificial

O que são incorporações? Similaridade de vetores e cossenos explicada de forma simples

O que são incorporações? Um guia em linguagem simples para vetores, similaridade de cossenos e pesquisa semântica, com um pequeno exemplo que execut…

Leia o artigo →
DevOps

Implantação azul-verde vs canário: diferenças, compensações e como escolher

Explicação da implantação azul-verde versus canário: como cada um funciona, custo, risco e reversão, agrupamento estável de usuários que testamos, m…

Leia o artigo →
Automação de testes

Testes instáveis: o que os causa e como corrigi-los para sempre

Testes instáveis explicados com demonstrações que executamos: as principais causas, como confirmar e diagnosticar uma, soluções adequadas para tempo…

Leia o artigo →
Teste de software

Teste de carga versus teste de estresse: diferenças, métricas e exemplos k6

Teste de carga versus teste de estresse explicado: o que cada um prova, testes de pico e absorção, as métricas que importam, por que as médias engan…

Leia o artigo →
Teste de software

Caso de teste versus cenário de teste: principais diferenças, exemplos e quando usar cada um

Caso de teste vs cenário de teste explicado: definições claras, uma tabela lado a lado, um recurso de redefinição de senha retirado de cenários para…

Leia o artigo →
Bancos de dados e SQL

Otimização de consultas SQL: leia planos de execução e corrija consultas lentas, com intervalos

Otimização de consulta SQL testada em um milhão de linhas: leia planos de execução, adicione os índices corretos, corrija filtros não sargáveis, use…

Leia o artigo →
Bancos de dados e SQL

SQL UNION vs UNION ALL: diferenças, exemplos e desempenho testado

SQL UNION vs UNION ALL explicado com consultas que executamos: duplicatas, as regras que ambos seguem, um bug de dados real, desempenho medido, INTE…

Leia o artigo →
Desenvolvimento de software

Tutorial da API JavaScript Fetch: GET, POST, tratamento de erros e tempos limite

Um tutorial da API JavaScript Fetch testado em um servidor local: GET e POST, por que 404 não lança, um auxiliar reutilizável, strings de consulta, …

Leia o artigo →
Desenvolvimento de software

Manipulação de arquivos Python: leitura, gravação, CSV, JSON e pathlib com exemplos

Manipulação de arquivos Python explicada com código que executamos: modos abertos, com, leitura de arquivos grandes, CSV, JSON, pathlib, arquivos bi…

Leia o artigo →
Desenvolvimento de software

Classes e objetos Python: tutorial OOP com exemplos reais

Classes e objetos Python explicados com código que executamos: __init__, métodos, atributos de classe vs instância, herança, propriedades, métodos d…

Leia o artigo →
Inteligência artificial

O que é um modelo de linguagem grande? Como funcionam os LLMs, explicado sem exageros

O que é um modelo de linguagem grande? LLMs explicados em linguagem simples: tokens, incorporações, atenção, treinamento, temperatura e janelas de c…

Leia o artigo →
DevOps

Comandos Linux para iniciantes: o guia essencial do terminal com exemplos

Comandos Linux para iniciantes, agrupados por tarefa: navegação, arquivos, visualização de logs, grep, pipes, permissões, processos e arquivos, com …

Leia o artigo →
Automação de testes

Selenium vs Playwright: principais diferenças, código comparado e qual escolher

Selenium vs Playwright comparado: arquitetura, espera, suporte a navegador e linguagem, depuração, o mesmo teste em ambas as ferramentas, conselhos …

Leia o artigo →
Teste de software

Particionamento de equivalência: técnica de design de teste explicada com exemplos resolvidos

Explicação do particionamento de equivalência: como encontrar partições válidas e inválidas, exemplos resolvidos para idades, senhas e cupons, teste…

Leia o artigo →
Teste de software

Gravidade vs Prioridade em Testes de Software: Diferenças, Matriz e Exemplos Reais

Explicação da gravidade versus prioridade em testes de software: definições claras, uma matriz de quatro vias com exemplos, escalas de nível, quem d…

Leia o artigo →
Bancos de dados e SQL

Tutorial de subconsultas SQL: tipos, subconsultas correlacionadas e EXISTS com exemplos

Um tutorial de subconsultas SQL com consultas que executamos: subconsultas escalares, IN, FROM e SELECT, subconsultas correlacionadas, EXISTS, a arm…

Leia o artigo →
Bancos de dados e SQL

Transações SQL e ACID explicados: COMMIT, ROLLBACK e níveis de isolamento

Transações SQL e ACID explicadas com uma transferência bancária que executamos: COMMIT, ROLLBACK, savepoints, locks, níveis de isolamento, leituras …

Leia o artigo →
Desenvolvimento de software

Folha de dicas dos comandos do Git: os comandos que você realmente usa, com exemplos

Uma folha de dicas de comandos Git agrupada por tarefa: configuração, preparação, ramificações, controles remotos, stash, histórico e desfazer erros…

Leia o artigo →
Desenvolvimento de software

Explicação das promessas de JavaScript: então, catch, Promise.all e erros comuns

Promessas JavaScript explicadas com o código que executamos: estados, cadeias then e catch, tratamento de erros, Promise.all, allSettled, race e any…

Leia o artigo →
Desenvolvimento de software

Tutorial do dicionário Python: métodos, exemplos e padrões comuns

Um tutorial de dicionário Python com código que executamos: criar, ler e atualizar dictos, métodos-chave, mesclagem, compreensão, padrões de contage…

Leia o artigo →
Inteligência artificial

O que é RAG? Geração aumentada de recuperação explicada com um exemplo prático

O que é RAG? Geração aumentada de recuperação explicada passo a passo: indexação, chunking, embeddings, recuperação, um pequeno exemplo funcional de…

Leia o artigo →
DevOps

Tutorial Terraform para iniciantes: infraestrutura como código do primeiro arquivo aos módulos

Um tutorial do Terraform para iniciantes: comece sem conta na nuvem, aprenda como iniciar, planejar e aplicar, depois variáveis, saídas, estado, mód…

Leia o artigo →
DevOps

Docker vs Kubernetes: principais diferenças, como eles funcionam juntos e o que você precisa

Docker vs Kubernetes explicado: o que cada um faz, o mesmo aplicativo rodando com ambos, Docker Compose e Swarm comparados, a mudança do dockershim …

Leia o artigo →
Automação de testes

Tutorial Pytest para iniciantes: luminárias, parametrização e exemplos reais

Um tutorial pytest para iniciantes com testes que executamos no pytest 9.2: asserções, fixtures, parametrizar, conftest, marcadores, tmp_path, monke…

Leia o artigo →
Teste de software

Ciclo de vida de teste de software (STLC): 6 fases, critérios de entrada e saída, exemplo

O ciclo de vida de teste de software explicou: seis fases do STLC com critérios de entrada e saída, resultados, um exemplo de recurso de login funci…

Leia o artigo →
Desenvolvimento de software

Git merge vs rebase: diferenças, exemplos e quando usar cada um

Git merge vs rebase explicado com saída real do log, uma tabela comparativa, a regra de ouro do rebase e um fluxo de trabalho seguro para equipes.

Leia o artigo →
Desenvolvimento de software

List comprehension em Python: sintaxe, exemplos e quando evitar

List comprehension em Python explicada: sintaxe, filtros, if-else, laços aninhados, tempos medidos e quando um laço for comum é a melhor escolha.

Leia o artigo →
Bancos de dados e SQL

SQL JOIN explicado com exemplos (Inner, Left, Right, Full)

Entenda os joins SQL passo a passo com tabelas e consultas de exemplo: INNER, LEFT, RIGHT, FULL, CROSS e SELF, além de erros comuns e dicas de desem…

Leia o artigo →