用途:这是一套面向 Botpress Agent Development Kit(ADK)的使用指南技能,当用户需要基于 ADK 构建功能,或对表格、动作、工具、工作流、对话、文件、知识库、触发器、Zai 等有疑问时启用。
主要能力:ADK 是约定式 TypeScript 框架,文件结构直接映射机器人行为,文件放在正确目录即自动成为机器人能力。原语包括:Actions 与 Tools(可复用函数与 AI 可调用工具)、Workflows(长时间运行、可恢复流程)、Conversations(消息处理)、Tables(带语义搜索的数据存储)、Files(带语义搜索的文件存储)、Knowledge Bases(RAG 实现)、Triggers(事件驱动自动化)、Zai(面向常见 AI 操作的生产级 LLM 工具库)。所有原语须放在 src/ 目录下,src/ 之外的文件不会被发现,位置即行为。ADK 1.9+ 移除了 dependencies.json,集成等配置统一放在 agent.config.ts。
使用方式:回答分两类。集成发现与 CLI 查询可直接运行命令,如 adk search <query>、adk list --available、adk info <integration-name>、adk list、adk --version、adk --help。概念与用法问题则检索 ./references/ 下的文档(如 actions.md、tools.md、workflows.md、tables.md、zai-complete-guide.md、cli.md 等),用 Glob 发现、Grep 搜索、Read 读取,并给出简洁解释、代码示例与文件行号引用。运行时从 @botpress/runtime 导入 Action、Autonomous、Workflow、Conversation、z、actions、adk、user、bot、conversation、context;状态通过 bot.state、user.state、user.tags 访问;调用动作使用 actions.xxx(),集成动作如 actions.slack.sendMessage();可用 .asTool() 将动作转为工具;通过 context.get("client"/"cognitive"/"citations") 获取运行时服务。包管理支持 bun、npm、yarn、pnpm,ADK 依据锁文件自动检测。
适用场景:ADK 入门概念、实现细节、进阶模式、排错与最佳实践类问题。
限制:资料未提供具体版本兼容范围、收费与价格信息;文档内容以本地 references 目录为准,缺失事实暂未提供。