Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.shieldbase.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Automate interaction with users with natural language by responding to questions, performing tasks, and providing information.

​
Types of Chatbots

Simple, Single-Source ChatbotA basic chatbot that uses:
  • One source of information as Context
  • One-step Workflow
  • Unlimited open-ended conversations
Perfect for:
  • FAQ bots
  • Simple customer support
  • Information retrieval

​
Build a Basic Chatbot

Build a basic chatbot that uses only one source of information as Context, and one-step Workflow. This chatbot is capable of interacting with users in unlimited open-ended conversations.

​
Video Tutorial

💡 Tip: Adjust video playback speed using the gear icon (⚙️) in the video player. We recommend 0.5x speed for detailed tutorials.

​
Step-by-Step Instructions

1

Create Workflow

  1. Navigate to Workflows
  2. Click New Workflow
  3. You’ll be in Build mode automatically
2

Configure Node

  1. Click on the node to reveal details
  2. In the Description field, specify what will be shown to the user
  3. Click Save Changes
3

Create Chatbot

  1. Click Chatbot in the sidebar
  2. A new chatbot setup will be automatically created
4

Configure Chatbot

  1. Specify the Name of the chatbot
  2. Enter the Title that will appear at the top
  3. Select data from the Context
  4. Enable Guardrails to ensure responses come from selected data
  5. Click Save

​
Build an Advanced Chatbot

Build an advanced chatbot with controlled conversation based on multiple sources of information as Context, and multiple steps specified in the Workflow.

​
Video Tutorial

Advanced chatbots allow for complex, multi-step conversations with decision trees and conditional logic.

​
Step-by-Step Instructions

1

Create Workflow

  1. Navigate to Workflows
  2. Click New Workflow
2

Configure First Node

  1. Click on the node to reveal details
  2. Specify the initial user interaction in Description
  3. Click Save Changes
3

Add Multiple Steps

  1. Click Add Action to add new steps
  2. Configure each step with specific actions
  3. Consider using the Handle Conversation action node to allow dynamic conversation routing
  4. Connect steps to create conversation flow
  5. Save changes for each step
4

Create Chatbot

  1. Click Chatbot in the sidebar
  2. Configure name and title
  3. Select multiple data sources from Context
  4. Enable Guardrails for accuracy
  5. Click Save

​
Share the Chatbot

Once your chatbot is configured, you can share it externally so users can interact with it without logging into Shieldbase. There are two primary ways to publish and share a chatbot:

​
Method 1: Embed in a Website

Turn on public access to generate an embed code, then paste the code snippet into your website’s HTML (typically in the <head> section or where your widget scripts are loaded). The chatbot will appear as an embedded widget on your site, allowing visitors to start a conversation directly from the page.
1

Enable Public Access

Turn on public access in the chatbot settings to generate an embed code.
2

Copy Embed Code

Copy the generated code snippet.
3

Add to Your Website

Paste the code snippet into your website’s HTML (typically in the <head> section or where your widget scripts are loaded).

​
Method 2: Share as a Standalone Experience

Enable public access by clicking Make Chatbot Public. Shieldbase will generate a shareable URL that you can send to anyone. Users can open this link in their browser to interact with the chatbot in a dedicated page, without requiring additional setup, embedding, or login.
1

Make Chatbot Public

Click Make Chatbot Public to enable public access.
2

Copy Shareable URL

Shieldbase generates a shareable URL.
3

Share the Link

Send the URL to anyone — they can interact with the chatbot in a dedicated page without logging in.

​
Chatbot Configuration Options

​
Context Settings

Select one or more data sources that the chatbot will use:
  • Library documents
  • Integrated databases
  • API connections
  • Web resources
Always enable Guardrails to ensure that the AI only sources information from the Context and avoids hallucination.
Guardrails ensure:
  • Accurate responses from selected sources
  • No fabricated information
  • Consistent answers
  • Data privacy compliance

​
Deployment Options

Deploy chatbots for internal team use:
  • Employee assistance
  • IT helpdesk
  • HR support
  • Knowledge management

​
Pro Tips

Define Purpose

Clearly define what problem your chatbot will solve before building

Test Thoroughly

Test both expected and unexpected conversation flows

Brand Personality

Give your chatbot a personality that extends your brand

Regular Updates

Update context data regularly to keep responses current

​
Use Case Examples

​
Customer Support Bot

Context: Product documentation, FAQ database, support ticketsWorkflow:
  1. Greet customer
  2. Identify issue category
  3. Provide solution or escalate
  4. Collect feedback
Guardrails: Enabled to ensure accurate product information

​
Lead Generation Bot

Context: Product catalog, pricing information, case studiesWorkflow:
  1. Welcome visitor
  2. Qualify interest
  3. Collect contact information
  4. Schedule demo or send resources
Guardrails: Enabled for consistent pricing and features

​
HR Assistant Bot

Context: Employee handbook, benefits information, policiesWorkflow:
  1. Verify employee identity
  2. Categorize query
  3. Provide information or forms
  4. Log interaction for HR team
Guardrails: Enabled for policy compliance

​
Best Practices

Never disable Guardrails in production chatbots handling sensitive or critical information.
Start Simple: Begin with a basic chatbot and add complexity as you understand user needs better.
Monitor Performance: Regularly review chat logs to identify areas for improvement and common user queries.

​
Troubleshooting

  • Check that Context data is properly indexed
  • Verify Guardrails are enabled
  • Review workflow configuration
  • Test with simpler prompts
  • Reduce the amount of Context data
  • Optimize workflow steps
  • Check integration connections
  • Contact support if issue persists
  • Verify the Public checkbox is enabled
  • Check that embed code is properly formatted
  • Ensure your website allows external scripts
  • Test in different browsers