backboard

---

name: backboard

description: Integrate Backboard.io for assistants, threads, memories, and document RAG via a local backend on http://localhost:5100.

---

Tools

This skill connects to a local Flask backend that wraps the Backboard SDK. The backend must be running on `http://localhost:5100`.

backboard_create_assistant

Create a new Backboard assistant with a name and system prompt.

**Parameters:**

**Example:**

{
  "name": "Support Bot",
  "system_prompt": "You are a helpful customer support assistant."
}

backboard_list_assistants

List all available Backboard assistants.

**Parameters:** None

backboard_get_assistant

Get details of a specific assistant.

**Parameters:**

backboard_delete_assistant

Delete an assistant.

**Parameters:**

backboard_create_thread

Create a new conversation thread for an assistant.

**Parameters:**

backboard_list_threads

List all conversation threads, optionally filtered by assistant.

**Parameters:**

backboard_get_thread

Get a thread with its message history.

**Parameters:**

backboard_send_message

Send a message to a thread and get a response.

**Parameters:**

backboard_add_memory

Store a memory for an assistant that persists across conversations.

**Parameters:**

**Example:**

{
  "assistant_id": "asst_123",
  "content": "User prefers Python programming and dark mode interfaces",
  "metadata": {"category": "preferences"}
}

backboard_list_memories

List all memories for an assistant.

**Parameters:**

backboard_get_memory

Get a specific memory.

**Parameters:**

backboard_update_memory

Update an existing memory.

**Parameters:**

backboard_delete_memory

Delete a memory.

**Parameters:**

backboard_memory_stats

Get memory statistics for an assistant.

**Parameters:**

backboard_upload_document

Upload a document to an assistant or thread for RAG (Retrieval-Augmented Generation).

**Parameters:**

**Supported file types:** PDF, DOCX, XLSX, PPTX, TXT, CSV, MD, PY, JS, HTML, CSS, XML, JSON

backboard_list_documents

List documents for an assistant or thread.

**Parameters:**

backboard_document_status

Check the processing status of an uploaded document.

**Parameters:**

backboard_delete_document

Delete a document.

**Parameters:**

Instructions

When the user asks about:

Memory Operations

Document Operations

Assistant Management

Conversation Threading

General Guidelines

1. Always confirm successful operations with the user

2. When creating assistants, suggest meaningful names and system prompts

3. For document uploads, verify the file type is supported before attempting

4. When using memory, explain what information is being stored

5. Thread IDs and assistant IDs should be stored/tracked for the user's context

Examples

Example 1: Store a User Preference

Example 2: Create an Assistant

Example 3: Upload and Query a Document

Example 4: Start a Threaded Conversation

Backend Setup

The skill requires a running backend server. To start:

1. Set the `BACKBOARD_API_KEY` environment variable

2. Navigate to the backend directory

3. Run `./start.sh`

The backend will be available at `http://localhost:5100`.

API Endpoints Reference

| Endpoint | Method | Description |

|----------|--------|-------------|

| `/health` | GET | Health check |

| `/assistants` | GET, POST | List/create assistants |

| `/assistants/{id}` | GET, PATCH, DELETE | Get/update/delete assistant |

| `/assistants/{id}/threads` | GET, POST | List/create threads for assistant |

| `/assistants/{id}/memory` | GET, POST | List/add memories |

| `/assistants/{id}/memory/{mid}` | GET, PATCH, DELETE | Get/update/delete memory |

| `/assistants/{id}/memory/stats` | GET | Memory statistics |

| `/assistants/{id}/documents` | GET, POST | List/upload documents |

| `/threads` | GET | List all threads |

| `/threads/{id}` | GET, DELETE | Get/delete thread |

| `/threads/{id}/messages` | POST | Send message |

| `/threads/{id}/documents` | GET, POST | List/upload thread documents |

| `/documents/{id}/status` | GET | Document processing status |

| `/documents/{id}` | DELETE | Delete document |