Skip to main content

Boltic AI Agent

The Boltic AI Agent lets you chat directly with your AI Agent (managed via Kaily) to get help, ask questions, or continue previous conversations.

Prerequisites​

  • A Kaily account — create one at kaily.ai.
  • At least one configured AI Agent in Kaily.

AI Agent​

Select the AI Agent you want to converse with. You can also create a new agent in Kaily if needed.

Query​

Enter your query in the input box. Examples:

  • "Where is my order?"
  • "Help me return a product."

You may also use outputs from other nodes or activities.

Manage the Conversation​

You can continue an existing chat or start a new one.

Continue an Existing Conversation​

  • Turn ON the Continue Conversation switch.
  • Enter your previous Conversation ID (returned in this node’s output).
  • The chat will resume from where it left off.
  • Note: If using this option, you may omit Host ID and User ID to reuse the last user from the conversation.

Start a New Conversation​

  • Turn OFF the Continue Conversation switch. A new chat will be created.
  • Optionally provide a Title (e.g., "Order Help" or "Returns").

Add Context (Optional)​

Add extra details that help the AI understand your question better, such as:

  • Order number
  • Preferred language
  • Any other helpful details

Enter these as key–value pairs in the Conversation Context section.

User Creation​

Identify who is chatting. You can chat as an anonymous user, use an existing user, or create a new one.

What is a Host ID?​

The Host ID is a unique identifier your system assigns to a user. It helps the AI Agent link the chat to the same user in your system.

Anonymous Users​

Turn this toggle ON to chat without specifying a user. A new user will be created automatically with a random ID, which will be returned in the response.

Using an Existing User​

  • Turn ON the Use Existing User switch.
  • Provide either Host ID or User ID (at least one is required).
  • If both are provided, Host ID takes priority.
  • Note: When continuing a conversation, ensure the provided Host ID or User ID matches the user from the conversation; otherwise, the request will fail.

Creating a New User​

  • Turn OFF the Use Existing User switch.
  • Fill in the following fields:
    • Host ID — Required
    • Email or Phone — At least one is required
    • Name — Optional
    • Additional Fields — Optional metadata to help the AI understand the user better
    • Phone — Must be in E.164 format (with country code), e.g., +911234567890. You may omit Phone if Email is provided.

Troubleshooting​

If something doesn’t work as expected:

  • Verify that user details are correct.
  • If continuing a chat, ensure the Conversation ID is valid.
  • Confirm your AI Agent configuration in Kaily.
  • Check that context values (if any) are entered properly.
  • If the issue persists, contact [email protected].