Agentes, MCP e projetos · Tutorial prático

Como escolher os documentos que um assistente pode consultar

Escolhe os documentos de um assistente a partir da tarefa, das pessoas que vão usar a resposta e das permissões efetivas de acesso. Inclui fontes relevantes, atuais e autorizadas. Regista o que ficou de fora, verifica o comportamento com contas limitadas e revê também os resumos ou ficheiros que forem partilhados.

Que documentos entram? Fontes selecionadas numa bandeja e pasta separada. Ilustração conceptual gerada com IA.
Ilustração gerada com IA para o Laboratório da IA.

Dar mais documentos a um assistente pode parecer uma forma simples de melhorar as respostas. Mas uma pasta com propostas antigas, notas internas e materiais de vários clientes traz decisões que precisam de ser tomadas antes da primeira pergunta. Que versão está válida? Quem pode ver cada informação? O que acontece se a resposta for enviada a outra pessoa?

Vamos trabalhar com um exemplo fictício: uma consultora quer preparar perguntas frequentes para o cliente A. Tem um catálogo público, um manual aprovado, notas internas de negociação e documentos do cliente B. O objetivo é escolher um conjunto de fontes que permita responder bem, sem misturar audiências ou assumir permissões que não foram confirmadas.

Qual é a primeira decisão antes de carregar documentos?

Define o resultado pretendido e quem terá acesso a esse resultado. Depois identifica a informação necessária para o produzir. Esta sequência ajuda-te a selecionar fontes com uma finalidade concreta, em vez de carregar todo o arquivo e pedir ao assistente que decida sozinho o que pode utilizar ou divulgar.

No exemplo, a consultora pretende criar um rascunho de perguntas frequentes para a equipa de atendimento do cliente A. As respostas precisam de explicar serviços, condições aprovadas e passos para pedir apoio. O catálogo público e o manual atual podem ser fontes adequadas, desde que estejam autorizados para aquela utilização.

As notas de negociação contêm margens e comentários que não fazem parte da informação destinada ao atendimento. Mesmo que ajudem a consultora a compreender o negócio, isso não significa que devam entrar no conjunto consultado pelo assistente. Os materiais do cliente B não contribuem para a tarefa e ficam excluídos.

Escreve uma frase de âmbito: «Este assistente prepara rascunhos de respostas sobre os serviços do cliente A, usando apenas as fontes aprovadas para a equipa de atendimento». A frase orienta o trabalho. As permissões da ferramenta e dos documentos é que têm de sustentar tecnicamente esse limite.

Nas unidades revistas do Laboratório, esta distinção aparece tanto na organização de projetos com agentes como na seleção de fontes para cadernos. Roberto Cortez aborda o ambiente, as integrações e os acessos; a aula de NotebookLM com Sara e Márcia permite aprofundar a diferença entre escolher fontes para uma pergunta e controlar quem as pode consultar.

Como fazer um inventário útil dos documentos?

Cria uma lista com o nome de cada documento, a sua origem, a versão, o responsável e a audiência autorizada. Acrescenta a decisão de incluir, excluir ou pedir confirmação. O inventário deve permitir perceber por que motivo uma fonte entra no trabalho e quem pode esclarecer uma dúvida sobre ela.

Não precisas de começar com um sistema complexo. Uma tabela pequena é suficiente para rever as primeiras fontes. O importante é evitar decisões implícitas: um ficheiro estar na tua pasta de trabalho não explica se pode ser carregado num serviço externo ou partilhado com a equipa do cliente.

Documento do exemploUtilidade para a tarefaDecisão inicialVerificação necessária
Catálogo público atual do cliente ADescrever serviçosIncluirConfirmar versão e origem
Manual aprovado para atendimentoExplicar procedimentosIncluir se autorizadoConferir destinatários e condições de uso
Tabela antiga de condiçõesComparação históricaExcluir da resposta atualGuardar referência à versão substituída
Notas internas de negociaçãoNão necessárias para as perguntas frequentesExcluirManter fora do conjunto consultável
Documentos do cliente BSem relação com a tarefaExcluirConfirmar que não ficam acessíveis por outro caminho

A coluna da audiência merece atenção. «A equipa pode ver» é pouco específico quando existem colaboradores internos, prestadores externos e pessoas do cliente. Identifica o grupo ou as pessoas relevantes para aquele trabalho. Se houver dúvida sobre uma autorização, mantém a fonte pendente até a esclareceres.

Para cada documento incluído, regista uma referência que permita voltar à origem. Pode ser um link interno autorizado ou um identificador no teu sistema. Evita depender apenas do nome «manual-final.pdf», porque podes ter várias cópias com esse nome e conteúdos diferentes.

Depois desta seleção, o guia para preparar documentos e obter melhores respostas de IA ajuda-te a trabalhar a legibilidade e a estrutura das fontes. Aqui estamos a decidir quais entram e em que condições.

Como separar relevância, acesso e autorização de uso?

Avalia três perguntas para cada fonte: ajuda a responder à tarefa, o sistema consegue aceder-lhe e essa utilização está autorizada? Uma resposta positiva a uma delas não resolve as restantes. Mantém esta distinção no inventário e confirma as condições reais antes de ligar pastas, contas ou serviços ao assistente.

Uma proposta comercial pode ser relevante para compreender um serviço e estar acessível na conta da consultora. Ainda assim, pode incluir condições específicas que não devem ser apresentadas como oferta geral. A decisão de uso depende do contexto, da audiência e do que foi aprovado para aquela finalidade.

Também pode acontecer o contrário: o documento está autorizado e é necessário, mas o conector não consegue obtê-lo. Nesse caso, a resposta precisa de mostrar a falta de informação. Não aceites uma conclusão como se a fonte tivesse sido consultada apenas porque o seu título aparece numa lista.

Pede uma verificação pequena: identificar a versão e localizar uma passagem conhecida num documento de teste. Isso ajuda a distinguir um ficheiro listado de um conteúdo efetivamente recuperado. A consulta de uma passagem também não comprova que todas as páginas, imagens ou anexos foram lidos corretamente.

Quando uma fonte mistura informação útil e informação desnecessária, podes preparar uma versão reduzida aprovada. Mantém referência ao original e explica o que retiraste. Uma cópia de trabalho deve preservar as condições e exceções necessárias à resposta, em vez de simplificar o texto ao ponto de mudar o significado.

Porque é que uma pasta ou uma instrução não bastam?

Uma pasta organiza os ficheiros e uma instrução orienta o comportamento do assistente. O acesso efetivo depende das permissões do sistema, da aplicação, da conta e das ferramentas ligadas. Confirma esses mecanismos separadamente, sobretudo quando o agente pode procurar noutros diretórios, consultar serviços ou trabalhar com materiais de várias pessoas.

Na preparação de projetos abordada por Roberto Cortez, reunir os ficheiros numa pasta facilita encontrar o contexto e manter o trabalho organizado. Isso não demonstra, por si só, que o agente esteja impedido de ler outra pasta. O ambiente pode ter permissões mais amplas do que o diretório onde começaste a sessão.

Uma instrução como «usa apenas os documentos do cliente A» é útil para definir a tarefa. Para impedir acesso aos materiais do cliente B, precisas de verificar os controlos disponíveis no ambiente: permissões de ficheiros, limites do cliente, contas usadas e âmbito dos conectores. Se não consegues confirmar esse isolamento, escolhe um conjunto de trabalho sem os materiais que não devem estar acessíveis.

O mesmo cuidado aplica-se à palavra «local». Um ficheiro pode estar no computador enquanto o serviço do modelo funciona pela rede. Identifica onde os comandos correm e para onde o conteúdo pode ser enviado. A interface, seja um terminal ou uma aplicação, não esclarece sozinha esse percurso.

No Google Drive, verifica também a origem das permissões. A documentação explica que o acesso concedido a uma pasta é herdado pelos ficheiros que contém. Analisa a pasta principal e as pessoas ou grupos com acesso, além do ficheiro individual. Consulta a documentação oficial de partilha do Drive, verificada em 17 de outubro de 2026.

O que muda quando ligas um conector ou um MCP?

Ao ligar um serviço, confirma a conta utilizada, as operações disponíveis e o conjunto de dados que pode ser consultado. Verifica também como a informação é atualizada e que ações ficam permitidas. A existência de um conector ou de um MCP não demonstra que o acesso esteja limitado ao projeto pretendido.

Podes ter uma integração capaz de pesquisar ficheiros, outra que apenas lê um documento indicado e outra que também permite criar ou editar materiais. Estas diferenças alteram o âmbito do trabalho. Para preparar perguntas frequentes, talvez só precises de consultar um conjunto aprovado e produzir um rascunho noutro local.

Regista quais as fontes ligadas e qual a conta usada. Se a integração corre com uma conta que vê todos os clientes, não assumes que o utilizador final herdará automaticamente apenas os seus documentos. Essa separação precisa de existir na implementação e ser testada com as condições reais de utilização.

Confirma ainda se estás a trabalhar com uma cópia importada ou com dados consultados novamente. Uma alteração no manual original pode não chegar ao assistente pelo percurso que escolheste. Documenta como vais atualizar a fonte e como identificas a versão usada numa resposta.

O artigo sobre como testar permissões numa aplicação criada com IA pode ajudar quando estás a construir uma aplicação com contas e documentos próprios. Antes de adotarem uma integração, as pessoas responsáveis devem conseguir explicar que operação é feita e que acesso a suporta.

Como tratar cadernos partilhados e ficheiros exportados?

Revê o acesso ao caderno, às fontes e aos materiais produzidos, porque cada elemento pode ter condições próprias. Selecionar uma fonte para uma pergunta ajuda a orientar a resposta, mas não prova que os restantes documentos ficaram inacessíveis. Confirma a experiência do destinatário e verifica separadamente qualquer ficheiro exportado ou partilhado.

No exemplo, a consultora não deve colocar os documentos dos dois clientes no mesmo caderno partilhado e confiar apenas na seleção visual das fontes. É mais claro preparar um conjunto específico para o cliente A e conferir o que a conta destinatária consegue abrir nesse espaço.

A página de ajuda do NotebookLM consultada em 17 de outubro de 2026, atualmente intitulada «Create a notebook in Gemini Notebook», esclarece que a vista de conversa pode ocultar materiais sem revogar o acesso subjacente. Indica também que as permissões do caderno não passam para ficheiros exportados. Consulta a documentação oficial de criação e partilha de cadernos antes de partilhares.

Se criares um resumo para a equipa de atendimento, revê o conteúdo e o destino. O resumo pode incluir uma condição interna que não devia ter sido usada. Mesmo depois de corrigires o acesso à fonte, a cópia exportada pode continuar onde foi guardada. Faz o inventário desses materiais quando precisares de atualizar ou retirar informação.

O mesmo princípio aplica-se a uma apresentação, uma folha ou um PDF criado a partir das fontes. Escolher os documentos do assistente inclui pensar no percurso da resposta até às pessoas que a vão usar. Guarda a associação entre fonte, versão e material produzido para conseguires rever esse percurso.

Fonte, Resumo e Partilha representados por três documentos com controlos de acesso separados. Ilustração conceptual gerada com IA.
Fonte, Resumo e Partilha representados por três documentos com controlos de acesso separados. Ilustração conceptual gerada com IA. Ilustração gerada com IA.

Como testar se a seleção e os acessos estão corretos?

Usa documentos sintéticos e contas limitadas para testar tanto o acesso permitido como o acesso que deve ser recusado. Define o resultado esperado antes do ensaio, regista o que aconteceu e verifica os vários caminhos de consulta. Um teste com a conta administradora não comprova a experiência de quem recebe o material.

Cria, por exemplo, um documento fictício do cliente A com a frase «referência de teste A» e outro do cliente B com «referência de teste B». Usa materiais sem informação real de clientes. A conta destinada ao cliente A deve conseguir consultar a fonte autorizada e não deve conseguir obter a outra referência por pesquisa, link direto ou resposta do assistente.

Testa também uma pergunta que peça uma informação ausente. Se o catálogo não inclui o prazo de entrega de um serviço, a resposta deve identificar essa lacuna. Acesso correto e resposta correta são verificações diferentes: podes ter isolado os documentos e continuar a receber uma interpretação errada do seu conteúdo.

Depois, retira uma permissão de teste e confere o que mudou. Verifica a fonte original, a integração e os materiais já produzidos. Não concluas que uma alteração num dos pontos apagou todas as cópias ou invalidou todos os acessos. O resultado depende do percurso que configuraste e precisa de ser observado.

Regista os limites do ensaio: contas utilizadas, documentos incluídos e operações verificadas. Se testaste apenas a abertura de um link, escreve isso. Para uma aplicação própria, pede também a revisão dos controlos que entregam os dados; esconder um botão na página não demonstra que o acesso ao conteúdo foi recusado.

Como manter o conjunto de documentos atualizado?

Atribui um responsável ao conjunto de fontes e define quando deve ser revisto: alteração de condições, entrada de pessoas, fim de projeto ou substituição de documentos. Mantém versões identificáveis e regista o que foi atualizado. Antes de reutilizar uma resposta antiga, confirma se continua apoiada nas fontes e permissões atuais.

No exemplo das perguntas frequentes, uma mudança nas condições do serviço deve desencadear a revisão do manual, da fonte usada pelo assistente e das respostas já preparadas. O catálogo antigo pode continuar guardado para histórico, mas precisa de ficar claramente separado do conjunto usado para responder sobre a oferta atual.

Um registo curto pode indicar a data, a fonte substituída, a nova versão e os materiais a rever. Assim evitas depender da memória de quem fez a alteração. Se o responsável sair do projeto, outra pessoa consegue perceber como o conjunto foi escolhido e o que precisa de conferir.

Podes pedir ajuda à IA para preparar esta revisão sem lhe entregar documentos que ainda não foram autorizados. Fornece o inventário e pede que identifique versões sem data, audiências pouco claras ou fontes sem responsável. O assistente organiza as perguntas; a autorização e a confirmação dos factos continuam a depender das pessoas e dos sistemas adequados.

Se estás a montar um assistente para um cliente, o guia sobre organizar documentos de um cliente para trabalhar com IA ajuda a dar continuidade à preparação. O conjunto está pronto para uso quando consegues explicar o papel de cada fonte, verificar os acessos e localizar a versão que sustenta a resposta.

Aprende no Laboratório a preparar contexto e acessos

No Laboratório da IA podes aprender a organizar fontes, configurar ferramentas e rever o comportamento de um assistente. Traz uma tarefa concreta e um inventário sem informação privada desnecessária. Nas aulas semanais e nos Zooms de acompanhamento semanais, podes aprofundar a preparação do contexto e aplicar os critérios ao teu projeto.

Aprofunda este percurso no LAB

Aprender Claude CodeAprender vibe coding
Passa à prática

Aprende a construir isto no Lab.

Trabalha o processo com aulas, materiais e acompanhamento. Leva o que estás a construir e esclarece as dúvidas da tua implementação.

  • Selecionar documentos relevantes, atuais e autorizados para uma tarefa concreta.
  • Distinguir seleção de fontes, permissões efetivas e acesso aos materiais exportados.
  • Aplicar os critérios nas aulas e nos Zooms de acompanhamento semanais do Laboratório.

Aulas semanais para aprender e aplicar. Zooms de acompanhamento semanais para esclarecer dúvidas. Replay e materiais para retomar o trabalho ao teu ritmo.

Entrar no Laboratório da IA

Continua a aprender

Como separar documentos de clientes ao trabalhar com IAComo testar permissões antes de abrir uma aplicação a utilizadoresComo preparar documentos para obter melhores respostas de IA
Laboratório da IA

Formação para empresas

Pede a demonstração para a tua empresa.

Deixa o teu contacto. A nossa equipa liga-te para perceber o contexto da tua empresa, mostrar a plataforma e apresentar as condições para o número de pessoas que queres formar.

O telemóvel serve para a nossa equipa te contactar e marcar a demonstração.

Os teus dados estão seguros connosco. Consulta a nossa Política de Privacidade.

Pedir uma demonstração é gratuito e não implica qualquer pagamento.