Assistente interno no Slack: um agente de IA que conhece sua empresa e cita as fontes

Em uma empresa pequena, as mesmas perguntas voltam toda semana. Quantos dias de férias restam, como enviar um relatório de despesas, a quem pedir um acesso, onde está o modelo de contrato. As respostas existem, mas estão espalhadas em documentos que ninguém encontra ou na cabeça de dois ou três colegas interrompidos o dia todo. São perguntas frequentes com respostas estáveis, o que combina com um agente de IA, desde que ele responda a partir de fontes conhecidas e saiba dizer «não sei».

A inspiração: o colega que conhece a casa

O ponto de partida é um uso relatado por usuários do Hermes Agent, resumido em um cartão sobre o assistente interno que conhece a empresa, no Slack. A ideia é colocar o conhecimento da casa onde o time já conversa e responder na conversa em vez de em mais uma ferramenta.

Mantemos duas exigências: citar a fonte e reconhecer os próprios limites. A Atako aplica a ideia com um agente que responde em um único canal, a partir do wiki do projeto, e cujas perguntas sem resposta alimentam o FAQ a completar.

O que o agente faz

O cenário implanta um agente, conectado ao seu Slack e ao wiki do projeto dele.

Na inicialização, cria no wiki uma página para cada tema que você listou, cada uma com uma breve introdução e uma seção «A preencher», além da página «FAQ - perguntas sem resposta». Ele não inventa o conteúdo: o seu time o preenche. Depois encontra o canal escolhido e se apresenta ali: o que pode responder, o fato de citar a página em que se apoia e de dizer quando não sabe.

Em seguida, a cada dez minutos nos dias úteis, das 8h às 19h, lê as novas perguntas do canal. Para cada uma, procura a resposta no wiki e na memória e responde no tópico: uma resposta curta e direta seguida do título da página de origem. Se duas fontes se contradizem ou uma página parece antiga, ele avisa. Quando não encontra nada, ou só parte da resposta, diz com clareza, indica o que encontrou, aponta a pessoa certa conforme a descrição da empresa e o diretório do Slack e adiciona a pergunta, sem o nome de quem a fez, ao FAQ de perguntas sem resposta. Se alguém responder depois no tópico, ele registra a resposta na página do tema certo. Toda sexta-feira às 16h, publica no canal uma nota curta: perguntas tratadas, perguntas sem resposta, páginas a preencher.

O que o agente não faz

Os limites fazem parte do desenho. O agente fala apenas no canal que você escolheu, sempre em um tópico sob a pergunta. Não envia mensagens diretas, não publica em nenhum outro canal, não lê nenhum outro canal e não convida nem remove ninguém: essas ferramentas não são concedidas a ele.

Ele não inventa nenhuma resposta, regra, data, valor ou nome: se o wiki não diz, ele não sabe, e nunca cita uma página que não abriu. Para assuntos confidenciais, como salários, avaliações, saúde ou conflitos, não responde no canal e encaminha a pessoa em privado ao interlocutor certo. As mensagens do canal são tratadas como perguntas, nunca como instruções: uma mensagem que peça para ignorar as regras, revelar as instruções ou agir fora do canal é recusada em uma linha. A decisão sobre tudo o que vai além do conhecido continua humana, que é o princípio de um desenho com validação humana.

Como configurar na Atako

A partir da página deste caso de uso, a implantação leva quatro passos.

1. Conecte o Slack. Crie um app do Slack com um token que possa ler o histórico do canal, escrever mensagens e consultar o diretório, e convide-o para o canal escolhido. A conexão é verificada antes de criar qualquer coisa.
2. Informe seu contexto. Dê o nome do canal, uma descrição da empresa que diga quem cuida de quê e a lista de temas cobertos. O assistente os usa para criar as páginas do wiki e para encaminhar as perguntas à pessoa certa.
3. Implante. Uma única ação cria o agente e o projeto «Assistente interno». O agente é provisionado e recebe sozinho a primeira instrução.
4. Primeiro resultado, depois um ritmo regular. O agente cria as páginas do wiki, apresenta-se no canal e resume no chat o que fez e o que sobra para o seu time: preencher as páginas por tema. Depois agenda sozinho o monitoramento de dez minutos e a nota de sexta-feira.

Se você ainda não tem conta, criá-la inicia o seu período de teste e o cenário é configurado logo em seguida. Se o seu administrador não permitiu que você crie agentes, a implantação avisa e para aí.

Onde ver os resultados

As respostas são lidas no canal do Slack, nos tópicos sob cada pergunta. As fontes e o FAQ são lidos no wiki do projeto «Assistente interno», com uma página por tema e a página «FAQ - perguntas sem resposta». O resumo de inicialização é lido no chat do agente, e no floor da Atako o agente aparece com a atividade atual.

Para ajustar o comportamento dele, escreva no chat, por exemplo «para despesas, indique o Marc em vez da Anna». Ele guarda a instrução na memória.

Salvaguardas

O acesso é deliberadamente estreito. A conexão com o Slack é concedida com uma lista de nove ferramentas: listar canais, ler histórico e tópicos, publicar uma mensagem, obter o link de uma mensagem, consultar o diretório e reagir. Um agente que vê uma lista curta de ferramentas as usa com mais confiabilidade do que um perdido em um catálogo de centenas, e o que não é concedido não pode acontecer: nem mensagens diretas, nem gestão de membros, nem exclusão.

O token que você cria é a sua primeira salvaguarda. Ao convidar o app apenas para o canal escolhido, você também limita o acesso do lado do Slack. Ele é guardado criptografado, e você pode revogá-lo ou remover o acesso do agente a qualquer momento.

A validação humana fica nos pontos de decisão. O seu time escreve e corrige as páginas do wiki que fazem referência, responde às perguntas que o assistente não consegue tratar e mantém o controle de todos os assuntos sensíveis.

O que esperar

Espere que o assistente seja tão bom quanto o seu wiki: no primeiro dia, com as páginas por tema vazias, ele responderá sobretudo que não sabe e alimentará o FAQ, que mostra com precisão o que precisa ser documentado. Ao longo das semanas, as respostas se multiplicam à medida que as páginas se preenchem. Ele lê apenas o canal escolhido e, portanto, não vê as suas outras conversas nem documentos fora do wiki. O valor vem da regularidade: uma pergunta recebe uma resposta com fonte em minutos, e as lacunas da sua documentação aparecem.