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

Q: Preciso saber programar para usar as Ferramentas?

Para as Ferramentas Nativas, como a integração com o Google Agenda, não é necessário conhecimento de programação. A configuração é feita por meio de uma interface simples. Para as Ferramentas Customizadas (HTTP), é necessário ter conhecimento técnico sobre como funcionam as APIs, incluindo métodos HTTP, autenticação e formato JSON.

Q: Como a IA sabe qual Ferramenta usar?

A IA decide qual ferramenta usar com base na descrição que você fornece ao configurá-la. Uma descrição clara e detalhada, que explica o propósito da ferramenta e quais informações ela precisa, é fundamental. O Capitão analisa a intenção do cliente e a compara com as descrições de todas as ferramentas disponíveis para escolher a mais adequada.

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 de um 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: Dentro das opções de configuração do assistente, encontre a área dedicada às "Ferramentas" (Tools).
Adicione uma Nova Ferramenta: Escolha entre adicionar uma ferramenta "Nativa" ou "Customizada (HTTP)".
Para Ferramentas Nativas: Selecione o serviço desejado (como o Google Agenda) na lista de integrações disponíveis. Siga as instruções na tela para conectar e autorizar sua conta.
Para Ferramentas Customizadas:
- Dê um Nome e Descrição: Crie um nome claro (ex: "Consultar Status do Pedido") e uma descrição detalhada para a IA. A descrição é crucial, pois ensina o Capitão quando e como usar a ferramenta (ex: "Use esta ferramenta para verificar o status de um pedido de um cliente quando ele fornecer o número do pedido").
- Configure a Requisição HTTP: Preencha os campos de URL do endpoint, método HTTP, cabeçalhos (para autenticação) e o corpo da requisição, se necessário.
Ative e Teste: Após a configuração, ative a ferramenta para que o Capitão possa começar a usá-la. Realize testes enviando mensagens que deveriam acionar a nova ferramenta para garantir que tudo está funcionando como esperado.

Perguntas Frequentes (FAQ)

Qual a diferença entre Ferramentas (Tools) e Cenários?

As Ferramentas (Tools) são projetadas para executar ações em sistemas externos ou outras partes da API da Papo, como consultar um banco de dados ou agendar um evento. Já os Cenários são instruções para o Capitão executar uma ação interna na plataforma, como transferir a conversa para um atendente humano (transbordo) em situações específicas.

Preciso saber programar para usar as Ferramentas?

Para as Ferramentas Nativas, como a integração com o Google Agenda, não é necessário conhecimento de programação. A configuração é feita por meio de uma interface simples. Para as Ferramentas Customizadas (HTTP), é necessário ter conhecimento técnico sobre como funcionam as APIs, incluindo métodos HTTP, autenticação e formato JSON.

Como a IA sabe qual Ferramenta usar?

A IA decide qual ferramenta usar com base na descrição que você fornece ao configurá-la. Uma descrição clara e detalhada, que explica o propósito da ferramenta e quais informações ela precisa, é fundamental. O Capitão analisa a intenção do cliente e a compara com as descrições de todas as ferramentas disponíveis para escolher a mais adequada.

Posso usar as Ferramentas para interagir com a própria API da Papo?

Sim. Você pode configurar uma Ferramenta Customizada (HTTP) para fazer chamadas à API da Papo. Isso permite criar automações avançadas, como usar a IA para criar um novo contato no CRM, enviar uma mensagem por outro canal ou atualizar um atributo de um cliente, tudo a partir de uma instrução na conversa.

É seguro usar Ferramentas Customizadas com minhas chaves de API?

Sim. As informações de autenticação, como chaves de API (tokens), são armazenadas de forma segura na plataforma Papo e utilizadas em comunicações de servidor para servidor, que são mais seguras. É uma boa prática de segurança criar chaves de API com permissões limitadas especificamente para essa integração, em vez de usar chaves com acesso total.