Studio: Primeiros Passos - Configurações Básicas – Blip | Blip Help

Introdução
Criação e configuração de agentes no Studio
2.1 Como criar um bloco de Agente
2.2 Como configurar o bloco de Agente
2.2.1 Renomeando o Agente
2.2.2 Configurando a aba Instruções
2.2.3 Configurando a Base de Conhecimento
2.2.4 Configurando a aba Condições de saída
2.2.5 Configurando a aba Ferramentas
Como colocar seu contato inteligente em produção?
Exemplo Orquestrador completo
Exemplo FAQ AI Agents

Introdução

O Studio foi projetado para permitir a criação e personalização de agentes de Inteligência Artificial de forma visual e intuitiva. Com ele, você pode personalizar o comportamento do seu agente, definir sua base de conhecimento, estabelecer condições de saída para o fluxo e integrar ferramentas externas.

Essa ferramenta centraliza todos os recursos necessários para que você construa e gerencie agentes inteligentes de forma intuitiva.

Criação e configuração de agentes no Studio

Nota: Ao final deste artigo, você encontrará os arquivos JSON da configuração. Você pode copiá-lo e importá-lo diretamente no Studio para fazer os ajustes que desejar.

Como criar um bloco de Agente

Na tela do Studio, clique em Adicionar bloco e escolha a opção Agente.

Um novo bloco de Agente será adicionado ao Studio.

Como configurar o bloco de Agente

Ao clicar no bloco de Agente criado, é possível configurá-lo através do menu lateral.

Renomeando o Agente

Primeiramente, você pode renomear o bloco para facilitar a sua identificação. No exemplo a seguir, o Contato Inteligente será um FAQ sobre o Agente.

Configurando a aba Instruções

Nesta seção, você pode personalizar seu Agente para atender às suas necessidades. Escolha o modelo de linguagem (LLM), defina a temperatura e quantidade máxima de tokens, insira as instruções iniciais do agente, entre outras opções.

Uma configuração precisa é fundamental para otimizar o desempenho do seu agente.

Para configurar um modelo, clique no botão Configurar agente, ao lado da indicação do modelo na aba de Instruções. A tela Configurar Instruções será exibida.

Na aba Modelo, no menu suspenso, é possível escolher a versão do modelo a ser utilizada.

Agora, o Studio oferece suporte a múltiplos modelos de linguagem, ampliando a flexibilidade para a criação de agentes e automações mais adequadas a diferentes casos de uso.

Essa expansão permite que você escolha exatamente o modelo que melhor se adapta às necessidades de interpretação de arquivos, performance e profundidade de resposta desejadas para cada fluxo conversacional.

Veja os modelos disponíveis em nosso Guia de Escolhas de Modelos de IA.

Para expandir o campo de Instruções (Prompt) do seu agente no Blip Studio, siga os passos abaixo:

1. Abra o painel do Agente: No fluxo, clique na caixa do Agente que você deseja editar para abrir o painel lateral direito de configurações.

2. Acesse o modo de expansão: No canto superior do campo de Instruções, passe o mouse sobre o bloco de texto ou clique no ícone de Expandir (duas setas diagonais ou botão de maximizar) localizado no canto superior direito da caixa de texto.

3. Edite o prompt em tela cheia: O campo abrirá em uma janela centralizada maior (modal), permitindo que você visualize e edite todo o texto do prompt com facilidade.

Verificação de modelos de IA disponíveis

Para verificar e comparar todos os modelos de Inteligência Artificial (LLMs) disponíveis no Blip Studio, siga estes passos:

1. Abra a configuração do Agente: No painel do seu fluxo, clique no agente pretendido e depois no botão Configurar agente (ou no ícone de engrenagem).

2. Acesse a seleção de modelos: Na aba Modelo, localize o campo Selecionar modelo onde o modelo atual está listado.

3. Abra a tela de comparação: Clique no botão Comparar modelos, localizado logo abaixo dos parâmetros na parte inferior da coluna de configuração.

4. Navegue pelas opções disponívels: Uma janela modal (Comparar e escolher modelo da LLM) será aberta exibindo a lista completa de modelos organizados por categorias (OpenAI, Gemini, Open Source, Custo-benefício, etc.).

Configurando o Modelo de IA e Parâmetros de Raciocínio

Para acessar essas configurações, siga os passos abaixo:

Clique na caixa com o nome do Agente.
Acesse a aba “Instruções”.
Clique no botão "Configurar Agente".
Em seguida, selecione a aba "Modelo", onde você encontrará os parâmetros de raciocínio.

1. Selecionando o Modelo da IA

O primeiro passo é escolher a tecnologia que alimentará o seu agente, podendo ser modelos da OpenAI ou do Google Gemini.

A interface do Studio se ajustará automaticamente para exibir ou ocultar parâmetros específicos dependendo das restrições da tecnologia selecionada.
Diferente dos modelos tradicionais de chat lineares (como o GPT-4.1), os modelos de raciocínio possuem uma estrutura interna de processamento prévio que atua como uma cadeia de pensamento antes de entregar o resultado final.

2. Configurando os Parâmetros do Modelo

Os parâmetros permitem que você ajuste como o agente pensa, o tamanho da resposta e o tom de voz.

Esforço de Raciocínio

Este parâmetro controla a profundidade do raciocínio interno (a etapa oculta de "cadeia de pensamento") do modelo antes de gerar a resposta final.

Quanto maior o esforço de raciocínio configurado, maior tende a ser o consumo de tokens e o tempo de resposta.
Níveis mais altos resultam em uma qualidade superior de entrega.
Atenção: As opções disponíveis na tela mudam dinamicamente conforme o modelo escolhido. Alguns exemplos incluem:
- Nenhum: Desativa o raciocínio prévio para uma resposta direta, disponível para modelos como gpt-5.4, gpt-5.6-luna e a família Gemini Flash. O modelo o4-mini, por exemplo, não aceita essa opção porque sempre raciocina por design.
- Mínimo: Raciocínio mínimo, presente em modelos como gpt-5, gpt-5.1 e famílias do Gemini.
- Baixo, Médio e Alto: Níveis proporcionais à complexidade, suportados por todas as famílias de modelos de raciocínio.
- Muito Alto e Máximo: Níveis de esforço extra exclusivos para modelos de ponta específicos da OpenAI, como o gpt-5.6-luna. Estas opções não estão mapeadas para o Gemini.

Estilo de Resposta

Este parâmetro define se a resposta do agente deve ser mais concisa e direta ou mais elaborada.

Ele não controla o pensamento interno, mas sim a densidade e completude da resposta final entregue ao usuário.
Você pode escolher opções como resposta enxuta e direta (Precisa), nível intermediário (Balanceado) e resposta completa e detalhada (Criativo).
Regra importante: A opção “Personalizado” é aplicável exclusivamente aos modelos de raciocínio do Google Gemini, assim como a "Temperatura Personalizada".
- A Temperatura é um valor numérico que controla a aleatoriedade ou criatividade da IA:
  - Temperaturas baixas geram respostas previsíveis, diretas e factuais.
  - Temperaturas altas permitem maior criatividade, variação de
    palavras e originalidade.

Limite de Tokens

Define o número máximo aproximado de tokens que podem ser usados na resposta do agente. Se a resposta exigir mais tokens do que o valor definido, ela será interrompida na metade.

Atenção aos Modelos de Raciocínio: Esses modelos consomem mais tokens naturalmente devido ao seu processamento interno prévio. Se o limite configurado for muito baixo, a IA pode consumir boa parte da cota de tokens apenas "raciocinando", o que fará com que a resposta final saia truncada (incompleta) ou até vazia. Por isso, considere sempre configurar limites de tokens mais altos ao utilizar modelos de raciocínio.

Onde acessar:
Configurar Agente → Modelo → Modelos de LLM disponíveis

Nessa mesma aba, também é possível:

Definir a temperatura do modelo;
Definir a quantidade máxima de tokens;
Ativar/desativar o histórico de mensagem (memória de curto prazo).

Já na aba Resposta é possível:

Definir se a resposta do agente será enviada ao usuário no canal de atendimento ou armazenada em uma variável. Ao armazenar em uma variável, permite que outros agentes possam utilizá-la.

Definir o formato de resposta do agente. Podendo escolher vários formatos (inclusive um formato personalizado).

Já na aba Interpretação é possível:

Definir tipos de arquivos que o agente será capaz de interpretar, além de configurar o tratamento caso o agente receba um tipo não suportado.

Após definir as configurações do agente, basta clicar em Salvar. Caso não tenha feito alteração, basta clicar em Cancelar.

Ainda na aba de Instruções, é possível configurar instruções para o Agente. Para cada instrução é possível selecionar o seu nível, podendo escolher entre: Sistema, Usuário, Agente, Histórico. Vamos passar por cada um:

Nível de Sistema

O nível de sistema define o comportamento geral, a persona e as restrições do agente de IA. É a instrução mais fundamental que estabelece o contexto e as regras de como o modelo deve responder, independentemente da entrada específica do usuário.

Exemplo de uso: "Você é um especialista em programação Python. Responda de forma clara e objetiva, fornecendo exemplos de código sempre que possível."

Nível de Usuário

O nível de usuário representa a entrada ou consulta direta do usuário final. Ele contém a pergunta ou instrução específica que o usuário deseja que a IA resolva em uma determinada interação.

Exemplo de uso: "Qual é a capital da França?"

Nível de Agente

O nível de agente representa as respostas geradas pelo próprio agente de IA. Em uma conversa com múltiplos turnos, as mensagens anteriores da IA podem ser incluídas como contexto para as interações seguintes, mantendo a coerência do diálogo.

Exemplo de uso: "A capital da França é Paris."

Nível de Histórico

O nível de histórico permite utilizar históricos de mensagens de outros agentes. Dessa forma, é possível integrar o contexto deles ao agente atual.

Exemplo de uso:

Na prática:

Adicione uma instrução

Selecione o nível de instrução:

Informe a instrução:

Na instrução de Histórico, você verá o ícone Manipular histórico. Ele permite configurar como deve ser inserido o histórico de mensagens de outros agentes. Você poderá configurar a quantidade de mensagens e a ordem delas.

Nas instruções de Sistema e Agente, você verá um ícone de escudo. Ele oferece sugestões de instruções de guardrail que você pode adicionar ao seu agente. Basta copiá-las e inseri-las na instrução.

Para o exemplo, vamos criar uma nova instrução de sistema e adicionar um guardrail para a base de conhecimento.

Em cada instrução é possível executar ações de remover e duplicar a instrução através dos botões:

É possível mover a instrução clicando e arrastando-a pelo botão lateral (seis pontos) que aparece ao passar o mouse. Assim, você pode organizar a ordem das instruções, o que é crucial para o comportamento do agente.

Se a opção de histórico de contexto estiver ativada na configuração do modelo, ele também aparecerá na tela de instruções e poderá ser ordenado com as demais.

Configurando a Base de Conhecimento

Passando agora para a aba de Ferramentas, vemos o seguinte ao abrir a primeira vez:

Para que o agente acesse informações, ele precisa de catálogos. Esses catálogos centralizam o conhecimento a partir de arquivos e URLs, organizando tudo sobre um mesmo tema. Para saber mais sobre os catálogos acesse o tutorial sobre Base de Conhecimento.

Como o seu agente acabou de ser criado, ele ainda não tem nenhum catálogo vinculado. Para adicionar um, basta clicar no botão "Ferramentas" "+ Adicionar Ferramentas" + “Base de Conhecimento”

Ao clicar em Base de conhecimento a janela Adicionar Catálogos é aberta. Para criar um novo catálogo, clique em "Criar catálogo". Você será redirecionado para a tela de gerenciamento de Base de Conhecimento, onde poderá criar/remover catálogos.

Seguindo nosso exemplo de FAQ sobre AI Agents, vamos criar um catálogo usando um arquivo XLSX com perguntas e respostas e uma URL, contendo informações sobre tipos de arquivos aceitos na base de conhecimento de um AI Agent.

Após a criação, o catálogo será listado na tela Adicionar Catálogos no Studio e já estará disponível para ser vinculado ao seu agente. Para mais detalhes sobre a criação de catálogos, confira o tutorial de Base de Conhecimento.

Para vincular um catálogo ao agente, selecione o checkbox correspondente. Após a seleção, o catálogo ficará visível para consulta.

Além disso, você pode gerenciar seus arquivos e URLs na base de conhecimento, basta selecionar os itens desejados (como arquivos XLSX ou links) para definir quais informações o agente deve utilizar.

Executando o Contato Inteligente

Agora é um bom momento para testar o Contato Inteligente (CI) com o Agente. Para isso, conecte o bloco Início ao bloco Faq AI Agent e publique o fluxo do CI. No chat de teste de fluxo é possível interagir com o agente.

Configurando a aba Condições de saída

Para configurar a aba Condições de saída, vamos criar um novo fluxo. A ideia é construir um Contato Inteligente da Blip com três agentes:

Agente de Planos: Especializado em planos que a Blip oferece.
Agente de Produtos: Especializado em produtos disponíveis.
Agente Orquestrador: Responsável por entender a intenção do usuário e direcioná-lo para o agente especialista correto.

Neste cenário, também adicionaremos blocos determinísticos para mostrar que é possível combiná-los com os blocos de AI Agents.

Para começar, vamos adicionar os blocos determinísticos que darão as boas-vindas e coletarão o nome do usuário. Para isso, vamos copiar blocos prontos da Biblioteca de blocos e adaptá-los para o nosso exemplo.

O fluxo inicial ficou assim:

Agora, você pode criar o agente orquestrador e definir suas instruções.

Neste exemplo, ele terá três instruções de sistema:

A primeira define seu papel como orquestrador.
A segunda o instrui a chamar o usuário pelo nome, usando uma variável para personalização.
A terceira é um guardrail para garantir que o orquestrador não enviará mensagens desnecessárias para o usuário.

As bases de conhecimento para os agentes especialistas serão as URLs de produtos e de planos da Blip.

As instruções para cada agente serão as seguintes:

Definição de Papel: Descreve a área de especialização do agente.
Guardrails de Concorrência: Evita que o agente mencione concorrentes ou serviços similares.
Guardrails de Tom de Voz: Garante que as respostas serão em português e manterão um tom amigável.
Guardrails de Grounding: Garante que todas as informações fornecidas sejam baseadas exclusivamente na base de conhecimento.
Nome do usuário: Garante que o agente chame o usuário pelo nome.

Agora, basta criar os agentes, configurando-os com essas instruções e a base de conhecimento, como visto nas etapas anteriores.

Agente especialista em planos da Blip:

Agente especialista em produtos da Blip:

Agora você pode configurar as condições de saída. Elas orientam o agente sobre o próximo bloco que o usuário será direcionado, garantindo a continuidade correta do fluxo.

Vamos começar pelo Orquestrador. Na aba Condições de saída, clique no botão + Adicionar direcionamento.

Em Definições, preencha o nome, a descrição e o bloco de destino, e salve a instrução. Crie uma condição de saída para cada agente especialista.

Também é possível definir uma condição de saída para casos de exceção.

Agora, para cada agente especialista, vamos criar uma condição de saída para voltar para o agente orquestrador. Com isso, o usuário consegue voltar e trocar de contexto.

E assim ficou o fluxo:

Agora é só testar!

Configurando a aba Ferramentas

A aba Ferramentas permite que você configure as instruções para o agente interagir com recursos externos. Para vermos um exemplo prático, vamos voltar ao agente Orquestrador.

Ao clicar em Adicionar ferramenta, uma lista de opções será exibida. Para cada uma, além de definir um nome, é necessário fornecer uma descrição — que orienta o agente sobre quando acionar a ação — e configurar os dados específicos para sua execução.

Vamos exemplificar com a ferramenta Definir contato, utilizada para armazenar dados do usuário. Visto que já capturamos o nome, iremos aproveitá-lo para preencher os dados de contato. Para isso, basta alterar o nome, informar a descrição e mapear a variável {{nome}} ao campo correspondente.

Você pode adicionar condições para que a definição do contato ocorra. Por exemplo, é possível incluir uma validação para o nome do usuário.

Para testar o funcionamento, vamos ajustar a instrução que usamos para passar o nome do usuário. Em vez de usar a variável {{nome}}, vamos alterar a instrução para buscar o nome diretamente de {{contact.name}} e validar que o agente ainda consegue chamar o usuário pelo nome:

Como colocar seu contato inteligente em produção?

Para colocar em produção (publicar) o seu fluxo do contato inteligente no Blip Studio, basta clicar no botão azul "Publicar fluxo" localizado no canto superior direito da tela.

Passo a passo para publicar:

Clique no botão "Publicar fluxo" localizado no canto superior direito.
Se o sistema exibir uma tela de confirmação de alterações ou avisos, leia os detalhes e confirme a ação.
A interface mostrará que a publicação foi concluída com sucesso.

Como verificar se deu certo:

Após publicar, realize um teste enviando uma mensagem para o canal conectado (por exemplo, o WhatsApp de testes ou o canal ativo do seu bot) e veja se a resposta segue a estrutura do novo fluxo publicado.

Exemplo Orquestrador completo

Faça o download do exemplo aqui.

Exemplo FAQ AI Agents