Brain

Overview

The Brain is an AI agent integrated into Blip Studio, designed to simplify the creation and management of AI Agent blocks. Using natural language, users can interact with the Brain to perform a variety of tasks — from the initial setup of an agent to implementing advanced features such as connecting to knowledge bases and defining custom actions.

This documentation details the main functionalities of the Brain, providing a complete guide so users can get the most out of the tool.

Agent Management

The Brain facilitates complete administration of “Agent” blocks within a bot’s flow in Studio.

Main Features:

Create Agent:
Description: Creates a new Agent block in the bot’s flow.
How to use: Ask the Brain to “create a new agent.” You can define the AI model and collaboratively create a full prompt or provide a ready-made one. The Brain assists with creation by suggesting improvements (like including examples in the prompt) and offering Blip-recommended guardrails. You can also configure the response format (output variable or direct reply), exit conditions (handoffs), and action tools (MCP/Tools) during creation.
Example command: “Brain, create a new agent to answer questions about our products.”

Retrieve Agent Details:
Description: Retrieves all settings of a specific agent already existing in the flow.
Example command: “Brain, what are the settings of the ‘Technical Support’ agent?”

Update Agent:
Description: Modifies the settings of an existing Agent block.
Example command: “Brain, update the ‘Sales’ agent prompt to include the new promotion.”

Remove Agent:
Description: Deletes an Agent block from the flow.
Example command: “Brain, remove the ‘Test’ agent.”

Configure Agent Exit Conditions (Handoffs):
Description: The Brain displays all available blocks in the flow — including other agents, deterministic blocks, human support, and sub-flows — so you can configure agent exit conditions. It helps you create parameters to be filled during the handoff and assists with clear descriptions to ensure the agent understands when to use each condition.
Example command: “Brain, I want my agent X to transfer to Y while always sending the user’s name and ID.”

Create/Edit Agent Instructions (Prompt):
Description: The Brain allows you to create and edit system instructions, add examples, and set chat history size and sharing between agents. It also suggests and edits Blip-recommended guardrails to improve your prompt.
Example command: “I need help improving my prompt.”

Recommend Prompt Guardrails:
Description: The Brain can suggest and adapt “guardrail” instructions (safety and behavior guidelines) tested and recommended by Blip. These include avoiding competitor mentions, maintaining a specific tone of voice, and ensuring responses are grounded in reliable sources.
Example command: “Brain, suggest guardrails for an agent handling financial information.”

Configure Agent Response (Output):
Description: The Brain helps set up how the agent’s response should be delivered — directly to the user or stored in a variable. It also helps define redirection rules, output variable names, and custom response types.
Example command: “I’d like my purchase intent classifier agent to respond only with an object indicating whether or not there is intent.”

Configure Proprietary Tools (MCP/Tools):
Description: With the Brain’s help, you can add proprietary MCP tools so your agent can access custom-built actions. You can also configure predefined Studio actions.
Example command: “I want to add my product recommendation tools to my sales agent.”

Check and Fix Agent Errors:
Description: If your agent shows red blocks or errors, the Brain can analyze, suggest fixes, and apply corrections to ensure smooth operation.
Example command: “Why is my FAQ agent showing a red error block?”

 Knowledge Base

Manage the knowledge base your agents use to generate answers.

Main Features:

Check Knowledge Base Configuration:
Description: Shows how the knowledge base is configured for a specific agent.
Example command: “Brain, what is the knowledge base for the ‘FAQs’ agent?”

List Knowledge Catalogs:
Description: Displays all available knowledge catalogs that can be linked to an agent.
Example command: “Brain, list available knowledge catalogs.”

List Documents in a Catalog:
Description: Displays all documents contained within a specific knowledge catalog.
Example command: “Brain, what documents are in the ‘Company Policies’ catalog?”

Configure Knowledge Base for an Agent:
Description: Links one or more catalogs and/or documents to an agent block, allowing it to use that information in responses.
Example command: “Brain, configure the ‘HR’ agent to use the ‘Benefits’ catalog.”

Remove Knowledge Base Configuration:
Description: Unlinks a knowledge base from an agent.
Example command: “Brain, remove the knowledge base from the ‘Promotions’ agent.”

Action Tools

Enhance your agents by adding tools that perform actions such as HTTP requests, running scripts, and defining variables.

Main Features:

Define Action Tools:
Description: Adds and configures action tools in an agent, such as “HTTP Request,” “Run Script,” or “Set Variable.” The Brain helps define which aspects are dynamic (set by the agent) and which are fixed (preset fields).
Example command: “Brain, add an HTTP request tool to the ‘Order Status’ agent.”

Remove Action Tools:
Description: Removes one or all action tools from an agent.
Example command: “Brain, remove the tool that saves contact info from the ‘Order Status’ agent.” or “Brain, remove all actions from the ‘Order Status’ agent.”

Helpers for the ‘Run Library Function’ Action:

List Library Functions: Shows all available functions in your Function Library.
Example: “Brain, list all functions in my library.”

Retrieve Function Details: Displays code and metadata of a specific function.
Example: “Brain, show details of the ‘calculateShipping’ function.”

Create New Function: Allows creating and adding a new function to the Function Library.
Example: “Brain, create a new function called ‘checkStock’.”

Delete Function: Removes a function from the Function Library.
Example: “Brain, delete the function ‘oldCheckStock’.”

Helpers for the ‘Add/Remove Contact from Distribution List’ Action:

Retrieve Distribution Lists: Displays all distribution lists linked to the bot.
Example: “Brain, what are this bot’s distribution lists?”

Create New Distribution List: Creates a new distribution list for the bot.
Example: “Brain, create a distribution list called ‘VIP Clients’.”

For more information, visit the discussion on the subject at our community or videos on our channel. 😃