v7.3.0

AI integration

The AI feature and all its related components are marked as experimental and are subject to change.

The TaskBoard ships with an AI feature that lets users interact with tasks using natural language through a chat panel. Users can move tasks between columns and swimlanes, filter and sort columns, add or remove tasks, highlight cards, and more — all using conversational commands.

The TaskBoard AI feature builds on top of the Scheduler AI feature. Please read both of these guides first:

All configurations described in those guides apply to the TaskBoard as well.

Minimum configuration

import { TaskBoard, OpenAIPlugin } from '@bryntum/taskboard';

const taskBoard = new TaskBoard({
    features : {
        ai : {
            promptUrl  : '/api/ai/prompt',
            apiPlugin  : OpenAIPlugin,
            model      : 'gpt-4-1',
            chatButton : true
        }
    }
});

Key concepts

The TaskBoard organizes tasks into columns and optionally swimlanes:

  • Columns represent stages or statuses (e.g., "todo", "doing", "done"). Each column maps to a value of the configured columnField (typically status).
  • Swimlanes represent categories or priorities (e.g., "critical", "normal", "low"). Each swimlane maps to a value of the configured swimlaneField.

Moving a task to a different column means changing its column field value. Moving a task to a different swimlane means changing its swimlane field value. The AI understands this mapping automatically.

Additional tools

In addition to the Grid tools and most Scheduler tools, the TaskBoard adds board-specific tools:

Tool Description
moveTasks Moves tasks to a different column and/or swimlane
selectTasks Selects tasks on the board
highlightTasks / unhighlightAll Highlights tasks on the board, dimming non-highlighted cards
filterColumn / unfilterColumn Filters/unfilters tasks within a single column
sortColumn Sorts tasks within a single column
collapseColumn / expandColumn Collapses or expands a column

The base tools (changeTheme, askUser, createPlan, completePlanSteps, undo, endVoiceConversation) are also available. See the Grid AI guide for details on planning and base tools.

Tool names are dynamic and change based on your model class names. For example, if your TaskModel is named Issue, the tools become getIssues, updateIssues, etc.

API docs

Demo

Contents