Connect ChatBotKit to Your AI Agent

Choose a dataset or conversation to retrieve relevant records and inspect the messages returned.

Try a ChatBotKit Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill ChatBotKit

Find Relevant Knowledge Records

Search a specified dataset and summarize returned matches.

/oo ChatBotKit: Search ChatBotKit dataset [dataset ID] for “[question or phrase]”. Summarize the returned matching records and retain any source metadata.

Review a Conversation

Read an identified conversation and its messages.

/oo ChatBotKit: Read ChatBotKit conversation [conversation ID] and list its messages. Summarize the discussion and unresolved questions in the returned messages.

Add a Knowledge Record

Store supplied text in a chosen dataset.

/oo ChatBotKit: Create a record in ChatBotKit dataset [dataset ID] with text “[knowledge text]”. Report the returned record.

Start Working with ChatBotKit

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect ChatBotKit

Connect a ChatBotKit API key.
Connect ChatBotKit →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

Access to the dataset or conversation you want to use.
Dataset search returns matching records. Conversation message creation and generating the next assistant reply are separate operations.

ChatBotKit Tools

This connection manages ChatBotKit bots, conversations, datasets, records, and files and supports semantic dataset search and conversation replies.

Datasets and Records

Inspect datasets, search their records, and add supplied text.

Conversation Records and Replies

Read messages or request the next reply in an identified conversation.

27 tools

Fetch Usage

Fetch account-wide ChatBotKit usage statistics for tokens, conversations, messages, and database resources.

chatbotkit.fetch_usage

List Bots

List ChatBotKit bots with optional pagination and metadata filtering.

chatbotkit.list_bots

Fetch Bot

Fetch a single ChatBotKit bot by ID.

chatbotkit.fetch_bot

Create Bot

Create a new ChatBotKit bot.

chatbotkit.create_bot

Update Bot

Update an existing ChatBotKit bot.

chatbotkit.update_bot

List Conversations

List ChatBotKit conversations with optional pagination and metadata filtering.

chatbotkit.list_conversations

Fetch Conversation

Fetch a single ChatBotKit conversation by ID.

chatbotkit.fetch_conversation

Create Conversation

Create a new ChatBotKit conversation with either a bot reference or inline bot configuration.

chatbotkit.create_conversation

List Conversation Messages

List messages inside a ChatBotKit conversation.

chatbotkit.list_conversation_messages

Create Conversation Message

Append a message to an existing ChatBotKit conversation.

chatbotkit.create_conversation_message

Complete Conversation

Send a message to a ChatBotKit conversation and receive the next assistant reply.

chatbotkit.complete_conversation

List Datasets

List ChatBotKit datasets with optional pagination and metadata filtering.

chatbotkit.list_datasets

Fetch Dataset

Fetch a single ChatBotKit dataset by ID.

chatbotkit.fetch_dataset

Create Dataset

Create a new ChatBotKit dataset for knowledge retrieval.

chatbotkit.create_dataset

Update Dataset

Update an existing ChatBotKit dataset.

chatbotkit.update_dataset

List Dataset Records

List records inside a ChatBotKit dataset.

chatbotkit.list_dataset_records

Create Dataset Record

Create a new record inside a ChatBotKit dataset.

chatbotkit.create_dataset_record

Search Dataset

Run semantic search against a ChatBotKit dataset.

chatbotkit.search_dataset

List Files

List ChatBotKit files with optional pagination and metadata filtering.

chatbotkit.list_files

Fetch File

Fetch a single ChatBotKit file by ID.

chatbotkit.fetch_file

Create File

Create a new ChatBotKit file resource.

chatbotkit.create_file

Upload File

Upload content to an existing ChatBotKit file using the official JSON upload modes.

chatbotkit.upload_file

Download File

Fetch the download URL for an existing ChatBotKit file.

chatbotkit.download_file

Sync File

Trigger synchronization for an existing ChatBotKit file.

chatbotkit.sync_file

List Dataset Files

List files attached to a ChatBotKit dataset.

chatbotkit.list_dataset_files

Attach Dataset File

Attach an existing ChatBotKit file to a dataset.

chatbotkit.attach_dataset_file

Detach Dataset File

Detach a ChatBotKit file from a dataset.

chatbotkit.detach_dataset_file

Frequently Asked Questions

Does a search cover every record?

Semantic search returns matches for the query. List dataset records when you need to inspect the stored record inventory.

How do I request an assistant reply?

Use the conversation ID with the completion operation and supply the message text when needed. Appending a message alone does not request completion.

Can I connect a stored file to a dataset?

Yes. File attachment uses the dataset ID, file ID, and attachment type. File synchronization is a separate operation.