lola.docs
Tools

Visão geral das tools

Como a IA acessa as capacidades da Lola — facades de alto nível, call_tool e a camada avançada de ferramentas organizada em grupos.

A Lola organiza suas capacidades em duas camadas: as facades, superfície principal que a IA enxerga, e a camada avançada, com centenas de ferramentas específicas executadas através da facade call_tool. Você não precisa decorar nomes: peça em linguagem natural e a Lola escolhe o caminho certo.

Facades: a superfície principal

Depois do bootstrap(), a IA trabalha com um conjunto enxuto de ferramentas de alto nível:

Facade
O que faz
bootstrap
Inicia a sessão: carrega perfil, modo, projeto e emite o crachá org_ctx.
save
Salva conhecimento, decisões e preferências na memória.
recall
Busca conhecimento salvo (busca semântica).
projects
Gestão de trabalho no Telos: issues, milestones, ciclos.
message
Comunicação: inbox interno e email (sempre com preview).
call_tool
Executa qualquer ferramenta da camada avançada pelo nome.
heartbeat
Verifica a saúde da sessão.
end_session
Encerra a sessão salvando o contexto para a próxima.

Cada facade entende intenção em linguagem natural: "Lola, cria uma issue para..." vira uma chamada de projects; "Lola, o que sabemos sobre...?" vira recall. A lista de facades pode crescer com o tempo.

Camada avançada: call_tool

Por trás das facades existem mais de 460 ferramentas organizadas em 27 grupos (conhecimento, projetos, comunicação, CRM, finanças, calendário e outros). Quando uma tarefa pede algo específico, a IA usa call_tool para executar a ferramenta certa pelo nome — com as mesmas permissões e o mesmo isolamento de organização das facades.

Um subconjunto curado desses grupos é exposto para o dia a dia; ferramentas internas e operacionais não aparecem para o cliente. Navegue pelo catálogo.

Categorias

Conhecimento
Memória persistente e base de conhecimento.
Projetos
Gestão de tarefas e projetos.
CRM
Pipeline de clientes.
Comunicação
Email, inbox e notificações.
DevOps
Deploy, monitoramento, infraestrutura.
Financeiro
Contas, transações, relatórios.
Design
Criação de posts e materiais.
Calendário
Eventos, disponibilidade.
Skills
Automações reutilizáveis.

Como usar

Você não precisa chamar tools diretamente. Fale naturalmente e a Lola escolhe a ferramenta certa:

"Lola, cria uma issue de bug para o módulo de pagamentos"

create_issue()

"Lola, o que decidimos sobre a arquitetura do auth?"

search_knowledge()

"Lola, manda email pro João avisando do deploy"

send_email() com preview antes de enviar

"Lola, qual o saldo das contas este mês?"

fin_summary()

O crachá org_ctx

O bootstrap() devolve um token chamado org_ctx, que fixa a organização daquela conversa. Toda chamada que lê ou grava dados (save, recall, projects, message, call_tool) porta esse crachá — é ele que garante que cada operação acontece dentro da organização certa. Saiba mais em Segurança.

Segurança

  • Emails nunca são enviados sem preview: a Lola sempre mostra antes e pede confirmação.
  • Isolamento por organização: toda operação é validada com o org_ctx da conversa.
  • Dados sensíveis são protegidos: informações de clientes, financeiro e membros seguem regras de sigilo.
  • LGPD: exportação e exclusão de dados disponíveis.

Veja os detalhes de cada área:

  • Conhecimento: memória, aprendizado e busca (save e recall).
  • Projetos: issues, milestones, ciclos e gestão de tarefas (projects).
  • Comunicação: email, inbox e notificações (message).