Como preparar a informação de um assistente de IA
Um assistente de IA precisa de informação aprovada, condições claras e limites de acesso. Carregar documentos é apenas uma etapa. Este guia mostra como transformar informação dispersa numa base de conhecimento que permita responder, apresentar a fonte e encaminhar as perguntas que precisam de uma pessoa.
No final, consegue:
- Organizar fontes e responsáveis
- Definir permissões e encaminhamento
- Testar respostas antes de disponibilizar
Comece pelas perguntas que o assistente deve resolver
Escolha uma tarefa concreta: explicar serviços, ajudar a usar um produto ou consultar informação de uma encomenda autenticada. Liste perguntas frequentes, decisões permitidas e assuntos que exigem encaminhamento. Responder sobre um serviço, consultar uma conta e alterar uma encomenda exigem capacidades e autorizações diferentes.
Numa arquitetura RAG, o sistema procura informação relevante e fornece esse contexto ao modelo para preparar a resposta. Isso não equivale a treinar o modelo com todos os documentos. A documentação da Microsoft descreve este percurso. O método ajuda a consultar fontes próprias, mas continua a precisar de testes de recuperação, resposta e acesso.
Atribua um responsável e uma validade a cada fonte
Faça um inventário antes da importação. Registe o assunto, proprietário, estado de aprovação, público autorizado, versão e condições de validade. Um documento sem responsável pode permanecer tecnicamente acessível depois de deixar de representar a operação.
Defina a precedência por assunto. Para condições comerciais, a fonte aprovada para essa finalidade prevalece sobre uma apresentação antiga. A data de modificação do ficheiro, por si só, não resolve um conflito. Se duas fontes aprovadas discordarem, suspenda a resposta afetada e peça uma decisão ao responsável.
| Fonte | Decisão editorial | Acesso |
|---|---|---|
| Catálogo aprovado | Indexar com versão e responsável | Público, se o catálogo for público |
| Campanha terminada | Retirar da informação comercial corrente | Arquivo separado, se necessário |
| Procedimento interno | Confirmar aprovação e âmbito | Grupo de trabalho autorizado |
| Dados de uma encomenda | Consultar no sistema responsável | Cliente autenticado e autorizado |
Escreva unidades de conhecimento completas
Cada unidade deve juntar a resposta com as condições e exceções que a tornam correta. Preserve títulos, listas e relações entre células de tabelas. Se um PDF foi digitalizado, confirme a leitura de valores e símbolos após a extração. Um erro de extração pode transformar uma fonte correta numa resposta errada.
Ao dividir documentos em blocos, mantenha contexto suficiente para interpretar cada passagem. A documentação de segmentação da Microsoft apresenta estratégias por estrutura e significado. O tamanho adequado depende dos documentos e dos testes; não existe um número de palavras que resolva todos os casos.
id: atendimento-prazo-orcamento
estado: aprovado
versao: 3
publico: publico
responsavel: operacoes
pergunta: Quando recebo o orçamento?
resposta: O prazo é confirmado após a avaliação do pedido.
condicao: É necessário conhecer o equipamento e o trabalho.
excecao: Pedidos incompletos precisam de esclarecimentos.
fonte: procedimento-atendimento-v3
rever_em: 2026-12-17Aplique as permissões antes de recuperar informação
O sistema deve determinar a identidade e os acessos através da aplicação. Não basta escrever nas instruções do assistente «não mostre dados privados». Os documentos elegíveis para pesquisa têm de respeitar as permissões de quem faz a pergunta, incluindo os blocos derivados de cada documento.
A documentação de controlo por documento da Microsoft mostra esta distinção entre conteúdo e autorização. Num projeto simples, separar a base pública da área reservada pode facilitar a operação. Em qualquer desenho, teste que um utilizador não consegue recuperar documentos de outra conta, mesmo quando conhece o título ou o identificador. Alterações de permissões também precisam de chegar ao índice.
Prepare respostas com evidência e uma saída útil
Peça respostas apoiadas em passagens aprovadas, com referência que o utilizador possa consultar quando tiver autorização. Uma ligação correta não prova, sozinha, que a conclusão está correta: a fonte tem de sustentar a afirmação. Quando faltam condições, o assistente pede esclarecimentos; quando falta evidência, identifica a lacuna e encaminha o pedido.
A OWASP descreve prompt injection: instruções recebidas numa pergunta ou escondidas num documento podem tentar desviar o comportamento do modelo. Trate documentos recuperados como conteúdo, não como autorização para executar ações. A aplicação deve impor permissões, limitar operações e exigir validação humana quando a decisão o justificar. Uma instrução de segurança isolada não elimina este risco.
- Autorizar
Determinar a informação acessível à pessoa.
- Recuperar
Procurar fontes aprovadas e válidas para o assunto.
- Responder
Explicar a conclusão e indicar a evidência.
- Encaminhar
Pedir contexto ou entregar a uma pessoa quando necessário.
O encaminhamento deve conservar o contexto necessário sem expor informação indevida.
Teste o que deve responder e o que deve reconhecer que falta
Crie um conjunto de perguntas com fonte esperada, condições obrigatórias e comportamento aceitável. Acrescente diferentes formulações e repita os casos críticos: uma única resposta correta não demonstra consistência. Separe falhas de pesquisa, conteúdo desatualizado, interpretação e autorização para corrigir a origem do problema.
| Caso de teste | Resultado esperado |
|---|---|
| Pergunta coberta pela base | Resposta coerente com a passagem e as condições. |
| Pergunta ambígua | Esclarecimento antes de assumir uma condição. |
| Informação ausente | Lacuna reconhecida e encaminhamento útil. |
| Duas fontes contraditórias | Conflito tratado segundo a precedência aprovada. |
| Documento de outra conta | Conteúdo excluído da recuperação e da resposta. |
| Instrução indevida num documento | Sem mudança de autorização nem ação indevida. |
Mantenha o conhecimento com o mesmo cuidado que o serviço
Uma atualização deve passar por revisão, publicação da fonte, atualização do índice e repetição dos testes afetados. Confirme que a versão antiga deixou de ser recuperada quando já não se aplica. Registe a mudança e prepare a reposição da versão aprovada anterior se a atualização introduzir erros.
Reveja também perguntas encaminhadas: podem revelar uma explicação em falta, um processo confuso ou uma nova necessidade. Acrescente conhecimento depois de o validar com o responsável. O objetivo é melhorar a cobertura mantendo respostas justificáveis.
Ficha para o seu projeto
Ficha de conhecimento do assistente Tarefa e público do assistente: Perguntas que deve resolver: Assuntos e ações que exigem encaminhamento: Fonte aprovada por assunto e respetivo responsável: Versão, validade e próxima revisão: Condições e exceções que acompanham cada resposta: Grupos ou contas autorizados a consultar a fonte: Regra quando existem fontes contraditórias: Resposta esperada quando falta informação: Casos de teste e critérios de aprovação: Como atualizar o índice e retirar versões antigas: Canal de encaminhamento e informação a entregar: Responsável pela operação e data de aprovação:
Fontes e critérios
Conteúdo elaborado com apoio de IA e pesquisa em fontes técnicas, com revisão dos exemplos e cálculos aplicáveis. As referências apoiam as decisões do guia; os exemplos identificados como fictícios servem para experimentar o método.