Spaces

ChatBotKit Spaces are collaborative file stores designed to help humans and AI agents work together on shared projects and goals. Files in a Space are not tied to one device or session - they are available to authorized users and agents across workflows. This makes Spaces a practical primitive for organizing information and enabling seamless collaboration between humans and AI.

What Are Spaces?

A Space is a shared file store that both humans and AI agents can read from and write to. When you create a Space, you establish a collaborative environment where:

• Humans can upload, organize, and manage files from the dashboard
• AI agents can read existing files, create new files, and modify content during conversations
• Contacts can be associated with a Space to scope access to a specific person

Spaces provide a natural way to structure project files, store reference materials, and create a shared context that both people and AI can work within.

Accessing Spaces

You can manage your Spaces directly from the Spaces section of the ChatBotKit dashboard at chatbotkit.com/spaces. From there you can create Spaces, upload files, and connect them to contacts.

Spaces can also be integrated with Portals - when configuring a Portal's Chat app, you can enable specific Spaces as knowledge sources so portal users can draw on the files stored there during conversations.

Use Cases

Project Workspaces

Create a Space for each project where team members and AI agents can collaborate on documents, share resources, and maintain project files in an organized structure.

AI-Assisted Content Creation

Use a Space as a collaborative writing environment where AI agents can help draft, edit, and organize content based on reference materials and guidelines stored in the Space.

Customer Collaboration

Set up a dedicated Space for a customer or client, associate it with a Contact, and let AI agents process their uploaded files for automated analysis or support.

Knowledge Organization

Build Spaces that serve as knowledge repositories where AI agents can access reference materials to answer questions or generate insights based on the stored content.

Data Processing Pipelines

Use Spaces as staging areas where AI agents can process uploaded files, transform data, and write output files for further use or distribution.

Configuring a Space

Each Space has a few configuration options available from its settings page in the dashboard:

• Name and Description: A recognizable label and summary for the Space.
• Contact: Optionally associate the Space with a specific Contact to link it to a person's record.
• Alias: An optional short identifier (lowercase letters, numbers, hyphens, and underscores) that lets you reference the Space via @alias in instructions and backstories.
• Meta: Custom key-value metadata you can attach to the Space for your own organizational purposes.

Getting Started

1. Go to the Spaces section in the ChatBotKit dashboard and click Create Space.
2. Give the Space a descriptive name.
3. Optionally set an alias and associate a Contact.
4. Upload files using the Files section on the Space's detail page.
5. Reference the Space in your agent instructions or enable it as a knowledge source in a Portal's Chat configuration.

Summary

ChatBotKit Spaces provide a straightforward building block for human-AI collaboration. By creating shared file stores where both people and AI agents can work with files, Spaces make it easy to maintain context across sessions and workflows. Whether you are managing projects, organizing knowledge, or building AI-powered pipelines, Spaces offer a simple way to share information between humans and agents.