Agente de IA trabalha em cima do que a empresa sabe. Ele consulta o procedimento para seguir o passo a passo, a tabela de preço para montar a proposta, o contrato para responder ao cliente. Se esse material está espalhado, desatualizado ou sem ninguém responsável, o agente não trava: ele erra com toda a confiança.
A IT Glue, plataforma de documentação de TI da Kaseya, publicou um checklist curto para os times de TI se prepararem antes de ligar os recursos de IA. Ele foi escrito para TI, mas a lógica serve para qualquer área. Abaixo está o roteiro, com a nossa leitura de como levar para o resto da operação.
O que o checklist propõe
São três blocos, nesta ordem: fortalecer a base, organizar a gestão dos procedimentos e manter um retrato fiel do ambiente. Cada bloco tem perguntas de sim ou não e perguntas abertas que viram plano. No fim, três perguntas curtas: uma melhoria para este mês, um recurso de IA para testar e os obstáculos que podem atrapalhar.
A ordem importa. A ferramenta de IA não arruma documentação bagunçada, ela acelera o que já existe. Colocar IA antes da base é espalhar o erro mais rápido.
Primeiro, a base
O primeiro bloco pergunta se o essencial está escrito e num lugar só. Traduzindo para fora da TI:
- O que o time consulta para trabalhar está documentado? Na TI são senhas, licenças e configurações. Num escritório são contratos-modelo, tabelas de preço, cadastros e políticas internas.
- Os procedimentos críticos estão escritos e acessíveis para todo mundo? Se o passo a passo mora na cabeça de uma pessoa, o agente não tem o que seguir.
- Está tudo num lugar só, com os itens ligados entre si? Três cópias da mesma política em três pastas é convite para o agente usar a errada.
- As pastas seguem uma estrutura, global ou por cliente? Uma pasta por cliente, caso ou área, igual em todas, também evita que a informação de um apareça na resposta de outro.
- Existe uma convenção de nomes? Data no mesmo formato, versão no nome do arquivo, abreviações combinadas. É o que faz a busca achar a versão certa, e não um PDF de 2019.
- Tem tags e categorias? E, principalmente, tem um dono responsável por manter tudo isso?
Depois, o processo dos procedimentos
O segundo bloco trata de como os procedimentos nascem e morrem. Com IA escrevendo rascunhos, isso fica ainda mais importante.
- Um processo escrito para criar e aprovar procedimentos, inclusive os que a IA gerou.
- Um jeito de achar lacunas: o que o time faz toda semana e ninguém documentou.
- Uma decisão clara entre auditar o que já existe ou começar do zero.
- Um responsável por criar procedimentos novos e uma frequência de auditoria com data marcada: mensal, trimestral ou semestral.
A pergunta mais importante do bloco é a última: que processo vamos seguir para revisar e aprovar o que a IA escreveu? Sem resposta, o rascunho da máquina vira regra da empresa sem ninguém ter lido.
Por fim, um retrato que não envelhece
Documentação só ajuda se for fiel ao que existe hoje. O terceiro bloco fala de limpeza e de relações entre os itens.
- Limpeza com frequência definida: arquivar o que venceu, juntar duplicados, apontar o que ninguém abre. Semanal, mensal ou trimestral, mas com data.
- Itens ligados: o contrato ligado ao cliente, ao processo e ao responsável. Na IT Glue isso é feito por sugestão automática; em qualquer caso, é o que dá ao agente o contexto completo em vez de um documento solto.
- Resumos automáticos dos itens mais consultados, para quem precisa da visão rápida.
- Alguém aprovando cada sugestão de limpeza e de ligação. A IA sugere, uma pessoa decide.
O fio que liga tudo é um dono
Nos três blocos aparece a mesma pergunta, com palavras diferentes: quem é o responsável? Quem mantém a estrutura, quem audita as tags, quem aprova o procedimento gerado por IA, quem aprova a limpeza. O checklist não trata a IA como substituta de quem cuida da documentação. Trata como uma ajudante rápida que precisa de supervisão.
É o mesmo desenho que a gente usa para agentes dentro da operação: o agente faz o trabalho que se repete, e uma pessoa da área revisa nos pontos que importam.
Fora da TI, é a mesma lista
Financeiro, jurídico, comercial, atendimento e compras são só exemplos. Se é tarefa que se repete e depende de documento, dá para automatizar, e a documentação precisa estar neste ponto antes. Na prática, é por onde a gente começa:
- O Analista de IA faz o diagnóstico com estas perguntas: o que está escrito, onde mora, quem é o dono e o que ninguém documentou.
- O Forward Deployed Engineer organiza a base que o agente vai consultar, com nomes, tags e ligações, e coloca a revisão humana nos pontos certos.
- O time aprende a manter: quem aprova o que a IA escreveu, de quanto em quanto tempo limpar e como achar as lacunas.
Agente bom em cima de documentação ruim dá resposta ruim mais rápido. Arrume a base, defina o dono e só então ligue a IA.
Gostou deste artigo?
Receba o próximo antes de ele chegar ao blog.
Um e-mail curto por edição com o que vale a pena sobre agentes de IA na operação. Sem spam.