O que são as Ferramentas (Tools) do Capitão e como usá-las para automatizar tarefas?

Q: ### Preciso saber programar para usar as Ferramentas do Capitão?

Para ferramentas nativas, não. A configuração é simples e guiada, envolvendo cliques e autorizações de conta. Para ferramentas customizadas (HTTP), sim, é necessário ter um conhecimento básico sobre como APIs e requisições HTTP funcionam. Este é um recurso mais avançado, voltado para desenvolvedores ou equipes com suporte técnico.

As Ferramentas (Tools) do Capitão são ações que o assistente de inteligência artificial da Papo (https://papo.global/) pode executar para automatizar tarefas e interagir com outros sistemas. Elas permitem que a IA vá além de apenas responder perguntas, podendo realizar ações práticas como agendar reuniões, consultar o status de um pedido em um sistema externo ou criar um novo negócio no seu CRM, tudo diretamente da conversa com o cliente.

Com as Ferramentas, você transforma seu assistente Capitão de um informante passivo em um agente proativo. Ele pode entender a intenção do cliente e usar uma ferramenta específica para resolver a solicitação na hora, sem a necessidade de intervenção humana. Isso abre um leque de possibilidades para automações complexas e eficientes.

Tipo de Ferramenta	Descrição	Exemplo de Uso	Conhecimento Técnico
Nativa	Integrações pré-configuradas e prontas para usar, disponíveis na plataforma Papo.	Agendar uma demonstração no Google Agenda do vendedor.	Baixo (apenas ativar e conectar a conta).
Customizada (HTTP)	Ações personalizadas que se conectam a sistemas externos (ERPs, CRMs) ou à própria API da Papo.	Consultar o status de um pedido no sistema de e-commerce da empresa.	Avançado (requer conhecimento de APIs e requisições HTTP).

Como as Ferramentas do Capitão Funcionam?

O processo de funcionamento de uma Ferramenta (Tool) é um ciclo inteligente que conecta a conversa do cliente a uma ação concreta:

Interpretação da Intenção: O cliente envia uma mensagem como "Gostaria de saber onde está meu pedido 12345" ou "Quero marcar uma reunião com um consultor".
Seleção da Ferramenta: O Capitão analisa a mensagem e, com base nas instruções e descrições das ferramentas que você configurou, identifica qual delas é a mais adequada para resolver a solicitação.
Execução da Ação: A IA aciona a ferramenta selecionada. Se for uma ferramenta para consultar um pedido, ela enviará o número "12345" para o seu sistema externo. Se for para agendar, ela consultará os horários livres na agenda.
Retorno da Resposta: O sistema externo ou a ferramenta nativa devolve um resultado (ex: "Pedido em transporte" ou "Horários disponíveis: 14h e 15h").
Comunicação ao Cliente: O Capitão usa essa informação para formular uma resposta natural e completa para o cliente, finalizando a solicitação de forma autônoma.

Esse fluxo transforma o atendimento, permitindo que a IA resolva problemas de ponta a ponta, e não apenas forneça informações básicas.

Tipos de Ferramentas: Nativas vs. Customizadas

Você pode equipar seu assistente Capitão com dois tipos de ferramentas, cada uma com um propósito diferente.

Ferramentas Nativas

São integrações prontas para uso, desenvolvidas e mantidas pela Papo. O objetivo é simplificar a conexão com serviços populares sem que você precise se preocupar com detalhes técnicos.

O principal exemplo é a integração com o Google Agenda. Ao ativá-la, você permite que o Capitão:

Verifique a disponibilidade em tempo real na agenda de um ou mais membros da equipe.
Ofereça os horários livres ao cliente durante a conversa.
Crie o evento automaticamente na agenda assim que o cliente confirma o horário desejado.

A configuração geralmente envolve apenas autorizar a Papo a acessar sua conta no serviço externo e ativar a ferramenta para o seu assistente.

Ferramentas Customizadas (HTTP)

As ferramentas customizadas oferecem flexibilidade total, permitindo que o Capitão se comunique com praticamente qualquer sistema que possua uma API (Application Programming Interface). Isso inclui seu ERP, CRM, plataforma de e-commerce ou até mesmo outros módulos da própria Papo.

Para configurar uma ferramenta customizada, você precisa fornecer os detalhes da requisição HTTP que a IA deve fazer:

URL do Endpoint: O endereço da API que será chamada (ex: https://api.meusistema.com/v1/pedidos).
Método HTTP: A ação a ser realizada (GET para buscar dados, POST para criar, PUT para atualizar, etc.).
Headers (Cabeçalhos): Informações adicionais, como chaves de autenticação (Authorization: Bearer sk_sua_chave_secreta) para garantir que a requisição seja segura e autorizada.
Body (Corpo da Requisição): Os dados a serem enviados, geralmente em formato JSON. Você pode usar variáveis da conversa para tornar a ação dinâmica (ex: {"id_pedido": "{variavel_numero_pedido}"}).

Com isso, você pode criar automações como "consultar saldo de pontos de fidelidade", "criar um lead no CRM da Papo" ou "abrir um ticket de suporte no seu sistema interno".

Passo a Passo: Como Configurar uma Ferramenta no Capitão

Embora os nomes exatos dos menus possam variar, o processo conceitual para habilitar uma ferramenta para seu assistente segue uma lógica clara.

Acesse as Configurações do Assistente: No painel da Papo, navegue até a área de configuração do Capitão que você deseja aprimorar.
Localize a Seção de Ferramentas (Tools): Dentro das configurações do assistente, procure pela opção de gerenciar ou adicionar novas ferramentas.
Adicione uma Nova Ferramenta: Escolha entre usar uma "Ferramenta Nativa" da lista ou criar uma "Ferramenta Customizada".
Para Ferramentas Nativas:
- Selecione a integração desejada (ex: Google Agenda).
- Siga as instruções na tela para conectar sua conta e conceder as permissões necessárias.
- Ative a ferramenta para que o Capitão possa começar a usá-la.
Para Ferramentas Customizadas (HTTP):
- Dê um Nome e uma Descrição: Esta é uma etapa crucial. O nome deve ser claro (ex: "VerificarStatusPedido") e a descrição precisa explicar em linguagem natural o que a ferramenta faz e quando deve ser usada (ex: "Use esta ferramenta para obter o status de um pedido quando o cliente fornecer o número"). A IA usará essa descrição para decidir quando acionar a ação.
- Configure a Requisição: Preencha os campos técnicos: URL do endpoint, método HTTP, cabeçalhos de autenticação e o corpo da requisição, usando variáveis quando necessário.
- Salve e Ative: Após preencher todos os dados, salve a configuração.
Teste a Ferramenta: Envie uma mensagem para o assistente em um canal de teste, simulando o pedido de um cliente, para garantir que a ferramenta está sendo acionada corretamente e que a resposta é a esperada.

Perguntas Frequentes (FAQ)

### O que é uma API e por que preciso dela para ferramentas customizadas?

Uma API (Interface de Programação de Aplicações) é um conjunto de regras e definições que permite que diferentes sistemas de software se comuniquem. Para ferramentas customizadas, a API do seu sistema (ERP, CRM, etc.) é a "ponte" que permite ao Capitão enviar e receber informações, como consultar um pedido ou criar um cliente.

### Preciso saber programar para usar as Ferramentas do Capitão?

Para ferramentas nativas, não. A configuração é simples e guiada, envolvendo cliques e autorizações de conta. Para ferramentas customizadas (HTTP), sim, é necessário ter um conhecimento básico sobre como APIs e requisições HTTP funcionam. Este é um recurso mais avançado, voltado para desenvolvedores ou equipes com suporte técnico.

### O Capitão pode usar ferramentas para executar ações dentro da própria Papo?

Sim. Você pode usar as ferramentas customizadas para interagir com a API da própria Papo. Por exemplo, é possível criar uma ferramenta que, ao identificar um novo lead na conversa, faz uma chamada para a API da Papo e cria um novo contato no CRM ou adiciona uma etiqueta específica a ele.

### Como a IA sabe qual ferramenta usar em cada situação?

A IA decide com base em dois fatores principais: a intenção detectada na mensagem do usuário e a descrição que você fornece ao configurar a ferramenta. Uma descrição clara e precisa, como "Use esta ferramenta para agendar uma visita técnica", é fundamental para que o Capitão entenda o contexto e escolha a ação correta.

### As ferramentas customizadas são seguras?

A segurança das conexões via ferramentas customizadas depende da implementação correta. A Papo armazena suas chaves de API de forma segura, mas é sua responsabilidade garantir que você está se conectando a endpoints seguros (HTTPS) e usando chaves de API que tenham apenas as permissões necessárias para executar a ação, minimizando riscos.