Adding URL buttons to KB responses

Overview

You can include relevant reference URLs in the AI assistant’s responses, allowing users to access more detailed content to users. In the Existing Knowledge page, you can find relevant knowledge and add reference URLs the AI agent’s responses. This feature enhances the user experience by providing additional information and resources to users when they are looking for some specific information.

image showcasing how to write an agent description

Knowledge Setting

Additional Settings in Knowledge Base

Find Knowledge Base under Agent Configuration and click to open the uploaded knowledge. Then, locate the Edit button and add a URL button to that knowledge entry.

image showcasing how to write an agent description

Choose the Knowledge to add URL Buttons to

Make sure to provide a clear Document Title for the agent to retrieve the knowledge easily. Additionally, carefully describe the information to your agent in the Document Text. Your description will help the agent to form a response based on the information you provide.

Now the AI agent will remember to attach the URL button in its response every time it retrieves this piece of information from the knowledge base.

Buttons

SeaChat Provides different ways to add additional information to the agent’s response. Choose the Buttons option to add a URL button to the agent’s response.

image showcasing how to write an agent description

Choose Button

The URL you provide here will be displayed as a button in the chat window. When the user clicks on the button, they will be redirected to the URL you have provided. Put the label that you wish to show your user in the Title and provide the URL in the Content field. You can add as many buttons as you want to the answer by simply clicking on the Plus(Add) sign.

image showcasing how to write an agent description

Add URL Button by Pressing Plus Button

Add URL Buttons to Knowledge Base Responses

Knowledge Base is where our agent will look for information to respond to user queries. A very powerful use case will be a FAQ agent, where the agent can provide answers to frequently asked questions. In this case, you can add URLs to the agent’s answers to provide more detailed information to users.

Now, let’s test out the URL button in the chat window. When the AI agent retrieves certain information from knowledge base as contextual information, it will display the answer with the URL button if the button feature is enabled for this piece of information. The user can click on the button to access the URL and get more detailed information. As simple as that!

Let’s first upload some information to the agent’s knowledge base. Please refer to here to find a way to upload information to the agent’s knowledge base.

Once there is information in the knowledge base, the agent will start using this information to respond to user queries. I will provide more than one URL in the agent’s answer to show you how it works. You can add as many URLs as you want to the agent’s answer.

image showcasing how to write an agent description

URLs added to Agent's Answer

KB IDs

A KB ID is a unique identifier for each piece of knowledge in the knowledge base. You can copy the ID of any knowledge item to your clipboard by clicking on the Copy KB ID button located under the More button for that knowledge.

You can then paste this KB ID to the content field of a button. The AI agent will then retrieve the information and return it to the user when the button is clicked.

This is particularly useful when the content of a button becomes too lengthy. For users that are using external channels like LINE, there is a set of limits related to the button messages.

Message Cutoff due to Message Limitation


The KB ID feature provides a solution for these users to provide detailed information without worrying about exceeding the character limit.

The AI agent will reference the knowledge base to retrieve the information and respond, bypassing the character limit imposed.

Not only does this feature free users from the character limit of the button content, but it also enables agent editors to better manage information in the knowledge base. Instead of overloading the button content with information, you can create a separate knowledge item accessible to the AI agent, which the button can link to.

Complete Message Using KB ID


🚨Attention 🚨

For security reasons, AI agents cannot access KB IDs from another AI agent’s knowledge base. KB IDs are unique to the knowledge in the knowledge base of a given AI agent, regardless of whether the agents are in the same workspace.

URL Buttons from Spreadsheets

You can also add URL buttons to your agent’s responses using a spreadsheet. When you are adding knowledge using a spreadsheet to upload a large amount of information, it can be difficult to add reference buttons to each knowledge manually. Don’t worry. SeaChat has a solution for you.

By adding columns called seachat_ref in your spreadsheet, your agent will automatically extract information to add URL buttons to the agent’s responses. You can put as many column as you want to add multiple URL buttons to the answer.

image showcasing how to write an agent description

Spreadsheet Example

Since the agent will look into this particular column, we need to make sure that we use the correct variables to help the agent understand the information.

Please make sure to follow the format below to ensure the agent can extract the information correctly:

In each row of the seachat_ref column, your AI agent will look for two pieces of information: button text (line 1) and button value (line 2). The following is what your seachat_ref column should look like:

"User Manual Wiki" --- line 1
"https://user-manual-wiki.com" --- line 2

🚨Attention🚨

If the button value is not a URL, e.g. some text, 2 paragraphs, or 3 URLs in 3 lines, the button will show the entire content of button value when clicked.

All the information that you put inside seachat_ref will be extracted as buttons. If the content of the button value is a URL, the button will redirect the user to that URL when clicked. If the button value is not a URL, the button will return the button value in a response.

image showcasing how to write an agent description

Buttons in Agent Response


That’s it. Now you no longer have to worry about manually adding URL buttons to your agent’s responses when you are uploading a spreadsheet with a large amount of information.

image showcasing how to write an agent description

Multiple URL Buttons in Agent Response


There are more advanced features in SeaChat agents' knowledge base that you can leverage to optimize your agent’s responses. Check out our tutorials on Advanced Features to learn more about these functionalities.