BuildShip: Ensinando Assistentes de IA a Usar Ferramentas Externas

Aprenda como ensinar seu assistente de IA no BuildShip a usar ferramentas externas, como o nó 'Scrape Web URL', para executar tarefas e interagir com dados de websites e outras integrações.

BuildShip: Ensinando Assistentes de IA a Usar Ferramentas Externas

Introdução ao BuildShip e Assistentes de IA com Ferramentas

A capacidade de um assistente de Inteligência Artificial (IA) de interagir com ferramentas externas e executar tarefas complexas é um diferencial crucial na criação de soluções automatizadas e inteligentes. O BuildShip, uma plataforma de desenvolvimento low-code, oferece um Construtor de Assistentes de IA que permite não apenas criar conversas dinâmicas, mas também ensinar esses assistentes a utilizar ferramentas para realizar ações específicas. Este artigo explora como capacitar seu assistente de IA no BuildShip a empregar nós (nodes) como ferramentas, com base nas informações de um tutorial da própria plataforma.

Configurando seu Ambiente no BuildShip

Antes de mergulhar na funcionalidade das ferramentas, é essencial ter o ambiente básico configurado. Isso envolve:

  • Chave da API OpenAI: Adicionar sua chave da API da OpenAI aos segredos do seu projeto no BuildShip.
  • Criação do Assistente: Criar um assistente diretamente na plataforma da OpenAI (platform.openai.com), fornecendo um nome e escolhendo o modelo desejado. O restante da configuração, como instruções e ferramentas, será gerenciado pelo BuildShip.

O Template 'Website Q&A' como Ponto de Partida

O tutorial exemplifica o uso do template 'Website Q&A' (Perguntas e Respostas de Website). Este template já vem com uma estrutura pré-configurada que inclui um nó de Assistente OpenAI e um nó para 'obter website' (get website) como ferramenta.

A Importância das Instruções para o Assistente de IA

As instruções fornecidas ao assistente de IA são vitais para seu desempenho. No BuildShip, elas definem o comportamento, o tom e, crucialmente, como o assistente deve utilizar as ferramentas disponíveis. No exemplo do template 'Website Q&A', as instruções predefinidas moldam o assistente como um especialista em buscar informações de diversas fontes, respondendo de forma concisa, precisa e atualizada. Um ponto fundamental nas instruções é a orientação explícita para que o assistente use as ferramentas fornecidas e siga as diretrizes específicas para cada uma.

Recebendo Comandos e Mantendo o Contexto

Por meio de uma chamada de API REST, o assistente recebe o prompt do usuário (a pergunta ou comando) e, opcionalmente, um 'thread ID'. Este ID é essencial para manter o contexto de conversas anteriores, permitindo que o assistente dê seguimento a diálogos de forma coesa, como demonstrado em tutoriais anteriores da série do BuildShip.

Integrando Ferramentas: O Nó 'Scrape Web URL' no BuildShip

O BuildShip permite que qualquer um de seus nós (nodes) seja transformado em uma ferramenta para o assistente de IA. O tutorial foca no nó 'Scrape Web URL' (Extrair URL da Web) para demonstrar essa capacidade.

Descrevendo o Nó para Melhor Desempenho

Ao adicionar um nó como ferramenta, o BuildShip solicita que se descreva o nó para que o assistente OpenAI entenda seu propósito e como utilizá-lo. Isso envolve:

  • Nome Descritivo: Um nome claro para o nó, como 'get_website'.
  • Propósito do Nó: Uma descrição da função do nó, por exemplo, 'Extrai o conteúdo de texto de uma URL fornecida'. O guia do Assistente OpenAI do BuildShip oferece exemplos para essa descrição.

Essa clareza é crucial para que o assistente saiba quando e como acionar a ferramenta correta com base na solicitação do usuário.

Configurando Campos de Entrada: Auto-Preenchimento pela IA

Dentro do nó 'Scrape Web URL', existem campos de entrada. Alguns podem ser fixos, enquanto outros podem ser preenchidos dinamicamente pela IA.

  • URL: Este campo é ideal para auto-preenchimento. Ao habilitar essa opção, é necessário fornecer:
  • Nome do Campo de Entrada: Por exemplo, 'a url'.
  • Descrição do Tipo e Formato: Por exemplo, 'A URL a ser extraída'.

Quando configurado para auto-preenchimento, o campo de URL no BuildShip torna-se azul, indicando que a IA irá popular esse valor com base no contexto da conversa e nas instruções.

  • Seletor (Selector): No exemplo, este campo é fixo como 'body', indicando que o assistente deve extrair todo o conteúdo do corpo da página web.

Testando o Assistente de IA com Ferramentas no BuildShip

O tutorial demonstra o teste com um exemplo prático: planejar uma viagem para Barcelona. O usuário envia um prompt como:

{ "message": "Quais planos posso fazer em Barcelona? Use este website para responder: https://www.timeout.com/barcelona/things-to-do/best-things-to-do-in-barcelona" }

O assistente, seguindo as instruções, identifica a necessidade de usar a ferramenta 'get_website', passa a URL fornecida para a ferramenta, extrai o conteúdo da página da Time Out e, em seguida, formula uma resposta com sugestões de atividades em Barcelona. O BuildShip indica visualmente que a ferramenta foi utilizada através de um ícone de 'play' verde no nó correspondente.

Para dar seguimento à conversa, o usuário pode enviar um novo prompt incluindo o 'thread ID' retornado na resposta anterior:

{ "message": "Que outro lugar na Europa fica perto? Use este website para responder: https://www.timeout.com/", "threadId": "thread_xxx" }

O assistente, mantendo o contexto, utiliza novamente a ferramenta para sugerir cidades europeias próximas, como Londres, Paris e Lisboa, com base no conteúdo do site da Time Out.

Potencial Ilimitado com Diversas Ferramentas e o Chatbot Widget do BuildShip

A capacidade de integrar nós como ferramentas abre um leque de possibilidades. O BuildShip suporta integrações com Gmail, Firebase, Discord, Notion, Superbase, entre outros. Qualquer uma dessas pode ser uma ferramenta para o seu assistente de IA, permitindo que ele realize ações como enviar e-mails, consultar bancos de dados, interagir com comunidades ou gerenciar informações em plataformas de produtividade.

Além disso, a interação construída pode ser facilmente incorporada em um chatbot no seu website ou aplicativo utilizando o widget de chatbot open-source fornecido pelo próprio BuildShip, tornando a solução acessível aos seus usuários finais.

Conclusão: Expandindo as Capacidades da IA com o BuildShip

Ensinar assistentes de IA a usar ferramentas, como demonstrado pelo BuildShip, transforma-os de meros conversadores em agentes capazes de executar tarefas no mundo digital. A chave para o sucesso reside em instruções claras, descrições precisas das ferramentas e uma configuração cuidadosa dos campos de entrada. Com a flexibilidade da plataforma BuildShip e o poder dos modelos da OpenAI, os desenvolvedores podem criar assistentes de IA verdadeiramente úteis e dinâmicos, prontos para interagir com uma vasta gama de serviços e dados.