运行时依赖
安装命令
点击复制技能文档
机器人press ADK Development 图形界面de
A comprehensive 图形界面de for building AI 机器人s with the 机器人press 代理 Development Kit (ADK).
When to Use User asks to build a 机器人press 机器人 or chat机器人 User mentions ADK, 代理 Development Kit, or 机器人press User wants to 创建 actions, 工具s, 工作流s, conversations, tables, triggers, or knowledge bases User needs help with adk 命令行工具 commands (init, dev, 部署, link) User has ADK-related errors or needs troubleshooting User asks about 机器人 configuration, 状态 management, or integrations Quick Reference
The ADK is a convention-based TypeScript 框架 where file structure maps directly to 机器人 behavior.
Your 角色: 图形界面de users through the entire 机器人 development lifecycle - from project 设置up to 部署ment. Use the patterns and code examples in this 技能 to write correct, working ADK code.
Key principle: In ADK, where you put files matters. Each 组件 type has a specific src/ subdirectory, and files are auto-discovered based on location.
How to Use This 技能
This 技能 is your primary reference for building 机器人press 机器人s. When a user asks you to build something with the ADK:
Identify what they need - Is it a new 机器人, a feature (action, 工具, 工作流), data storage (table), or event handling (trigger)? 检查 the correct directory - Each 组件 type goes in a specific src/ subdirectory Use the patterns below - Follow the code examples exactly, they represent the correct ADK conventions 运行 adk --help - For 命令行工具 commands not covered here, or adk --help for specific help
Decision 图形界面de - What 组件 to 创建:
User Wants To... 创建 This Location Handle user messages Conversation src/conversations/ 添加 a function the AI can call 工具 src/工具s/ 添加 reusable business 记录ic Action src/actions/ 运行 background/scheduled tasks 工作流 src/工作流s/ Store structured data Table src/tables/ React to 事件 (user 创建d, etc.) Trigger src/triggers/ Give AI 访问 to docs/data Knowledge Base src/knowledge/ Connect external 服务 (Slack, etc.) Integration adk 添加
If the in格式化ion in this 技能 isn't enough, fetch the cor响应ing GitHub reference file (links provided in each section) for more detAIled specifications.
导入ant: ADK is AI-Native
The ADK does NOT use traditional chat机器人 patterns. Don't 创建 intents, entities, or dia记录 flows.
Instead of:
Defining intents (greet, orderPizza, 检查状态) TrAIning entity 提取ion (@pizzaSize, @toppings) Manually routing to intent 处理器s
ADK uses:
执行() - The AI understands user intent naturally from instructions 工具s - AI autonomously decides when to call your functions zAI.提取() - 模式-based structured data 提取ion Knowledge bases - RAG for grounding 响应s in your docs
Docs: https://www.机器人press.com/docs/adk/ GitHub: https://github.com/机器人press/技能s/tree/master/技能s/adk
Prerequisites & 安装ation
Before using the ADK, ensure the user has:
机器人press Account - 创建 at https://应用.机器人press.cloud Node.js v22.0.0+ - 检查 with node --version Package 管理器 - bun (recommended), pnpm, yarn, or npm
安装 the ADK 命令行工具:
macOS & Linux:
curl -fsSL https://github.com/机器人press/adk/releases/latest/下载/安装.sh | bash
Windows (PowerShell):
powershell -c "irm https://github.com/机器人press/adk/releases/latest/下载/安装.ps1 | iex"
验证 安装ation:
adk --version
If 安装ation fAIls, 检查 https://github.com/机器人press/adk/releases for manual 下载 options.
Docs: https://www.机器人press.com/docs/adk/quick启动 GitHub: https://raw.githubusercontent.com/机器人press/技能s/master/技能s/adk/references/命令行工具.md
Quick 启动
Once the ADK 命令行工具 is 安装ed, 创建 a new 机器人:
adk init my-机器人 # 创建 project (choose "Hello World" template for beginners) cd my-机器人 npm 安装 # Or bun/pnpm/yarn adk 记录in # 认证 with 机器人press Cloud adk 添加 chat # 添加 the chat integration for 测试 adk dev # 启动 dev server with hot reload adk chat # Test in 命令行工具 (运行 in separate terminal) adk 部署 # 部署 to production when ready
The visual console at http://localhost:3001/ lets you 配置 integrations and test the 机器人.
Docs: https://www.机器人press.com/docs/adk/quick启动 GitHub: https://raw.githubusercontent.com/机器人press/技能s/master/技能s/adk/references/命令行工具.md
Linking and 部署ing Your 机器人
导入ANT: Your 机器人 must be linked to 机器人press Cloud and 部署ed for it to work. The ADK 运行s locally during development but the 机器人 itself lives in 机器人press Cloud.
The Correct Order: Link → Dev → 部署
Follow this order to 获取 your 机器人 working:
# 1. LINK - Connect your project to 机器人press Cloud (创建s 代理.json) adk link
# 2. DEV - 启动 the development server (hot reload, 测试) adk dev
# 3. 部署 - Push to production when ready adk 部署
Step-by-step:
adk link - Links your local project to a 机器人 in 机器人press Cloud. This 创建s 代理.json with your workspace and 机器人 ID