Glossário

Todos os termos que o programa usa, em linguagem simples.

É a primeira vez? Lê a primeira lição. Não precisas de conta.

Conceitos de IA

Agent: Um sistema de IA que dá vários passos por iniciativa própria em direção a um objetivo, escolhendo tools e adaptando-se pelo caminho.
AGI: Inteligência artificial geral: uma IA hipotética tão capaz como uma pessoa na maioria das tarefas. Muito discutida, ainda não chegou.
Closed model: Um modelo proprietário a que só chegas pela API ou pela aplicação de quem o fornece.
Coding agent: Um assistente de IA com mãos. Lê ficheiros, edita-os e corre comandos, verificando os resultados à medida que avança.
Compaction: Resumir as partes mais antigas de uma conversa para libertar espaço no context window.
Completion / response: O que o modelo devolve depois do teu prompt.
Context: Tudo o que o modelo consegue ver neste momento: o teu prompt, a conversa, os anexos e as notas que lhe forem injetadas.
Context rot: Uma falha do ciclo em que o histórico cresce até o sinal se perder no ruído. Resolve-se resumindo os turnos antigos e fixando o objetivo.
Context window: O máximo de tokens que um modelo consegue ter em mente de uma vez: o teu prompt mais tudo o que já leu.
Corpus de origem: Onde vive a verdade num sistema de RAG: as páginas, os documentos, os contratos ou os tickets antigos de onde se recupera.
Embedding: Uma representação numérica de texto que deixa um sistema pesquisar por significado em vez de por palavras exatas.
Embedding models: Modelos que transformam texto em números para os tools o poderem pesquisar por significado. Trabalham nos bastidores dos assistentes ligados aos teus documentos.
Fine-tuning: Training extra e especializado por cima de um modelo base — afinar o modelo com dados próprios para encaixar num caso de uso concreto.
Frontier model: O maior, o mais recente e o mais capaz dos modelos que um fornecedor oferece.
Generation: O último passo do RAG: meter os pedaços recuperados no prompt e deixar a IA responder a partir desse context.
Gradient descent: O processo de training em que o modelo vai ajustando devagar milhares de milhões de parâmetros internos até acertar bem na palavra seguinte.
Inference: Cada vez que usas o modelo de facto. Envias um prompt, ele corre pelos parâmetros já congelados e produz um resultado.
LLM: Modelo de linguagem de grande dimensão, a tecnologia por trás dos assistentes de chat como o ChatGPT, o Gemini e o Claude.
Long context: Quanto é que um assistente aguenta numa só conversa. Um long context leva de uma vez o equivalente a uma pequena biblioteca.
MCP (Model Context Protocol): Uma forma normalizada de as aplicações de IA se ligarem a tools, dados e serviços externos. Pensa em USB para IA.
Memory: Uma funcionalidade que guarda factos escolhidos sobre ti e os volta a pôr no context no início das conversas seguintes.
Modelos de imagem: Modelos que geram imagens a partir de descrições em texto, como o DALL-E, o Midjourney ou o Stable Diffusion.
Modelos de voz: Modelos que convertem voz em texto e texto em voz, como o Whisper para transcrição e o ElevenLabs para síntese de voz.
Multimodal: Modelos que lidam com mais do que texto: imagens e, às vezes, áudio ou vídeo.
Open weights: Um modelo cujos parâmetros podes descarregar e correr por tua conta.
Previsão da palavra seguinte: Como um LLM funciona no essencial. Prevê a palavra seguinte mais provável, vezes sem conta, até formar uma resposta útil.
RAG (Retrieval-Augmented Generation): O sistema pesquisa primeiro nos teus documentos ou na web, e só depois o modelo responde a partir do que encontrou.
Session: Uma conversa contínua. Um chat novo começa com o context vazio.
System prompt: Instruções que definem o papel e as regras da IA no início de uma conversa.
Token: Os pequenos pedaços de texto que um assistente lê e escreve, cada um com cerca de três quartos de uma palavra. O comprimento e o custo contam-se em tokens.
Tool: Uma ligação que deixa a IA fazer algo mais do que escrever texto: pesquisar, calcular ou chegar a outro sistema.
Training: O processo caro e único em que um modelo aprende padrões a partir de enormes quantidades de texto. É quem fornece o modelo que o faz, não tu.
Training cutoff: A data a partir da qual o modelo não sabe nada pelo training, por isso perde tudo o que veio depois a não ser que lho contes.

Prompting e técnicas

Camada sempre ativa: O pequeno conjunto de coisas que é lido em cada turno: as restrições rígidas, as regras da casa e a tarefa em curso.
Carregamento a pedido: Carregar esquemas, especificações, manuais ou documentos só quando a tarefa precisa deles, indo buscá-los pelo nome.
Chain (prompt chaining): Uma sequência de prompts em que o resultado de cada um passa a ser a entrada do seguinte. Tu geres o chain; a IA corre cada etapa.
Chain of thought: Pedir ao modelo que raciocine passo a passo antes de responder, o que melhora a exatidão em problemas de vários passos.
Chunking: Partir um corpus em pedaços pequenos (256 a 512 tokens, com 10 a 20% de sobreposição) para poderem ser recuperados.
Decomposição do processo: Partir em passos um processo que atravessa várias equipas e decidir quais são de IA, quais são determinísticos e quais precisam de uma pessoa.
Determinismo vs. critério: Determinismo é um passo dar sempre o mesmo resultado. Critério é um passo poder variar de forma legítima. Marca cada etapa com o que ela é.
Diário de prompts: Uma coleção guardada dos prompts que funcionaram, que cresce com o tempo até se tornar uma biblioteca de templates para o teu trabalho.
Empilhar papéis: Fazer a IA analisar a mesma coisa por vários pontos de vista de especialista, um a um, e depois sintetizar uma única recomendação.
Entrega (a costura): O momento em que o resultado de um passo passa a ser a entrada do seguinte. É aqui que a maioria dos chains se parte, por isso põe verificações na costura.
Few-shot: Dar ao modelo alguns exemplos do padrão de entrada e resultado que queres. Aumenta muito a fiabilidade.
Formato do resultado: Manter os resultados intermédios legíveis por programas: tabelas, JSON, campos consistentes. Prosa livre parte os chains.
Meta-prompting: Pedir à IA que critique e reescreva o teu prompt para que produza resultados mais fiáveis.
Método dos quatro elementos: A estrutura de prompt mais fiável: papel, context, tarefa e formato (também conhecida por CRAFT ou RCTF).
Passo de IA: Um passo do processo que exige critério, porque varia com a entrada. É aqui que vale a pena gastar o teu orçamento de IA.
Passo determinístico: Um passo do processo resolvido por lógica fixa: uma fórmula, uma propriedade da base de dados ou um script.
Persona: Atribuir um papel ao modelo para lhe subir a fasquia de qualidade. Molda a forma como o modelo responde, mas não muda se a resposta está certa.
Persona prompts: Dar um papel a cada etapa: um assistente jurídico, um responsável de conformidade. A persona muda o vocabulário, a profundidade e o tom.
Planear e só depois executar: Pedir ao modelo que planeie e assinale as lacunas primeiro, e só depois produza o resultado, para não tapar as lacunas com suposições.
Pré-preencher a resposta: Começares tu a resposta da IA. Fixa o formato e o tom, e reduz o drift.
Progressive disclosure: Carregar pouco sempre e o resto só quando for relevante. Mantém a camada sempre ativa pequena.
Prompt: O que escreves a um assistente. Prompting é a arte de pedir bem.
Prompting em vários passos: Parte o trabalho em etapas em vez de um prompt gigante. Cada etapa produz um resultado limpo e com nome, que a seguinte usa.
Refinamento iterativo: Tratar a IA como uma conversa e ir melhorando o resultado ao longo de algumas voltas, em vez de esperar que o primeiro rascunho saia perfeito.
Regra de ouro: Dá à IA o máximo de context possível, sempre. Entradas melhores dão melhores resultados, de forma fiável.
Restrições negativas: Dizer à IA o que não deve fazer. Contraria as predefinições dela e muitas vezes é mais fácil do que descrever aquilo que queres.
Retrieval: Escolher os pedaços certos para um determinado pedido. Retrieval híbrido (semântica mais palavras-chave) com um reranker é o que se usa em produção.
Structured outputs: Pedir um esquema concreto, como JSON ou uma tabela, para o resultado ficar claro e fácil de reaproveitar por outros tools.
Zero-shot: Pedir uma tarefa ao modelo sem lhe dar exemplos. Serve bem para tarefas simples e conhecidas.

Construir e lançar

A regra de construir: Quando te vires a fazer o mesmo trabalho duas vezes, constrói-o como agent, para que à terceira corra sozinho.
Agent loop: O ciclo de execução: ler o context, decidir, chamar um tool, ler o resultado, decidir outra vez, até a tarefa estar feita.
AGENTS.md: O ficheiro de instruções que virou norma entre tools. Põe aqui as tuas convenções, como fonte única de verdade.
Anatomia de um briefing: As peças de que um bom briefing de agent precisa: papel, trigger, entradas, passos, formato do resultado e guardrails.
Branch: Uma linha de trabalho paralela dentro do mesmo repo. Experimentas numa branch sem incomodar a principal.
Changelog: Uma nota curta e corrida no fim de um briefing, a registar o que mudou em cada versão, para os outros verem como ele evoluiu.
Checkout: Mudar a tua pasta de trabalho para mostrar uma determinada branch ou commit. Mesmo repo, outra vista.
CLAUDE.md: O ficheiro de instruções do Claude Code, na raiz do projeto ou em ~/.claude para valer em tudo. Muitas vezes é só um ponteiro para o AGENTS.md.
Cobertura: Uma das forças em tensão no design de um harness: dar ao modelo o suficiente para agir bem. Se lhe deres pouco, adivinha ou inventa uma API.
Commit: Uma alteração guardada, com uma nota a dizer o quê e porquê. O histórico de um repo é uma cadeia de commits.
Context budget: Tratar o context window como um orçamento que distribuis de propósito, gastando o máximo naquilo que muda a resposta.
Context escondido: Os system prompts, os ficheiros de referência, o histórico da conversa e os pedaços recuperados gastam todos tokens em cada execução.
Costura: O ponto onde a informação passa de uma pessoa, equipa ou sistema para o seguinte. As costuras deixam fugir tempo e qualidade.
Custo: O preço de cada token em dinheiro, em latência e em atenção diluída.
Custo por resultado útil: O gasto total dividido pelos resultados que não precisaram de ser refeitos. É a métrica de gasto a interiorizar.
Deferred tools: Listar os tools por nome e deixar o modelo ir buscar a definição completa quando precisar, para manter o context leve.
Edge cases: Entradas válidas mas fora do comum. Um briefing tem de dizer o que fazer com campos em falta, contradições e dados sensíveis.
Entradas de confiança: Entradas já validadas a montante, como uma linha de base de dados com esquema obrigatório. Podes agir sobre elas.
Etapa de validação: A primeira etapa do chain, que confirma se cada campo obrigatório está presente e válido. Se uma verificação falhar, para e chama uma pessoa.
Falha de design: Uma falha que vem da arquitetura do fluxo de trabalho. A correção é voltar a dividir as etapas ou redesenhá-lo.
Ficheiro de instruções: Um ficheiro com as regras permanentes que um agent lê antes de começar a trabalhar. AGENTS.md é o nome mais comum.
Ficheiros de referência: Documentos estáveis (regulamentos, guias de estilo, glossários) anexados a um assistente à medida, para ele raciocinar sempre com eles.
Forking: Copiar o agent ou assistente que outra pessoa partilhou e adaptá-lo, herdando as lições que quem o escreveu já aprendeu.
Format drift: A IA devolve o resultado numa forma ligeiramente diferente da que foi pedida, e parte tudo o que a jusante contava com o formato exato.
Frontmatter: Um pequeno bloco de YAML no topo de um ficheiro, com informação sobre o próprio ficheiro.
Harness: Tudo o que constróis à volta de um modelo: o context que lhe dás, os tools que ele pode chamar e o ciclo em que corre.
Idempotency: Um agent é idempotente se correr duas vezes sobre a mesma entrada for seguro. Produz o mesmo resultado ou não faz nada.
Infraestrutura (vs. tool): Uma construção de que muita gente depende. A essa escala precisa de um responsável com nome, comportamento documentado, HITL gates e um plano de manutenção.
Limitação do modelo: Uma falha em que a IA não é suficientemente fiável naquela tarefa. A correção é uma verificação determinística ou um HITL gate mais apertado.
Limite de orçamento: Uma condição de paragem que põe um teto rígido no número de turnos, de tokens ou de chamadas a tools.
Mapa das costuras: Um mapa das entregas de um processo: quem entrega, quem recebe, o que se perde, quanto tempo custa e onde a IA podia encaixar.
Merge: Juntar as alterações de uma branch de volta à linha principal quando já estão prontas.
Níveis de maturidade: Etiquetas para os fluxos de trabalho partilhados: por tua conta e risco, destacado (revisto) e oficial (mantido, ao nível de produção).
O peso do resultado: Os tokens de saída custam tipicamente 3 a 5 vezes mais do que os de entrada, por isso uma predefinição verbosa multiplica o gasto num instante.
Output schema: Uma definição escrita e precisa dos campos e dos tipos de um resultado, fixada antes de escreveres o prompt.
Plano de manutenção: Um documento curto com o nome do responsável, de quem o substitui, a cadência de revisão, os modos de falha conhecidos e a forma de testar alterações.
Pronto para produção: Um fluxo de trabalho testado com entradas reais, com os modos de falha e os HITL gates escritos no briefing, documentado, com responsável e com registo para se detetar o drift.
Pull request: Um conjunto de commits proposto para revisão antes de entrar na linha principal.
Recall: Com que fiabilidade o modelo cumpre uma determinada regra. Regras enterradas no meio de um long context passam-lhe ao lado.
Regra das 50 entradas: Testa um agent com 50 entradas reais e diferentes antes de confiares nele para correr sem supervisão. Categoriza cada falha.
Repository (repo): Uma pasta de projeto com memória: os ficheiros, os testes e um registo de cada alteração, por isso nada se perde a sério.
Skill: Um conjunto de instruções e material de referência que ensina um assistente a fazer bem um trabalho, reutilizável em todos os chats seguintes.
SKILL.md: O único ficheiro obrigatório de uma skill: frontmatter YAML no topo, com nome e descrição, e o procedimento no corpo.
Symlink: Um ficheiro-atalho que aponta para outro ficheiro, para que uma só cópia real apareça em vários sítios.
Templates com variáveis: Os briefings de produção são templates com variáveis com nome, o que os torna inspecionáveis, versionáveis e passíveis de fork.
Terminal (shell): A janela de texto onde escreves comandos em vez de clicar em botões. É aqui que vivem os coding agents.
Test suite: As verificações que um projeto faz a si próprio, corridas por um único comando que diz se passou ou falhou.
Teste de objetivo: Uma condição de paragem que o agent corre em vez de afirmar: a compilação passa, ou o endpoint devolve 200.
Triggers: Como é que um agent arranca: por agendamento, a pedido ou a partir de um evento, como uma linha nova numa base de dados.
Utilizável vs. rigoroso: Utilizável quer dizer que as etapas seguintes conseguem ler o resultado. Rigoroso quer dizer que o conteúdo está certo. Interessam os dois.
Vibe coding: Construir uma coisa descrevendo por palavras simples o que queres e deixar a IA escrever o código, guiando-te pela intuição.
Worktree: Uma segunda cópia de trabalho do mesmo repo, na sua própria pasta e com a sua própria branch, para que dois trabalhos nunca se pisem.
YAML: Configurações escritas como linhas etiquetadas, do género name: pdf-export. Lê-se como um formulário e não como código.

Risco e segurança

A regra inegociável: Nunca coles dados bancários, credenciais, documentos de identificação nem nada que seja privado e não seja teu num tool de IA genérico.
Ações sempre com HITL: Coisas que precisam sempre da aprovação de uma pessoa: dinheiro, saúde, segurança, contratos, condições legais, submissões ao Estado e situação legal de alguém.
Adversarial testing: Dar de propósito a um agent entradas capciosas, contraditórias, incompletas ou maliciosas durante os testes, para descobrir onde é que ele se parte.
Adversarial verification: Separar quem faz de quem julga. Uma passagem cria, outra ataca com ordens para refutar, e só entra em produção o que sobreviver.
AI slop: Texto ou imagens de IA feitos em massa e sem esforço nenhum. É aquilo que um bom prompting evita.
Audit logs: Um registo de cada chamada a um tool MCP, com data e hora, quem chamou, com que scope e com que resultado. É o que consultas para saber o que a IA fez.
Blast radius: O alcance dos sistemas que um agent pode afetar se algo correr mal. Um agent ligado a mais coisas precisa de gates mais apertados.
Confidence calibration: Fazer a IA classificar a sua própria confiança (alta, média, baixa) com uma justificação, para saberes que resultados precisam de revisão.
Drift: Quando os resultados do modelo se degradam devagar porque o padrão das entradas mudou. É silencioso, e só se vê ao olhar para muitos resultados.
Drift (loop): Uma falha do ciclo em que o agent se esquece do objetivo e passa a otimizar uma subtarefa. Repete o objetivo perto do fim do context.
Errado com toda a convicção: Uma resposta que soa a autoridade mas está errada de forma subtil, e com o mesmo tom das respostas certas.
Guardrails: Regras e verificações que impedem a IA de fazer coisas arriscadas.
Hallucination: Quando um assistente afirma algo falso com toda a convicção. Vale sempre a pena confirmar.
Higiene de dados: Os hábitos de lidar com informação privada quando usas IA. Deixa os dados sensíveis onde eles vivem em vez de os colares num tool que não controlas.
HITL gate: Um gate com uma pessoa no circuito (human-in-the-loop), onde alguém revê antes de o agent agir. Obrigatório em ações irreversíveis ou de confiança baixa.
Human-in-the-loop (HITL): Uma pessoa revê ou aprova o resultado da IA antes de qualquer ação, sobretudo em passos regulados, irreversíveis ou de grande impacto.
Jailbreak: Um prompt feito para contornar os guardrails de uma IA. Não tentes: eles protegem-te a ti e aos outros.
Mínimo de confiança: Um limite abaixo do qual o agent para e encaminha para uma pessoa em vez de agir.
Não avança: Uma falha do ciclo em que o agent repete a mesma ação que falha. Resolve-se registando o que já foi tentado e limitando as tentativas.
Paragem errada: Uma falha do ciclo em que o agent desiste cedo ou nunca desiste. Resolve-se com um teste de paragem explícito.
Pausa automática: Um disjuntor que trava o agent quando a exatidão medida por amostragem cai abaixo de um limite definido, até uma pessoa o voltar a ligar.
Prompt injection: Instruções maliciosas escondidas dentro de conteúdo que a IA lê, a tentar desviá-la do que estava a fazer.
Revocation: Retirar os scopes de uma ligação MCP quando o fluxo de trabalho é desativado, para não se acumularem ligações adormecidas.
Scopes: Permissões por ação que um servidor MCP expõe, como read_employees separado de update_employee. Concede só o mínimo.
Verificação por amostragem: Rever tu mesmo uma parte dos resultados de um fluxo de trabalho, 10% por exemplo.
Via de escalonamento: O caminho definido para um caso assinalado: quem é avisado, como e com que context. Todos os HITL gates precisam de um.

Tools e assistentes

Agent integrado no workspace: Um agent que vive dentro de um tool como o Notion, a ler e a escrever nas suas páginas e bases de dados.
AI agent: Um briefing guardado que corre um trabalho recorrente por sua conta: por agendamento, a pedido ou a partir de um evento.
Artifacts: Uma funcionalidade do Claude que gera código, documentos, apresentações e resultados interativos num painel lateral editável.
Assistente de IA: O teu tool de chat autónomo: ChatGPT, Gemini, Claude ou Grok. É reativo: perguntas, ele responde.
Assistente guardado (reutilizável): Um assistente à medida que configuras uma vez e reutilizas, como um Custom GPT, um Gem ou um Claude Project.
Assistente integrado (na aplicação): IA que vive dentro de uma aplicação que já usas, como o Gmail, o Notion ou o Word. Atua sobre a página que tens aberta.
ChatGPT: O assistente da OpenAI, gratuito em chatgpt.com. Um todo-o-terreno de confiança, com a maior comunidade de utilizadores.
Claude: O assistente da Anthropic, gratuito em claude.ai. Forte em escrita longa, análise pesada de documentos e raciocínio difícil.
Claude Projects: Workspaces persistentes do Claude que guardam documentos de referência que o Claude tem em conta em todas as conversas.
Co-pilot: IA que trabalha ao teu lado dentro de um tool, a sugerir enquanto avanças, com o controlo sempre do teu lado.
Connectors: Ligações que deixam o Claude chegar a tools como o Drive, o Gmail, o Slack, o GitHub e o Linear, com a tua autorização.
Custom GPTs: Os assistentes guardados e reutilizáveis do ChatGPT: configuras uma vez e voltas a usar sempre.
Deep Research: Um modo que corre uma investigação demorada em várias fontes e devolve um relatório escrito, com as fontes citadas.
Gemini: O assistente da Google, gratuito em gemini.google.com. O mais forte quando a entrada é grande, mista ou visual, e corre dentro do Google Workspace.
Gems: Os assistentes à medida, guardados e reutilizáveis do Gemini: configuras uma vez e voltas a usar sempre.
Grok: O assistente da xAI, gratuito em grok.com. Ligado ao X e à web em tempo real, é o melhor atualmente.
Plataforma de automação: Um tool sem código, como o Zapier ou o Make, que copia dados entre aplicações de forma agendada.

Trabalhar com IA

A mentalidade 100×: O ritmo novo: meses passam a dias, dias passam a horas. Quando o custo cai 100 vezes, coisas novas passam a ser possíveis.
A regra dos 80%: Começa sempre pelo teu assistente de IA. O tool que vive dentro da aplicação é um atalho jeitoso que podes dispensar.
Agora somos todos construtores: Quem constrói um fluxo de trabalho com IA é um construtor, seja qual for o cargo que tem.
AI-pilled: Conquistado pela IA. Assim que te cai a ficha numa tarefa, começas a recorrer-lhe para tudo. Diz-se quase sempre em tom de brincadeira.
Cruzar as respostas: Fazer a mesma pergunta importante em dois tools e comparar. Se concordarem, ganhas confiança; se divergirem, tens ali algo para investigar.
Fluência em IA: A capacidade de trabalhar com IA, construir com ela e pensar ao lado dela. A competência com maior retorno da década.
O trabalho tem de desaparecer: A ideia de que a IA deve apagar categorias inteiras de trabalho, eliminando tarefas de vez.
Pensar primeiro na IA: Passar meio minuto em cada tarefa nova a pensar em como a IA poderia ajudar, antes de a fazer à mão.
Reaprender a aprender: A meta-competência de continuar a aprender à medida que a perícia antiga vai sendo automatizada. É a nova vantagem duradoura.