Brain

Visão Geral

O Brain é um agente de IA integrado ao Blip Studio, projetado para simplificar a criação e o gerenciamento de blocos de Agentes de IA. Utilizando linguagem natural, os usuários podem interagir com o Brain para executar uma variedade de tarefas, desde a configuração inicial de um agente até a implementação de funcionalidades avançadas, como a conexão com bases de conhecimento e a definição de ações personalizadas.

Esta documentação detalha as principais funcionalidades do Brain, fornecendo um guia completo para que os usuários possam extrair o máximo de potencial da ferramenta.

1. Gestão de Agentes

O Brain facilita a administração completa dos blocos do tipo "Agent" dentro do fluxo de um bot no Studio.

Funcionalidades Principais:

• Criar Agente:
  • Descrição: Cria um novo bloco de Agente no fluxo do bot.

  • Como usar: Para usar, peça ao Brain para "criar um novo agente". Você poderá definir o modelo de IA e criar o prompt completo de forma colaborativa ou apresentar um prompt pronto. O Brain te ajudará na criação, oferecendo sugestões, como a inclusão de exemplos no prompt, e fornecendo guardrails recomendados pela Blip. Além disso, você também poderá configurar o formato de resposta para o usuário (variável de saída ou a própria resposta), as condições de saída (handoffs) e as ferramentas de Ações (MCP/Tools) diretamente no momento da criação do agente.

  • Exemplo de comando: "Brain, crie um novo agente para responder a perguntas sobre nossos produtos."
• Recuperar Detalhes do Agente:
  • Descrição: Obtém todas as configurações de um agente específico já existente no fluxo.
  • Como usar: Indique ao Brain qual agente você deseja inspecionar.
  • Exemplo de comando: "Brain, quais são as configurações do agente de 'Suporte Técnico'?"
• Atualizar Agente:
  • Descrição: Modifica as configurações de um bloco de Agente existente.
  • Como usar: Especifique o agente e quais configurações você deseja alterar, como o prompt, o modelo de IA, as condições de saída, entre outros.
  • Exemplo de comando: "Brain, atualize o prompt do agente 'Vendas' para incluir a nova promoção."
• Remover Agente:
  • Descrição: Exclui um bloco de Agente do fluxo.
  • Como usar: Solicite a remoção do agente desejado.
  • Exemplo de comando: "Brain, remova o agente 'Teste'."
• Configurar as Condições de Saída (Handoffs) do agente:
  • Descrição: O Brain exibe todos os blocos disponíveis no fluxo, incluindo outros agentes, blocos determinísticos, atendimento humano e sub-fluxos, para que você possa configurar as condições de saída de um agente. Ele ajuda a criar parâmetros que devem ser preenchidos pelo agente ao fazer a transferência de bloco e auxilia na criação de descrições claras, garantindo que o agente compreenda adequadamente quando usar cada condição de saída.
  • Exemplo de comando: "Brain, quero que meu agente X transfira para o Y sempre enviando o nome e CPF do usuário"
• Criar/Editar Instruções (Prompt) para o Agente:
  • Descrição: O Brain permite criar e editar instruções de sistema, adicionar exemplos e configurar o tamanho do histórico de chat. Ele também possibilita a configuração de qual histórico do chat deve ser compartilhado entre diferentes agentes. Além disso, o Brain sugere e edita guardrails recomendados pela Blip, ajudando a melhorar o seu prompt.
  • Exemplo de comando: “Preciso de ajuda para melhorar meu prompt”
• Recomendar Guardrails na configuração do prompt:
  • Descrição: O Brain pode sugerir e adaptar as instruções de "guardrails" (diretrizes de segurança e comportamento), testadas e recomendadas pela Blip, para serem adicionadas ao prompt do seu agente. Isso inclui diretrizes sobre não mencionar concorrentes, manter um tom de voz específico e garantir que as respostas sejam baseadas em fontes confiáveis (grounding). 
  • Como usar: Durante a configuração do prompt de um agente, peça sugestões de guardrails.
  • Exemplo de comando: "Brain, me dê sugestões de guardrails para um agente que lida com informações financeiras."
• Configurar a resposta (output) do agente: 
  • Descrição:  O Brain auxilia na configuração das respostas do seu agente, determinando se a resposta deve ser enviada ao usuário ou salva em uma variável. Caso seja salva em uma variável, o Brain também ajuda a configurar para qual bloco redirecionar e em qual variável deve ser salva. Além disso, ele configura os tipos de saída possíveis para o agente e ajuda a criar saídas personalizadas.
  • Exemplo de comando: “Gostaria que meu agente de classificação de intenção de compra responda apenas com um objeto indicando se há ou não intenção de compra”
• Configuração de Ferramentas proprietárias (MCP/Tools): 
  • Descrição: Com o auxílio do Brain, você pode adicionar seu MCP (Model Context Protocol) proprietário para que o agente acesse as ferramentas criadas por você. Caso deseje configurar ações pré-estabelecidas no Studio, isso também é possível. Veja mais detalhes abaixo sobre como configurar essas ferramentas e ações pré-estabelecidas, garantindo que seu agente utilize todas as funcionalidades personalizadas que você desenvolveu.
  • Exemplo de comando: “Quero adicionar minhas tools de recomendação de produto no meu agente de vendas”
• Verificar e Corrigir Erros no Seu Agente:
  • Descrição: Se o seu agente estiver apresentando blocos vermelhos ou indicando erros, o Brain pode ajudar a analisar, sugerir melhorias e editar para corrigir esses problemas. Essa funcionalidade permite identificar rapidamente os pontos de falha e aplicar as correções necessárias, garantindo que seu agente funcione de maneira eficaz e sem interrupções.
  • Exemplo de comando: “Porque meu agente de FAQ está indicando um erro com a cor vermelha no bloco?

2. Knowledge Base (Base de Conhecimento)

Gerencie a base de conhecimento que seus agentes utilizam para formular respostas.

Funcionalidades Principais:

• Verificar Configuração da Base de Conhecimento:
  • Descrição: Mostra como a base de conhecimento está configurada para um agente específico.
  • Exemplo de comando: "Brain, qual é a base de conhecimento do agente 'Dúvidas Frequentes'?"
• Listar Catálogos de Conhecimento:
  • Descrição: Exibe todos os catálogos de conhecimento disponíveis que podem ser vinculados a um agente. Este é o primeiro passo para configurar uma base de conhecimento.
  • Exemplo de comando: "Brain, liste os catálogos de conhecimento disponíveis."
• Listar Documentos em um Catálogo:
  • Descrição: Mostra todos os documentos contidos dentro de um catálogo de conhecimento específico.
  • Exemplo de comando: "Brain, quais documentos estão no catálogo 'Políticas da Empresa'?"
• Configurar Base de Conhecimento em um Agente:
  • Descrição: Associa um ou mais catálogos e/ou documentos específicos a um bloco de Agente, permitindo que ele use essas informações para responder aos usuários.
  • Exemplo de comando: "Brain, configure o agente 'RH' para usar o catálogo de 'Benefícios'."
• Remover Configuração da Base de Conhecimento:
  • Descrição: Desvincula a base de conhecimento de um agente.
  • Exemplo de comando: "Brain, remova a base de conhecimento do agente 'Promoções'."

3. Actions Tools (Ferramentas de Ação)

Potencialize seus agentes adicionando ferramentas que permitem a execução de ações, como chamadas HTTP, execução de scripts e definição de variáveis. 

Funcionalidades Principais:

• Definir Ferramentas de Ação:
  • Descrição: Adiciona e configura ferramentas de ação em um agente, como "Requisição HTTP", "Executar script", "Definir variável", entre outras. O Brain ajuda a configurar quais aspectos dessas ações devem ser preenchidos pelo agente (como parâmetros durante a execução) e quais devem ser definidos como padrão (campos setados). Isso permite uma personalização eficiente das ações do agente, assegurando que ele execute as tarefas conforme esperado.
  • Exemplo de comando: "Brain, adicione uma ferramenta de requisição HTTP ao agente 'Status do Pedido'."
• Remover Ferramentas de Ação:
  • Descrição: Remove uma ou todas as ferramentas de ação de um agente. 
  • Exemplo de comando: "Brain, remova a ferramenta' que salva informações do contato do agente 'Status do Pedido'." ou "Brain, remova todas as ações do agente 'Status do Pedido'."

Auxiliares para a Ação "Executar Função da Biblioteca":

• Listar Funções da Biblioteca:
  • Descrição: Mostra todas as funções disponíveis na sua "Function Library".
  • Exemplo de comando: "Brain, liste todas as funções da minha biblioteca."
• Recuperar Detalhes de uma Função:
  • Descrição: Exibe o código e os metadados (informações) de uma função específica.
  • Exemplo de comando: "Brain, mostre os detalhes da função 'calcularFrete'."
• Criar Nova Função:
  • Descrição: Permite criar uma nova função e adicioná-la à "Function Library".
  • Exemplo de comando: "Brain, crie uma nova função chamada 'verificarEstoque'."
• Excluir Função:
  • Descrição: Remove uma função existente da "Function Library".
  • Exemplo de comando: "Brain, exclua a função 'verificarEstoqueAntigo'."

Auxiliares para a Ação "Adicionar/Remover Contato da Lista de Distribuição":

• Recuperar Listas de Distribuição:
  • Descrição: Mostra todas as listas de distribuição associadas ao bot.
  • Exemplo de comando: "Brain, quais são as listas de distribuição deste bot?"
• Criar Nova Lista de Distribuição:
  • Descrição: Cria uma nova lista de distribuição para o bot.
  • Exemplo de comando: "Brain, crie uma lista de distribuição chamada 'Clientes VIP'."