adk

SKILL.md

Botpress ADK Guidelines

Use this skill when you've got questions about the Botpress Agent Development Kit (ADK) - like when you're building a feature that involves tables, actions, tools, workflows, conversations, files, knowledge bases, triggers, assets, evals, or Zai.

What is the ADK?

The Botpress ADK is a convention-based TypeScript framework where file structure maps directly to bot behavior. Place files in the correct directories, and they automatically become available as bot capabilities.

The ADK provides primitives for:

Actions & Tools (reusable functions and AI-callable tools)

Workflows (long-running, resumable processes)

Conversations (message handling)

Tables (data storage with semantic search)

Files (file storage with semantic search)

Knowledge Bases (RAG implementation)

Triggers (event-driven automation)

Assets (static files with permanent URLs)

Zai (production-ready LLM utility library for common AI operations)