Tecnologia além do código.
Régys Borges da Silveira
Início / Acervo

Tag: engenharia de contexto

7 resultado(s)

Ilustração realista de uma pasta de projeto com uma pasta menor de módulo e documentos de orientação.

AGENTS.md na prática: como orientar a IA dentro de um projeto

A IA recebe uma tarefa de manutenção Delphi e sugere trocar uma dependência, alterar uma assinatura pública ou gravar dados durante uma análise. Você explica as restrições, e a conversa melhora.

Ver resumo completo

A IA recebe uma tarefa de manutenção Delphi e sugere trocar uma dependência, alterar uma assinatura pública ou gravar dados durante uma análise. Você explica as restrições, e a conversa melhora. Na próxima tarefa, precisa repetir o mesmo contexto. O problema não é somente a qualidade do pedido: os acordos do projeto ainda dependem de alguém lembrar de transmiti-los.

Um arquivo de orientações pode organizar esses acordos, desde que a ferramenta saiba onde encontrá-lo e a equipe saiba mantê-lo. Ele não deve reunir toda a documentação, todas as decisões antigas e todos os pedidos do histórico. Deve ajudar a trabalhar naquele ambiente, localizando referências relevantes e estabelecendo limites verificáveis.

Neste capítulo da série sobre instruções para IA, vamos construir um exemplo de AGENTS.md para um projeto Delphi fictício. Explicaremos raiz do projeto, módulo, precedência e conferência antes de usá-los. O comportamento de descoberta descrito aqui é o documentado para o Codex em 4 de outubro de 2026; não será apresentado como uma regra de todos os assistentes.

Se o desafio é explicitar comportamentos e conferir alterações, SDD em Delphi aprofunda especificações, contratos e critérios de aceite. Consulte o sumário e a degustação gratuita para avaliar como ligar essas orientações à implementação e aos testes. Um arquivo de instruções é mais útil quando participa desse entendimento, não quando funciona apenas como uma lista de preferências.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração de duas folhas: texto corrido e conteúdo organizado em títulos e listas.

Como escrever um arquivo Markdown que humanos e IA consigam usar

Você tem as informações necessárias para orientar uma revisão, mas elas estão num parágrafo que mistura objetivo, regras, exceções e resultado esperado. Quem lê precisa reconstruir essa organização mentalmente.

Ver resumo completo

Você tem as informações necessárias para orientar uma revisão, mas elas estão num parágrafo que mistura objetivo, regras, exceções e resultado esperado. Quem lê precisa reconstruir essa organização mentalmente. Quando o documento cresce, surgem referências vagas, instruções repetidas e dúvidas sobre o que realmente deve ser feito. Trocar a extensão do arquivo não resolve essa dificuldade.

Markdown ajuda a organizar texto sem exigir um editor sofisticado. Ele permite indicar títulos, listas, links e trechos de código usando caracteres comuns. Mas a qualidade do arquivo depende também de decisões de escrita: explicar o contexto, separar responsabilidades e oferecer critérios que permitam conferir o trabalho. Formatação e entendimento precisam caminhar juntos.

Neste segundo capítulo da série sobre instruções para IA, vamos aprender a sintaxe essencial e aplicá-la ao exemplo fictício de revisão de uma importação Delphi. O objetivo não é decorar todos os recursos do formato, mas construir um documento que uma pessoa consiga revisar e uma ferramenta consiga apresentar de forma previsível. Também veremos os limites desse cuidado.

Para aprofundar a passagem de uma solicitação vaga para requisitos, contratos e critérios de aceite, conheça SDD em Delphi. O sumário e a degustação gratuita ajudam a avaliar esse método antes de escolher a edição. A conexão com este capítulo é direta: um arquivo bem apresentado só ganha valor técnico quando registra um entendimento verificável.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração realista de uma mesa com pedido avulso, regras de projeto, manual de referência e procedimento de revisão.

Prompt, instrução, referência ou skill: onde colocar cada informação para a IA

Você pede à inteligência artificial que revise uma rotina de importação. Acrescenta as regras de negócio, explica como executar os testes, cola uma página de documentação e lembra que ela não deve gravar no banco.

Ver resumo completo

Você pede à inteligência artificial que revise uma rotina de importação. Acrescenta as regras de negócio, explica como executar os testes, cola uma página de documentação e lembra que ela não deve gravar no banco. Na revisão seguinte, monta quase a mesma mensagem. Depois de algumas semanas, existem versões diferentes dessas orientações, e ninguém sabe qual delas continua válida.

O problema não começa na falta de um arquivo especial. Começa quando informações com funções diferentes são tratadas como se fossem uma única mensagem. Um pedido descreve o trabalho de agora; uma regra orienta o projeto; um documento fornece evidência; um procedimento organiza uma tarefa repetível. Separar essas funções ajuda tanto o leitor humano quanto o assistente que recebe o contexto.

Este artigo abre a série sobre instruções para IA, do Markdown às skills. Vamos construir essas distinções usando uma manutenção Delphi fictícia, mostrar onde cada informação pode ficar e propor um exercício de organização. Não é preciso conhecer agentes ou formatos de arquivos para acompanhar. Os exemplos são propostas didáticas, não resultados medidos de uma integração.

Quando a dificuldade é transformar uma intenção em regras e critérios verificáveis, SDD em Delphi oferece um aprofundamento em especificações, contratos e rastreabilidade. Consulte o sumário e a degustação gratuita para avaliar esse percurso. Para estudar as camadas de contexto, ferramentas e operação ao redor do modelo, a leitura complementar é IA Além da Conversa.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração conceitual de um núcleo ligado a documentos, ferramentas e verificação por um ciclo de trabalho.

Harness de IA: o que faz um modelo virar um agente capaz de trabalhar

Uma IA pode explicar uma rotina Delphi com clareza e ainda assim não conseguir conduzir sua correção até uma entrega confiável. Entre compreender o pedido e terminar o trabalho existem arquivos a localizar, ações a autorizar, testes a executar e resultados a conferir.

Ver resumo completo

Uma IA pode explicar uma rotina Delphi com clareza e ainda assim não conseguir conduzir sua correção até uma entrega confiável. Entre compreender o pedido e terminar o trabalho existem arquivos a localizar, ações a autorizar, testes a executar e resultados a conferir. Quando a tarefa demora, aparece outra dificuldade: retomar o que estava acontecendo sem confundir intenção com progresso.

É nesse espaço que entra o harness de agentes de IA. O termo parece acrescentar mais uma sigla ao vocabulário, mas descreve uma questão bastante familiar a quem desenvolve sistemas: como organizar a execução ao redor de um componente que, sozinho, não resolve todo o processo? Neste artigo, vamos construir o conceito, distinguir suas peças e acompanhar exemplos de programação e trabalho cotidiano.

Este é um capítulo complementar de síntese da série IA na prática. Em vez de repetir cada tecnologia, vamos entender como contexto, ferramentas, validação e continuidade podem compor uma estrutura de trabalho. Os exemplos são propostas didáticas, não integrações executadas nem resultados medidos em um produto.

Se sua dúvida é como transformar uma boa resposta em uma solução que a equipe consiga operar, IA Além da Conversa desenvolve esse percurso: contexto, recuperação de informações, ferramentas, permissões, avaliação e custos. Conheça a proposta e leia a degustação gratuita na página do livro para avaliar se essa abordagem atende ao seu projeto. Para o passo seguinte, conectar capacidades de um ERP em Object Pascal, Delphi na Era dos Agentes apresenta um laboratório com servidor MCP local e MiniERP educacional.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração conceitual de um documento selecionado entre pastas e associado a uma resposta com referências.

RAG na prática: como fazer a IA responder usando os documentos da empresa

Um colaborador pergunta como solicitar a devolução de uma mercadoria. A inteligência artificial responde com segurança, enumera etapas e parece conhecer o procedimento.

Ver resumo completo

Um colaborador pergunta como solicitar a devolução de uma mercadoria. A inteligência artificial responde com segurança, enumera etapas e parece conhecer o procedimento. O problema aparece quando alguém compara a orientação com o manual da empresa: o prazo está errado e uma aprovação obrigatória desapareceu. Uma resposta bem escrita não é necessariamente uma resposta baseada na regra que realmente vale.

Depois de discutir contexto, testes e infraestrutura nesta série, chegamos ao uso de documentos internos. Este capítulo explica o conceito de RAG, acompanha o caminho entre a pergunta e a resposta e apresenta um exemplo fictício de atendimento. O objetivo não é escolher uma ferramenta por entusiasmo, mas entender quais condições permitem consultar informações empresariais com evidência e controle.

Disponibilizar documentos é apenas o começo: a aplicação precisa selecionar evidências, respeitar permissões e avaliar se a resposta corresponde à fonte. IA Além da Conversa aprofunda a recuperação de informações e sua relação com contexto, ferramentas e operação. Conheça a proposta e leia a degustação gratuita para avaliar como organizar essas decisões no seu projeto. Para outra pergunta — como um modelo aprende e gera texto — Do Zero ao LLM com Delphi oferece um laboratório educacional em Object Pascal. Recuperar conhecimento externo e estudar o treinamento de uma rede são percursos diferentes.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração conceitual de documentos selecionados e organizados para preparar uma tarefa de desenvolvimento.

Engenharia de contexto: por que um bom prompt não basta para programar com IA

A inteligência artificial sugere uma solução elegante, mas usa uma biblioteca que o projeto não possui, ignora uma regra existente ou altera o módulo errado. A reação mais comum é reformular o pedido, trocar de modelo ou aumentar o esforço de raciocínio.

Ver resumo completo

A inteligência artificial sugere uma solução elegante, mas usa uma biblioteca que o projeto não possui, ignora uma regra existente ou altera o módulo errado. A reação mais comum é reformular o pedido, trocar de modelo ou aumentar o esforço de raciocínio. Antes disso, vale uma pergunta: quais informações estavam disponíveis quando a resposta foi produzida?

Este é o segundo artigo da série IA na prática: do protótipo à operação responsável. Depois de separar experimentação e desenvolvimento controlado, o próximo passo é organizar aquilo que o modelo precisa saber. Vamos explicar engenharia de contexto, aplicar o conceito a uma tarefa Delphi e propor um modo de manter informações úteis sem transformar cada pedido em um arquivo gigantesco.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração conceitual de coordenação na nuvem conectada a tarefas de pesquisa e código com revisão humana.

Dot da OpenAI para delegar trabalho contínuo e integrar tarefas ao Codex

Um problema de desenvolvimento raramente termina na primeira conversa. Um cliente envia outro detalhe, uma dependência muda ou o teste revela uma condição diferente da prevista.

Ver resumo completo

Um problema de desenvolvimento raramente termina na primeira conversa. Um cliente envia outro detalhe, uma dependência muda ou o teste revela uma condição diferente da prevista. A tarefa passa a incluir não apenas produzir uma resposta, mas acompanhar o que falta, reunir novas informações e reconhecer quando uma decisão precisa voltar ao responsável.

É nesse espaço que entra o Dot da OpenAI. A novidade interessa menos pela aparência personalizável e mais pela proposta de continuidade: atribuir uma responsabilidade à IA e acompanhar sua evolução entre conversas. Isso pode ajudar no desenvolvimento e nas rotinas profissionais, desde que continuidade não seja confundida com autorização irrestrita.

Neste artigo, explico o conceito, sua relação com o Codex, onde o trabalho acontece e como formular uma primeira delegação. Os exemplos são propostas didáticas, não relatos de uma implantação testada. Disponibilidade e comportamento foram conferidos na documentação em 5 de outubro de 2026 e podem mudar.

Publicado em · Régys Borges da Silveira
Ler artigo →