Spaces
ChatBotKit Spaces are collaborative environments designed to help humans and AI agents work together on shared projects and goals. Think of a Space as a project workspace where files can be stored, organized, accessed, and modified by both people and AI agents. This makes Spaces a powerful primitive for organizing information and enabling seamless collaboration between humans and AI.
What Are Spaces?
A Space is essentially a shared file storage area that can be used by both humans and AI agents. When you create a Space, you're establishing a collaborative environment where:
- Humans can upload, organize, and manage files
- AI agents can read existing files, create new files, and modify content
- Teams can share access and work together on common objectives
Spaces provide a natural way to structure projects, organize information, and create a shared context that both humans and AI can understand and work within.
Accessing Spaces
Spaces can be accessed in multiple ways to suit different workflows:
- API Access: Integrate Spaces into your applications and AI agent workflows using the ChatBotKit API
- Portals App: Access and manage your Spaces through a dedicated app available in ChatBotKit Portals, providing a user-friendly interface for file management and collaboration
The Portals app provides a visual interface for working with Spaces, making it easy to browse files, upload content, and manage your collaborative workspaces without needing to write code.
Use Cases
Project Workspaces
Create a Space for each project where team members (human and AI) can collaborate on documents, share resources, and maintain project files in an organized structure.
AI-Assisted Content Creation
Use Spaces 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 dedicated Spaces for customers or clients, allowing them to share files with your AI agents for automated processing, analysis, or support.
Knowledge Organization
Build Spaces that serve as knowledge repositories where AI agents can access information to answer questions, generate insights, or create new content based on the stored materials.
Data Processing Pipelines
Use Spaces as staging areas where AI agents can process uploaded files, transform data, and create output files for further use or distribution.
Working with Spaces
Spaces are accessible through the ChatBotKit API, enabling programmatic access for both traditional applications and AI agent workflows. The API supports all standard file operations, making it easy to integrate Spaces into your existing workflows.
When working with Spaces programmatically:
- Files are organized in hierarchical folder structures
- Paths use URL-safe encoding for compatibility
- Operations support both direct file access and presigned URLs
- Spaces can be filtered and organized using metadata
For detailed API documentation and integration examples, refer to the ChatBotKit API reference.
Getting Started
To start using Spaces:
- Create a new Space with a descriptive name
- Optionally associate it with a Contact for access management
- Begin adding files through the interface or API
- Configure your AI agents to access the Space for collaboration
- Share the Space with team members as needed
Summary
ChatBotKit Spaces provide a fundamental building block for human-AI collaboration. By creating shared environments where both people and AI agents can work with files, Spaces enable new forms of productivity and teamwork. Whether you're managing projects, organizing knowledge, or building AI-powered workflows, Spaces offer a simple yet powerful way to structure information and facilitate collaboration toward common goals.