2281 lines
100 KiB
Python
2281 lines
100 KiB
Python
"""Seed builtin tools into the database on startup."""
|
||
|
||
from loguru import logger
|
||
from sqlalchemy import select
|
||
from app.database import async_session
|
||
from app.models.tool import Tool
|
||
|
||
# Builtin tool definitions — these map to the hardcoded AGENT_TOOLS
|
||
BUILTIN_TOOLS = [
|
||
{
|
||
"name": "list_files",
|
||
"display_name": "List Files",
|
||
"description": "List files and folders in a directory within the workspace. Can also list enterprise_info/ for shared company information.",
|
||
"category": "file",
|
||
"icon": "📁",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"path": {"type": "string", "description": "Directory path to list, defaults to root (empty string)"}
|
||
},
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "read_file",
|
||
"display_name": "Read File",
|
||
"description": "Read file contents from the workspace. Can read tasks.json, soul.md, memory/memory.md, skills/, and enterprise_info/. Use offset and limit for reading large files in chunks.",
|
||
"category": "file",
|
||
"icon": "📄",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"path": {"type": "string", "description": "File path, e.g.: tasks.json, soul.md, memory/memory.md"},
|
||
"offset": {"type": "integer", "description": "Starting line number (0-indexed, default 0). Use with limit for pagination."},
|
||
"limit": {"type": "integer", "description": "Maximum number of lines to read (default 2000). Use with offset for pagination."},
|
||
},
|
||
"required": ["path"],
|
||
},
|
||
"config": {"max_file_size_kb": 500},
|
||
"config_schema": {
|
||
"fields": [
|
||
{"key": "max_file_size_kb", "label": "Max file size (KB)", "type": "number", "default": 500},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "write_file",
|
||
"display_name": "Write File",
|
||
"description": "Write or update a file in the workspace. Can update memory/memory.md, create documents in workspace/, create skills in skills/.",
|
||
"category": "file",
|
||
"icon": "✏️",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"path": {"type": "string", "description": "File path, e.g.: memory/memory.md, workspace/report.md"},
|
||
"content": {"type": "string", "description": "File content to write"},
|
||
},
|
||
"required": ["path", "content"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "delete_file",
|
||
"display_name": "Delete File",
|
||
"description": "Delete a file from the workspace. Cannot delete soul.md or tasks.json.",
|
||
"category": "file",
|
||
"icon": "🗑️",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"path": {"type": "string", "description": "File path to delete"}
|
||
},
|
||
"required": ["path"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
# --- Enhanced file management tools ---
|
||
{
|
||
"name": "edit_file",
|
||
"display_name": "Edit File",
|
||
"description": "Surgically replace a specific string inside an existing file without rewriting the whole content. Prefer this over write_file when you only need to change one or more sections.",
|
||
"category": "file",
|
||
"icon": "✂️",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"path": {"type": "string", "description": "File path to edit, e.g.: memory/memory.md, skills/my-skill/SKILL.md"},
|
||
"old_string": {"type": "string", "description": "Exact text to find and replace. Must match exactly including whitespace and newlines."},
|
||
"new_string": {"type": "string", "description": "Replacement text"},
|
||
"replace_all": {"type": "boolean", "description": "Replace all occurrences if true (default: false)"},
|
||
},
|
||
"required": ["path", "old_string", "new_string"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "search_files",
|
||
"display_name": "Search Files",
|
||
"description": "Search for content patterns across files using regex. Returns matching lines with file paths and line numbers. Results capped at 50 per query.",
|
||
"category": "file",
|
||
"icon": "🔍",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"pattern": {"type": "string", "description": "Regex pattern to search for, e.g.: 'API_KEY', 'def\\\\s+\\\\w+'"},
|
||
"path": {"type": "string", "description": "Directory to search in (default: root)"},
|
||
"file_pattern": {"type": "string", "description": "File pattern to match (default: all files). e.g.: '*.md', '*.py'"},
|
||
"ignore_case": {"type": "boolean", "description": "Case-insensitive search (default: false)"},
|
||
},
|
||
"required": ["pattern"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "find_files",
|
||
"display_name": "Find Files",
|
||
"description": "Find files matching glob patterns. Returns file paths with sizes and modification info. Results capped at 100 per query.",
|
||
"category": "file",
|
||
"icon": "📁",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"pattern": {"type": "string", "description": "Glob pattern to match files, e.g.: '**/*.md', 'skills/*.md'"},
|
||
"path": {"type": "string", "description": "Base directory for search (default: root)"},
|
||
},
|
||
"required": ["pattern"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "read_document",
|
||
"display_name": "Read Document",
|
||
"description": "Read office document contents (PDF, Word, Excel, PPT) and extract text.",
|
||
"category": "file",
|
||
"icon": "📑",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"path": {"type": "string", "description": "Document file path, e.g.: workspace/report.pdf"}
|
||
},
|
||
"required": ["path"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
# --- Aware trigger management tools ---
|
||
{
|
||
"name": "set_trigger",
|
||
"display_name": "Set Trigger",
|
||
"description": "Set a new trigger to wake yourself up at a specific time or condition. Trigger types: 'cron' (recurring schedule), 'once' (fire once at a time), 'interval' (every N minutes), 'poll' (HTTP monitoring), 'on_message' (when another agent or human user replies).",
|
||
"category": "aware",
|
||
"icon": "⚡",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"name": {"type": "string", "description": "Unique name for this trigger"},
|
||
"type": {"type": "string", "enum": ["cron", "once", "interval", "poll", "on_message"], "description": "Trigger type"},
|
||
"config": {"type": "object", "description": "Type-specific config. cron: {\"expr\": \"0 9 * * *\"}. once: {\"at\": \"2026-03-10T09:00:00+08:00\"}. interval: {\"minutes\": 30}. poll: {\"url\": \"...\", \"json_path\": \"$.status\"}. on_message: {\"from_agent_name\": \"Morty\"} or {\"from_user_name\": \"张三\"}"},
|
||
"reason": {"type": "string", "description": "What to do when this trigger fires"},
|
||
"focus_ref": {"type": "string", "description": "Optional: which focus item this relates to"},
|
||
},
|
||
"required": ["name", "type", "config", "reason"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "update_trigger",
|
||
"display_name": "Update Trigger",
|
||
"description": "Update an existing trigger's configuration or reason.",
|
||
"category": "aware",
|
||
"icon": "🔄",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"name": {"type": "string", "description": "Name of the trigger to update"},
|
||
"config": {"type": "object", "description": "New config (replaces existing)"},
|
||
"reason": {"type": "string", "description": "New reason text"},
|
||
},
|
||
"required": ["name"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "cancel_trigger",
|
||
"display_name": "Cancel Trigger",
|
||
"description": "Cancel (disable) a trigger by name. Use when a task is completed.",
|
||
"category": "aware",
|
||
"icon": "⏹️",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"name": {"type": "string", "description": "Name of the trigger to cancel"},
|
||
},
|
||
"required": ["name"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "list_triggers",
|
||
"display_name": "List Triggers",
|
||
"description": "List all your active triggers with name, type, config, reason, fire count, and status.",
|
||
"category": "aware",
|
||
"icon": "📋",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {},
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "send_channel_file",
|
||
"display_name": "Send File",
|
||
"description": "Send a file to a specific person or back to the current conversation. If member_name is provided, the system resolves the recipient across all connected channels (Feishu, Slack, etc.) and delivers the file via the appropriate channel.",
|
||
"category": "communication",
|
||
"icon": "📎",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"file_path": {"type": "string", "description": "Workspace-relative path to the file"},
|
||
"member_name": {"type": "string", "description": "Name of the person to send the file to. The system looks up this person across all configured channels and delivers via the appropriate one."},
|
||
"message": {"type": "string", "description": "Optional message to accompany the file"},
|
||
},
|
||
"required": ["file_path"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
# NOTE: send_feishu_message is defined in the 'feishu' category section below.
|
||
# It was previously duplicated here under 'communication', which could cause
|
||
# 'Tool names must be unique' errors when the DB lacked a UNIQUE constraint.
|
||
{
|
||
"name": "send_web_message",
|
||
"display_name": "Web Message",
|
||
"description": "Send a proactive message to a user on the Clawith web platform. The message appears in their chat history and is pushed in real-time if they are online.",
|
||
"category": "communication",
|
||
"icon": "🌐",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"username": {"type": "string", "description": "Recipient username or display name"},
|
||
"message": {"type": "string", "description": "Message content"},
|
||
},
|
||
"required": ["username", "message"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "send_message_to_agent",
|
||
"display_name": "Agent Message",
|
||
"description": "Send a message to a digital employee colleague. Decision guide: target needs to DO WORK and return results? → task_delegate. Just FYI? → notify. Quick factual question? → consult. When unsure, prefer task_delegate.",
|
||
"category": "communication",
|
||
"icon": "🤖",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"agent_name": {"type": "string", "description": "Target agent name"},
|
||
"message": {"type": "string", "description": "Message content"},
|
||
"msg_type": {"type": "string", "enum": ["notify", "consult", "task_delegate"], "description": "(1) Target needs to DO WORK and return results? → task_delegate. (2) Just FYI? → notify. (3) Quick factual question? → consult. When unsure, prefer task_delegate."},
|
||
},
|
||
"required": ["agent_name", "message", "msg_type"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "send_file_to_agent",
|
||
"display_name": "Agent File Transfer",
|
||
"description": "Send a workspace file to another digital employee. The file is copied to the target agent's workspace/inbox/files/ and an inbox note is created.",
|
||
"category": "communication",
|
||
"icon": "📤",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"agent_name": {"type": "string", "description": "Target agent name"},
|
||
"file_path": {"type": "string", "description": "Workspace-relative source file path"},
|
||
"message": {"type": "string", "description": "Optional delivery note"},
|
||
},
|
||
"required": ["agent_name", "file_path"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "web_search",
|
||
"display_name": "Web Search",
|
||
"description": "[Deprecated] Unified search tool with engine selector. Use the dedicated tools (DuckDuckGo Search, Tavily Search, Google Search, Bing Search, Exa Search) instead for better control per engine.",
|
||
"category": "search",
|
||
"icon": "🔍",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"query": {"type": "string", "description": "Search keywords"},
|
||
"max_results": {"type": "integer", "description": "Number of results to return"},
|
||
},
|
||
"required": ["query"],
|
||
},
|
||
"config": {
|
||
"search_engine": "duckduckgo",
|
||
"max_results": 5,
|
||
"language": "en",
|
||
"api_key": "",
|
||
},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "search_engine",
|
||
"label": "Search Engine",
|
||
"type": "select",
|
||
"options": [
|
||
{"value": "duckduckgo", "label": "DuckDuckGo (free, no API key)"},
|
||
{"value": "tavily", "label": "Tavily (AI search, needs API key)"},
|
||
{"value": "google", "label": "Google Custom Search (needs API key)"},
|
||
{"value": "bing", "label": "Bing Search API (needs API key)"},
|
||
{"value": "exa", "label": "Exa (AI-powered search, needs API key)"},
|
||
],
|
||
"default": "duckduckgo",
|
||
},
|
||
{
|
||
"key": "api_key",
|
||
"label": "API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "Required for engines that need an API key",
|
||
"depends_on": {"search_engine": ["tavily", "google", "bing", "exa"]},
|
||
},
|
||
{
|
||
"key": "max_results",
|
||
"label": "Default results count",
|
||
"type": "number",
|
||
"default": 5,
|
||
"min": 1,
|
||
"max": 20,
|
||
},
|
||
{
|
||
"key": "language",
|
||
"label": "Search language",
|
||
"type": "select",
|
||
"options": [
|
||
{"value": "en", "label": "English"},
|
||
{"value": "zh-CN", "label": "中文"},
|
||
{"value": "ja", "label": "日本語"},
|
||
],
|
||
"default": "en",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "jina_search",
|
||
"display_name": "Jina Search",
|
||
"description": "Search the internet using Jina AI (s.jina.ai). Returns high-quality results with full content. Requires Jina AI API key for higher rate limits.",
|
||
"category": "search",
|
||
"icon": "🔮",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"query": {"type": "string", "description": "Search keywords"},
|
||
"max_results": {"type": "integer", "description": "Number of results (default 5, max 10)"},
|
||
},
|
||
"required": ["query"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "api_key",
|
||
"label": "Jina AI API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "jina_xxxxxxxxxxxxxxxx (get one at jina.ai)",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "jina_read",
|
||
"display_name": "Jina Read",
|
||
"description": "Read and extract full content from a URL using Jina AI Reader (r.jina.ai). Returns clean markdown. Requires Jina AI API key for higher rate limits.",
|
||
"category": "search",
|
||
"icon": "📖",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"url": {"type": "string", "description": "Full URL to read"},
|
||
"max_chars": {"type": "integer", "description": "Max characters to return (default 8000)"},
|
||
},
|
||
"required": ["url"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "api_key",
|
||
"label": "Jina AI API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "jina_xxxxxxxxxxxxxxxx (get one at jina.ai)",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "exa_search",
|
||
"display_name": "Exa Search",
|
||
"description": "AI-powered web search using Exa (exa.ai). Supports semantic search, category filtering, domain filtering, and multiple content modes (text, highlights, summary). Requires an Exa API key.",
|
||
"category": "search",
|
||
"icon": "🔎",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"query": {"type": "string", "description": "Search query"},
|
||
"max_results": {"type": "integer", "description": "Number of results (default 5, max 10)"},
|
||
"search_type": {
|
||
"type": "string",
|
||
"description": "Search type: auto (default), neural, or fast",
|
||
"enum": ["auto", "neural", "fast"],
|
||
},
|
||
"category": {
|
||
"type": "string",
|
||
"description": "Filter by category: company, research paper, news, personal site, financial report, or people",
|
||
},
|
||
"include_domains": {
|
||
"type": "string",
|
||
"description": "Comma-separated domains to restrict results to (e.g. 'arxiv.org, github.com')",
|
||
},
|
||
"exclude_domains": {
|
||
"type": "string",
|
||
"description": "Comma-separated domains to exclude from results",
|
||
},
|
||
"content_mode": {
|
||
"type": "string",
|
||
"description": "Content retrieval mode: text (default), highlights, or summary",
|
||
"enum": ["text", "highlights", "summary"],
|
||
},
|
||
},
|
||
"required": ["query"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "api_key",
|
||
"label": "Exa API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "Get your API key at exa.ai",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
# ── Standalone search engines (each engine as its own tool) ──────────────
|
||
# These complement web_search (which remains for backward compatibility).
|
||
# Each tool wraps a single engine so agents can pick the right one for the
|
||
# task without going through the unified engine-selector flow.
|
||
{
|
||
"name": "duckduckgo_search",
|
||
"display_name": "DuckDuckGo Search",
|
||
"description": "Search the internet using DuckDuckGo. Free, no API key required. Returns titles, URLs, and snippets.",
|
||
"category": "search",
|
||
"icon": "🦆",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"query": {"type": "string", "description": "Search keywords"},
|
||
"max_results": {"type": "integer", "description": "Number of results to return (default 5, max 10)"},
|
||
},
|
||
"required": ["query"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {"fields": []},
|
||
},
|
||
{
|
||
"name": "tavily_search",
|
||
"display_name": "Tavily Search",
|
||
"description": "AI-optimized web search using Tavily. Returns high-quality results with summaries. Requires a Tavily API key.",
|
||
"category": "search",
|
||
"icon": "🔍",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"query": {"type": "string", "description": "Search keywords"},
|
||
"max_results": {"type": "integer", "description": "Number of results to return (default 5, max 10)"},
|
||
},
|
||
"required": ["query"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "api_key",
|
||
"label": "Tavily API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "tvly-xxxxxxxxxxxxxxxx (get one at tavily.com)",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "google_search",
|
||
"display_name": "Google Search",
|
||
"description": "Search using Google Custom Search JSON API. Returns titles, URLs, and snippets. Requires a Google API key and Custom Search Engine ID (format: API_KEY:CX_ID).",
|
||
"category": "search",
|
||
"icon": "🔍",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"query": {"type": "string", "description": "Search keywords"},
|
||
"max_results": {"type": "integer", "description": "Number of results to return (default 5, max 10)"},
|
||
"language": {"type": "string", "description": "Search language code (e.g. 'en', 'zh')"},
|
||
},
|
||
"required": ["query"],
|
||
},
|
||
"config": {"language": "en"},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "api_key",
|
||
"label": "API Key & Search Engine ID",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "API_KEY:SEARCH_ENGINE_ID (get at console.cloud.google.com)",
|
||
},
|
||
{
|
||
"key": "language",
|
||
"label": "Search language",
|
||
"type": "select",
|
||
"options": [
|
||
{"value": "en", "label": "English"},
|
||
{"value": "zh-CN", "label": "Chinese"},
|
||
{"value": "ja", "label": "Japanese"},
|
||
],
|
||
"default": "en",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "bing_search",
|
||
"display_name": "Bing Search",
|
||
"description": "Search using Bing Web Search API. Returns titles, URLs, and snippets. Requires a Bing Search API key from Microsoft Azure.",
|
||
"category": "search",
|
||
"icon": "🔍",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"query": {"type": "string", "description": "Search keywords"},
|
||
"max_results": {"type": "integer", "description": "Number of results to return (default 5, max 10)"},
|
||
"language": {"type": "string", "description": "Market language code (e.g. 'en-US', 'zh-CN')"},
|
||
},
|
||
"required": ["query"],
|
||
},
|
||
"config": {"language": "en-US"},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "api_key",
|
||
"label": "Bing Search API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "Get from Azure Cognitive Services (Bing Search v7)",
|
||
},
|
||
{
|
||
"key": "language",
|
||
"label": "Market language",
|
||
"type": "select",
|
||
"options": [
|
||
{"value": "en-US", "label": "English (US)"},
|
||
{"value": "zh-CN", "label": "Chinese (Simplified)"},
|
||
{"value": "ja-JP", "label": "Japanese"},
|
||
],
|
||
"default": "en-US",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "plaza_get_new_posts",
|
||
"display_name": "Plaza: Browse",
|
||
"description": "Get recent posts from the Agent Plaza (shared social feed). Returns posts and comments since a given timestamp.",
|
||
"category": "social",
|
||
"icon": "🏛️",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"limit": {"type": "integer", "description": "Max number of posts to return (default 10)", "default": 10},
|
||
},
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "plaza_create_post",
|
||
"display_name": "Plaza: Post",
|
||
"description": "Publish a new post to the Agent Plaza. Share work insights, tips, or interesting discoveries. Do NOT share private information.",
|
||
"category": "social",
|
||
"icon": "📝",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"content": {"type": "string", "description": "Post content (max 500 chars). Must be public-safe."},
|
||
},
|
||
"required": ["content"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "plaza_add_comment",
|
||
"display_name": "Plaza: Comment",
|
||
"description": "Add a comment to an existing plaza post. Engage with colleagues' posts.",
|
||
"category": "social",
|
||
"icon": "💬",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"post_id": {"type": "string", "description": "The UUID of the post to comment on"},
|
||
"content": {"type": "string", "description": "Comment content (max 300 chars)"},
|
||
},
|
||
"required": ["post_id", "content"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "execute_code",
|
||
"display_name": "Code Executor",
|
||
"description": "Execute code (Python, Bash, Node.js) in a local sandboxed subprocess within the agent's workspace. Useful for data processing, calculations, file transformations, and automation.",
|
||
"category": "code",
|
||
"icon": "💻",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"language": {"type": "string", "enum": ["python", "bash", "node"], "description": "Programming language"},
|
||
"code": {"type": "string", "description": "Code to execute"},
|
||
"timeout": {"type": "integer", "description": "Max execution time in seconds (default 30, max 60)"},
|
||
},
|
||
"required": ["language", "code"],
|
||
},
|
||
"config": {
|
||
"sandbox_type": "subprocess",
|
||
"cpu_limit": "0.5",
|
||
"memory_limit": "256m",
|
||
"allow_network": True,
|
||
"default_timeout": 30,
|
||
"max_timeout": 60,
|
||
},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "cpu_limit",
|
||
"label": "CPU Limit",
|
||
"type": "text",
|
||
"default": "0.5",
|
||
"placeholder": "e.g., 0.5, 1.0, 2.0",
|
||
},
|
||
{
|
||
"key": "memory_limit",
|
||
"label": "Memory Limit",
|
||
"type": "text",
|
||
"default": "256m",
|
||
"placeholder": "e.g., 256m, 512m, 1g",
|
||
},
|
||
{
|
||
"key": "allow_network",
|
||
"label": "Allow Network Access",
|
||
"type": "checkbox",
|
||
"default": True,
|
||
"read_only_for_roles": ["agent_admin", "member"],
|
||
},
|
||
{
|
||
"key": "default_timeout",
|
||
"label": "Default Timeout (seconds)",
|
||
"type": "number",
|
||
"default": 30,
|
||
"min": 5,
|
||
"max": 300,
|
||
},
|
||
{
|
||
"key": "max_timeout",
|
||
"label": "Max Timeout (seconds)",
|
||
"type": "number",
|
||
"default": 60,
|
||
"min": 10,
|
||
"max": 300,
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "execute_code_e2b",
|
||
"display_name": "Code Executor (E2B Cloud)",
|
||
"description": "Execute code (Python, Bash, Node.js) in a secure E2B cloud sandbox. Provides full network access and an isolated environment without consuming local resources. Requires an E2B API key.",
|
||
"category": "code",
|
||
"icon": "☁️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"language": {"type": "string", "enum": ["python", "bash", "node"], "description": "Programming language"},
|
||
"code": {"type": "string", "description": "Code to execute"},
|
||
"timeout": {"type": "integer", "description": "Max execution time in seconds (default 30, max 60)"},
|
||
},
|
||
"required": ["language", "code"],
|
||
},
|
||
"config": {
|
||
"sandbox_type": "e2b",
|
||
"api_key": "",
|
||
"default_timeout": 30,
|
||
"max_timeout": 60,
|
||
},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "api_key",
|
||
"label": "E2B API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "Get your API key at https://e2b.dev",
|
||
"required": True,
|
||
},
|
||
{
|
||
"key": "default_timeout",
|
||
"label": "Default Timeout (seconds)",
|
||
"type": "number",
|
||
"default": 30,
|
||
"min": 5,
|
||
"max": 300,
|
||
},
|
||
{
|
||
"key": "max_timeout",
|
||
"label": "Max Timeout (seconds)",
|
||
"type": "number",
|
||
"default": 60,
|
||
"min": 10,
|
||
"max": 300,
|
||
},
|
||
]
|
||
},
|
||
},
|
||
|
||
{
|
||
"name": "upload_image",
|
||
"display_name": "Upload Image",
|
||
"description": "Upload images from the workspace or a URL to ImageKit CDN and get a public URL. Useful for sharing images externally or embedding them in reports.",
|
||
"category": "code",
|
||
"icon": "🖼️",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"file_path": {"type": "string", "description": "Workspace-relative path to image file"},
|
||
"url": {"type": "string", "description": "Public URL of image to upload"},
|
||
"file_name": {"type": "string", "description": "Custom filename (optional)"},
|
||
"folder": {"type": "string", "description": "CDN folder path (default /clawith)"},
|
||
},
|
||
},
|
||
"config": {"private_key": "", "url_endpoint": ""},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "private_key",
|
||
"label": "ImageKit Private Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "Your ImageKit private API key",
|
||
},
|
||
{
|
||
"key": "url_endpoint",
|
||
"label": "ImageKit URL Endpoint",
|
||
"type": "text",
|
||
"default": "",
|
||
"placeholder": "https://ik.imagekit.io/your_imagekit_id",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "generate_image_siliconflow",
|
||
"display_name": "Generate Image (SiliconFlow)",
|
||
"description": "Generate an image via SiliconFlow FLUX models. China-friendly and fast.",
|
||
"category": "media",
|
||
"icon": "🎨",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"prompt": {"type": "string", "description": "Detailed image description."},
|
||
"size": {"type": "string", "description": "Image size (e.g. 1024x1024, 1024x768). Default 1024x1024."},
|
||
"save_path": {"type": "string", "description": "Save path in workspace. Default: auto."},
|
||
},
|
||
"required": ["prompt"],
|
||
},
|
||
"config": {
|
||
"model": "black-forest-labs/FLUX.1-schnell",
|
||
"api_key": "",
|
||
"base_url": "",
|
||
},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "model",
|
||
"label": "Model",
|
||
"type": "text",
|
||
"default": "black-forest-labs/FLUX.1-schnell",
|
||
"placeholder": "e.g. black-forest-labs/FLUX.1-schnell",
|
||
},
|
||
{
|
||
"key": "api_key",
|
||
"label": "API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "SiliconFlow API Key",
|
||
},
|
||
{
|
||
"key": "base_url",
|
||
"label": "Base URL (optional)",
|
||
"type": "text",
|
||
"default": "",
|
||
"placeholder": "Default: https://api.siliconflow.cn/v1",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "generate_image_openai",
|
||
"display_name": "Generate Image (OpenAI)",
|
||
"description": "Generate an image via OpenAI DALL-E models.",
|
||
"category": "media",
|
||
"icon": "🎨",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"prompt": {"type": "string", "description": "Detailed image description."},
|
||
"size": {"type": "string", "description": "Image size (e.g. 1024x1024). Default 1024x1024."},
|
||
"save_path": {"type": "string", "description": "Save path in workspace. Default: auto."},
|
||
},
|
||
"required": ["prompt"],
|
||
},
|
||
"config": {
|
||
"model": "dall-e-3",
|
||
"api_key": "",
|
||
"base_url": "",
|
||
},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "model",
|
||
"label": "Model",
|
||
"type": "text",
|
||
"default": "dall-e-3",
|
||
"placeholder": "e.g. dall-e-3 or dall-e-2",
|
||
},
|
||
{
|
||
"key": "api_key",
|
||
"label": "API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "OpenAI API Key",
|
||
},
|
||
{
|
||
"key": "base_url",
|
||
"label": "Base URL (optional)",
|
||
"type": "text",
|
||
"default": "",
|
||
"placeholder": "Default: https://api.openai.com/v1",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "generate_image_google",
|
||
"display_name": "Generate Image (Google/Vertex)",
|
||
"description": "Generate an image via Google Gemini Image (Nano Banana) or Vertex AI.",
|
||
"category": "media",
|
||
"icon": "🎨",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"prompt": {"type": "string", "description": "Detailed image description."},
|
||
"size": {"type": "string", "description": "Image size (e.g. 1024x1024). Default 1024x1024."},
|
||
"save_path": {"type": "string", "description": "Save path in workspace. Default: auto."},
|
||
},
|
||
"required": ["prompt"],
|
||
},
|
||
"config": {
|
||
"model": "gemini-2.5-flash-image",
|
||
"api_key": "",
|
||
"base_url": "",
|
||
},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "model",
|
||
"label": "Model",
|
||
"type": "text",
|
||
"default": "gemini-2.5-flash-image",
|
||
"placeholder": "e.g. gemini-2.5-flash-image",
|
||
},
|
||
{
|
||
"key": "api_key",
|
||
"label": "API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "Google AI Studio or Vertex API Key",
|
||
},
|
||
{
|
||
"key": "base_url",
|
||
"label": "Base URL (optional)",
|
||
"type": "text",
|
||
"default": "",
|
||
"placeholder": "Can be Vertex API URL: https://aiplatform.googleapis.com/...",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "discover_resources",
|
||
"display_name": "Resource Discovery",
|
||
"description": "Search public MCP registries (Smithery + ModelScope) for tools and capabilities that can extend your abilities. Use this when you encounter a task you cannot handle with your current tools.",
|
||
"category": "discovery",
|
||
"icon": "🔎",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"query": {"type": "string", "description": "Semantic description of the capability needed, e.g. 'send email', 'query SQL database', 'generate images'"},
|
||
"max_results": {"type": "integer", "description": "Max results to return (default 5, max 10)"},
|
||
},
|
||
"required": ["query"],
|
||
},
|
||
"config": {"smithery_api_key": "", "modelscope_api_token": ""},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "smithery_api_key",
|
||
"label": "Smithery API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "Get your key at smithery.ai/account/api-keys",
|
||
},
|
||
{
|
||
"key": "modelscope_api_token",
|
||
"label": "ModelScope API Token",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "Get your token at modelscope.cn → Home → Access Tokens",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "import_mcp_server",
|
||
"display_name": "Import MCP Server",
|
||
"description": "Import an MCP server from Smithery registry into the platform. The server's tools become available for use. Use discover_resources first to find the server ID.",
|
||
"category": "discovery",
|
||
"icon": "📥",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"server_id": {"type": "string", "description": "Smithery server ID, e.g. '@anthropic/brave-search' or '@anthropic/fetch'"},
|
||
"config": {"type": "object", "description": "Optional server configuration (e.g. API keys required by the server)"},
|
||
},
|
||
"required": ["server_id"],
|
||
},
|
||
"config": {"smithery_api_key": "", "modelscope_api_token": ""},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "smithery_api_key",
|
||
"label": "Smithery API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "Get your key at smithery.ai/account/api-keys",
|
||
},
|
||
{
|
||
"key": "modelscope_api_token",
|
||
"label": "ModelScope API Token",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "Get your token at modelscope.cn → Home → Access Tokens",
|
||
},
|
||
]
|
||
},
|
||
},
|
||
# --- Email tools ---
|
||
{
|
||
"name": "send_email",
|
||
"display_name": "Send Email",
|
||
"description": "Send an email to one or more recipients. Supports subject, body text, CC, and file attachments from workspace.",
|
||
"category": "email",
|
||
"icon": "📧",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"to": {"type": "string", "description": "Recipient email address(es), comma-separated for multiple"},
|
||
"subject": {"type": "string", "description": "Email subject line"},
|
||
"body": {"type": "string", "description": "Email body text"},
|
||
"cc": {"type": "string", "description": "CC recipients, comma-separated (optional)"},
|
||
"attachments": {
|
||
"type": "array",
|
||
"items": {"type": "string"},
|
||
"description": "List of workspace-relative file paths to attach (optional)",
|
||
},
|
||
},
|
||
"required": ["to", "subject", "body"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "email_provider",
|
||
"label": "Email Provider",
|
||
"type": "select",
|
||
"options": [
|
||
{"value": "gmail", "label": "Gmail", "help_text": "Google Account → Security → App passwords → Generate app password", "help_url": "https://support.google.com/accounts/answer/185833"},
|
||
{"value": "outlook", "label": "Outlook / Microsoft 365", "help_text": "Microsoft Account → Security → App passwords", "help_url": "https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9"},
|
||
{"value": "qq", "label": "QQ Mail", "help_text": "Settings → Account → POP3/IMAP/SMTP → Enable IMAP → Generate authorization code", "help_url": "https://service.mail.qq.com/detail/0/310"},
|
||
{"value": "163", "label": "163 Mail", "help_text": "Settings → POP3/SMTP/IMAP → Enable IMAP → Set authorization code", "help_url": "https://help.mail.163.com/faqDetail.do?code=d7a5dc8471cd0c0e8b4b8f4f8e49998b374173cfe9171305fa1ce630d7f67ac2"},
|
||
{"value": "qq_enterprise", "label": "Tencent Enterprise Mail", "help_text": "Enterprise Mail → Settings → Client-specific password → Generate new password", "help_url": "https://open.work.weixin.qq.com/help2/pc/18624"},
|
||
{"value": "aliyun", "label": "Alibaba Enterprise Mail", "help_text": "Use your email password directly", "help_url": ""},
|
||
{"value": "custom", "label": "Custom", "help_text": "Use the authorization code or app password from your email provider", "help_url": ""},
|
||
],
|
||
"default": "gmail",
|
||
},
|
||
{
|
||
"key": "email_address",
|
||
"label": "Email Address",
|
||
"type": "text",
|
||
"placeholder": "your@email.com",
|
||
},
|
||
{
|
||
"key": "auth_code",
|
||
"label": "Authorization Code",
|
||
"type": "password",
|
||
"placeholder": "Authorization code (not your login password)",
|
||
},
|
||
{
|
||
"key": "imap_host",
|
||
"label": "IMAP Host",
|
||
"type": "text",
|
||
"placeholder": "imap.example.com",
|
||
"depends_on": {"email_provider": ["custom"]},
|
||
},
|
||
{
|
||
"key": "imap_port",
|
||
"label": "IMAP Port",
|
||
"type": "number",
|
||
"default": 993,
|
||
"depends_on": {"email_provider": ["custom"]},
|
||
},
|
||
{
|
||
"key": "smtp_host",
|
||
"label": "SMTP Host",
|
||
"type": "text",
|
||
"placeholder": "smtp.example.com",
|
||
"depends_on": {"email_provider": ["custom"]},
|
||
},
|
||
{
|
||
"key": "smtp_port",
|
||
"label": "SMTP Port",
|
||
"type": "number",
|
||
"default": 465,
|
||
"depends_on": {"email_provider": ["custom"]},
|
||
},
|
||
]
|
||
},
|
||
},
|
||
{
|
||
"name": "read_emails",
|
||
"display_name": "Read Emails",
|
||
"description": "Read emails from your inbox. Can limit the number returned and search by criteria (e.g. FROM, SUBJECT, SINCE date).",
|
||
"category": "email",
|
||
"icon": "📬",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"limit": {"type": "integer", "description": "Max number of emails to return (default 10, max 30)", "default": 10},
|
||
"search": {"type": "string", "description": "IMAP search criteria, e.g. 'FROM \"john@example.com\"', 'SUBJECT \"meeting\"', 'SINCE 01-Mar-2026'. Default: all emails."},
|
||
"folder": {"type": "string", "description": "Mailbox folder (default INBOX)", "default": "INBOX"},
|
||
},
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "reply_email",
|
||
"display_name": "Reply Email",
|
||
"description": "Reply to an email by its Message-ID. Maintains the email thread with proper In-Reply-To headers.",
|
||
"category": "email",
|
||
"icon": "↩️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"message_id": {"type": "string", "description": "Message-ID of the email to reply to (from read_emails output)"},
|
||
"body": {"type": "string", "description": "Reply body text"},
|
||
},
|
||
"required": ["message_id", "body"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
# --- Feishu Integration Tools ---
|
||
# These tools require a configured Feishu channel to function.
|
||
# They are NOT enabled by default — agents with Feishu channels should enable them.
|
||
{
|
||
"name": "send_feishu_message",
|
||
"display_name": "Feishu Message",
|
||
"description": "Send a message to a human colleague via Feishu. Can only message people in your relationships.",
|
||
"category": "feishu",
|
||
"icon": "💬",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"member_name": {"type": "string", "description": "Recipient name"},
|
||
"message": {"type": "string", "description": "Message content"},
|
||
},
|
||
"required": ["member_name", "message"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_user_search",
|
||
"display_name": "Feishu User Search",
|
||
"description": "Search for a colleague in the Feishu (Lark) directory by name. Returns their open_id, email, and department.",
|
||
"category": "feishu",
|
||
"icon": "🔍",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"name": {"type": "string", "description": "The colleague's name to search for"},
|
||
},
|
||
"required": ["name"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "bitable_create_app",
|
||
"display_name": "Bitable Create",
|
||
"description": "在飞书云盘中新建一个多维表格（Bitable）应用。创建后返回可直接访问的链接和 App Token，下一步可以通过 bitable_list_tables 查看初始数据表。",
|
||
"category": "feishu",
|
||
"icon": "📊",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"name": {"type": "string", "description": "新多维表格的名称，例如「项目追踪表」"},
|
||
"folder_token": {"type": "string", "description": "可选：父文件夹的 folder_token。不填则创建到「我的空间」根目录。"},
|
||
},
|
||
"required": ["name"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "bitable_list_tables",
|
||
"display_name": "Bitable List Tables",
|
||
"description": "列出飞书多维表格内的所有数据表 (Tables)。url 支持表格链接或 Wiki 链接。使用此工具了解请求的多维表格中有哪些表。",
|
||
"category": "feishu",
|
||
"icon": "📊",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"url": {"type": "string", "description": "多维表格的 URL 链接。"},
|
||
},
|
||
"required": ["url"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "bitable_list_fields",
|
||
"display_name": "Bitable List Fields",
|
||
"description": "列出飞书多维表格指定数据表中的所有字段 (Fields)。url 支持表格链接或 Wiki 链接。在查询或修改数据前，必须先调用此工具了解字段名称和类型。",
|
||
"category": "feishu",
|
||
"icon": "⌨️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"url": {"type": "string", "description": "多维表格的 URL 链接。"},
|
||
"table_id": {"type": "string", "description": "具体的数据表 ID，如果 url 中包含 tbl 则可以不填。"},
|
||
},
|
||
"required": ["url"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "bitable_query_records",
|
||
"display_name": "Bitable Query Records",
|
||
"description": "查询飞书多维表格中的数据行。可以提供过滤条件 (filter)。",
|
||
"category": "feishu",
|
||
"icon": "🔍",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"url": {"type": "string", "description": "多维表格的 URL 链接。"},
|
||
"table_id": {"type": "string", "description": "具体的数据表 ID，如果 url 中包含 tbl 则可以不填。"},
|
||
"filter_info": {"type": "string", "description": "可选，FQL 语法的过滤条件，例如 'CurrentValue.[Status]=\"Done\"'。如不确定过滤语法，可以不填，由你臺己在本地过滤返回的所有数据。"},
|
||
"max_results": {"type": "integer", "description": "最大返回条数 (默认 100)"},
|
||
},
|
||
"required": ["url"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "bitable_create_record",
|
||
"display_name": "Bitable Create Record",
|
||
"description": "在飞书多维表格中新增一行数据。fields 参数是一个字典，key 是字段名 (需要先通过 bitable_list_fields 获取)，value 是对应的值。",
|
||
"category": "feishu",
|
||
"icon": "➕",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"url": {"type": "string", "description": "多维表格的 URL 链接。"},
|
||
"table_id": {"type": "string", "description": "具体的数据表 ID，如果 url 中包含 tbl 则可以不填。"},
|
||
"fields": {"type": "string", "description": "一个 JSON 字符串，代表要插入的 fields。例如：'{\"Name\": \"张三\", \"Age\": 30}'"},
|
||
},
|
||
"required": ["url", "fields"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "bitable_update_record",
|
||
"display_name": "Bitable Update Record",
|
||
"description": "更新飞书多维表格中的指定行数据。",
|
||
"category": "feishu",
|
||
"icon": "✏️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"url": {"type": "string", "description": "多维表格的 URL 链接。"},
|
||
"table_id": {"type": "string", "description": "具体的数据表 ID，如果 url 中包含 tbl 则可以不填。"},
|
||
"record_id": {"type": "string", "description": "要更新的 record_id，通过 bitable_query_records 获取。"},
|
||
"fields": {"type": "string", "description": "一个 JSON 字符串，代表要更新的 fields。例如：'{\"Status\": \"Done\"}'"},
|
||
},
|
||
"required": ["url", "record_id", "fields"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "bitable_delete_record",
|
||
"display_name": "Bitable Delete Record",
|
||
"description": "删除飞书多维表格中的指定行数据。",
|
||
"category": "feishu",
|
||
"icon": "🗑️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"url": {"type": "string", "description": "多维表格的 URL 链接。"},
|
||
"table_id": {"type": "string", "description": "具体的数据表 ID，如果 url 中包含 tbl 则可以不填。"},
|
||
"record_id": {"type": "string", "description": "要删除的 record_id，通过 bitable_query_records 获取。"},
|
||
},
|
||
"required": ["url", "record_id"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_doc_read",
|
||
"display_name": "Feishu Doc Read",
|
||
"description": "Read the text content of a Feishu document (Docx). Provide the document token from its URL.",
|
||
"category": "feishu",
|
||
"icon": "📄",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"document_token": {"type": "string", "description": "Feishu document token (from document URL)"},
|
||
"max_chars": {"type": "integer", "description": "Max characters to return (default 6000, max 20000)"},
|
||
},
|
||
"required": ["document_token"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_doc_create",
|
||
"display_name": "Feishu Doc Create",
|
||
"description": "Create a new Feishu document with a given title. Returns the new document token and URL.",
|
||
"category": "feishu",
|
||
"icon": "📝",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"title": {"type": "string", "description": "Document title"},
|
||
"folder_token": {"type": "string", "description": "Optional: parent folder token"},
|
||
},
|
||
"required": ["title"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_doc_append",
|
||
"display_name": "Feishu Doc Append",
|
||
"description": "Append text content to an existing Feishu document as new paragraphs at the end.",
|
||
"category": "feishu",
|
||
"icon": "📎",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"document_token": {"type": "string", "description": "Feishu document token"},
|
||
"content": {"type": "string", "description": "Text content to append"},
|
||
},
|
||
"required": ["document_token", "content"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_drive_share",
|
||
"display_name": "Feishu Drive Share",
|
||
"description": "Manage collaborators for any Feishu Drive file (docx, bitable, sheet, etc.). Add, remove, or list collaborators with view/edit/full_access permissions.",
|
||
"category": "feishu",
|
||
"icon": "🔗",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"document_token": {"type": "string", "description": "File token (from URL or previous tool output)"},
|
||
"doc_type": {"type": "string", "enum": ["docx", "bitable", "sheet", "doc", "folder", "mindnote", "slides"], "description": "File type. Default: 'docx'"},
|
||
"action": {"type": "string", "enum": ["add", "remove", "list"], "description": "'add' to grant, 'remove' to revoke, 'list' to view"},
|
||
"member_names": {"type": "array", "items": {"type": "string"}, "description": "Colleague names to add/remove (auto-searched)"},
|
||
"member_open_ids": {"type": "array", "items": {"type": "string"}, "description": "Feishu open_ids directly"},
|
||
"permission": {"type": "string", "enum": ["view", "edit", "full_access"], "description": "Permission level. Default: 'edit'"},
|
||
},
|
||
"required": ["document_token", "action"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_drive_delete",
|
||
"display_name": "Feishu Drive Delete",
|
||
"description": "Delete a file or folder from Feishu Drive. The file is moved to the recycle bin. Supports all file types: docx, bitable, sheet, folder, etc.",
|
||
"category": "feishu",
|
||
"icon": "🗑️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"file_token": {"type": "string", "description": "Token of the file to delete"},
|
||
"file_type": {"type": "string", "enum": ["file", "docx", "bitable", "folder", "doc", "sheet", "mindnote", "shortcut", "slides"], "description": "Type of the file to delete"},
|
||
},
|
||
"required": ["file_token", "file_type"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_calendar_list",
|
||
"display_name": "Feishu Calendar List",
|
||
"description": "List Feishu calendar events. No email or authorization needed.",
|
||
"category": "feishu",
|
||
"icon": "📅",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"start_time": {"type": "string", "description": "Range start, ISO 8601. Default: now."},
|
||
"end_time": {"type": "string", "description": "Range end, ISO 8601. Default: 7 days from now."},
|
||
"max_results": {"type": "integer", "description": "Max events to return (default 20)"},
|
||
},
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_calendar_create",
|
||
"display_name": "Feishu Calendar Create",
|
||
"description": "Create a Feishu calendar event. Supports inviting colleagues by name. No email needed.",
|
||
"category": "feishu",
|
||
"icon": "📅",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"summary": {"type": "string", "description": "Event title"},
|
||
"start_time": {"type": "string", "description": "Event start in ISO 8601 with timezone"},
|
||
"end_time": {"type": "string", "description": "Event end in ISO 8601 with timezone"},
|
||
"description": {"type": "string", "description": "Event description or agenda"},
|
||
"attendee_names": {"type": "array", "items": {"type": "string"}, "description": "Names of colleagues to invite"},
|
||
"location": {"type": "string", "description": "Event location"},
|
||
},
|
||
"required": ["summary", "start_time", "end_time"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_calendar_update",
|
||
"display_name": "Feishu Calendar Update",
|
||
"description": "Update an existing Feishu calendar event. Provide only the fields you want to change.",
|
||
"category": "feishu",
|
||
"icon": "📅",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"user_email": {"type": "string", "description": "Calendar owner's email"},
|
||
"event_id": {"type": "string", "description": "Event ID from feishu_calendar_list"},
|
||
"summary": {"type": "string", "description": "New title"},
|
||
"start_time": {"type": "string", "description": "New start time (ISO 8601)"},
|
||
"end_time": {"type": "string", "description": "New end time (ISO 8601)"},
|
||
},
|
||
"required": ["user_email", "event_id"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_calendar_delete",
|
||
"display_name": "Feishu Calendar Delete",
|
||
"description": "Delete (cancel) a Feishu calendar event.",
|
||
"category": "feishu",
|
||
"icon": "🗑️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"user_email": {"type": "string", "description": "Calendar owner's email"},
|
||
"event_id": {"type": "string", "description": "Event ID to delete"},
|
||
},
|
||
"required": ["user_email", "event_id"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_approval_create",
|
||
"display_name": "Feishu Approval Create",
|
||
"description": "发起一个飞书审批流实例。你需要知道审批定义的 approval_code 和表单对应字段的内容。",
|
||
"category": "feishu",
|
||
"icon": "📝",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"approval_code": {"type": "string", "description": "审批定义的唯一代码 (approval_code)"},
|
||
"user_id": {"type": "string", "description": "发起人的 open_id。可以通过 feishu_user_search 获取。"},
|
||
"form_data": {"type": "string", "description": "表单内容的 JSON 字符串，例如 '[{\"id\":\"widget1\",\"type\":\"input\",\"value\":\"这是内容\"}]'"},
|
||
},
|
||
"required": ["approval_code", "user_id", "form_data"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_approval_query",
|
||
"display_name": "Feishu Approval Query",
|
||
"description": "查询指定的飞书审批实例列表。可以支持按状态查询（PENDING, APPROVED, REJECTED, CANCELED, DELETED）。",
|
||
"category": "feishu",
|
||
"icon": "📋",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"approval_code": {"type": "string", "description": "审批定义的唯一代码 (approval_code)"},
|
||
"status": {"type": "string", "description": "可选过滤状态：PENDING, APPROVED, REJECTED, CANCELED, DELETED"},
|
||
},
|
||
"required": ["approval_code"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "feishu_approval_get",
|
||
"display_name": "Feishu Approval Get",
|
||
"description": "获取指定飞书审批实例的详细信息与当前审批状态。",
|
||
"category": "feishu",
|
||
"icon": "📊",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"instance_id": {"type": "string", "description": "审批实例的 instance_id"},
|
||
},
|
||
"required": ["instance_id"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
# --- Pages: public HTML hosting ---
|
||
{
|
||
"name": "publish_page",
|
||
"display_name": "Publish Page",
|
||
"description": "Publish an HTML file from workspace as a public page. Returns a public URL that anyone can access without login. Only .html/.htm files can be published.",
|
||
"category": "pages",
|
||
"icon": "🌐",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"path": {"type": "string", "description": "File path in workspace, e.g. 'workspace/output.html'"},
|
||
},
|
||
"required": ["path"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "list_published_pages",
|
||
"display_name": "List Published Pages",
|
||
"description": "List all pages published by this agent, showing their public URLs and view counts.",
|
||
"category": "pages",
|
||
"icon": "📋",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {},
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
# --- Skill Management ---
|
||
{
|
||
"name": "search_clawhub",
|
||
"display_name": "Search ClawHub",
|
||
"description": "Search the ClawHub skill registry for skills matching a query. Returns a list of available skills with name, description, and last updated date.",
|
||
"category": "discovery",
|
||
"icon": "🔎",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"query": {"type": "string", "description": "Search query, e.g. 'research', 'code review', 'market analysis'"},
|
||
},
|
||
"required": ["query"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "install_skill",
|
||
"display_name": "Install Skill",
|
||
"description": "Install a skill into this agent's workspace. Accepts a ClawHub slug (e.g. 'market-research') or a GitHub URL.",
|
||
"category": "discovery",
|
||
"icon": "📥",
|
||
"is_default": True,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"source": {"type": "string", "description": "ClawHub skill slug (e.g. 'market-research') or GitHub URL"},
|
||
},
|
||
"required": ["source"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
]
|
||
|
||
# ── AgentBay Tools ──────────────────────────────────────────────────────────
|
||
|
||
AGENTBAY_TOOLS = [
|
||
{
|
||
"name": "agentbay_browser_navigate",
|
||
"display_name": "AgentBay: 浏览器访问",
|
||
"description": "[ENV: Browser] Navigate to a URL in the AgentBay HEADLESS BROWSER environment. IMPORTANT: This browser runs in an ISOLATED environment — it does NOT share filesystem, processes, or downloads with the Cloud Desktop (computer_* tools) or Code Sandbox (code_execute/command_exec). Files downloaded here are NOT accessible from other environments. Tip: after navigating, use browser_observe to identify interactive elements, then use browser_type/browser_click to interact.",
|
||
"category": "agentbay",
|
||
"icon": "🌐",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"url": {"type": "string", "description": "要访问的网址"},
|
||
"wait_for": {"type": "string", "description": "等待元素选择器（可选）"},
|
||
"save_to_workspace": {
|
||
"type": "boolean",
|
||
# Set to True ONLY when the user explicitly asks to SEE or SAVE
|
||
# a screenshot (e.g. "截图给我看", "保存截图"). Default False means
|
||
# the screenshot is held in memory for LLM vision only (invisible to user).
|
||
"description": "CRITICAL: Set to True IF AND ONLY IF the user explicitly asked you to SHOW them a screenshot or save it (e.g. \"截图给我看\", \"截图看看\", \"把截图发出来\"). If True, the image is saved to their workspace and you get a Markdown link. Default is False (internal in-memory analysis only, completely invisible to the user).",
|
||
"default": False,
|
||
},
|
||
},
|
||
"required": ["url"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "api_key",
|
||
"label": "API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "从阿里云 AgentBay 控制台获取",
|
||
},
|
||
{
|
||
"key": "os_type",
|
||
"label": "Cloud Computer OS",
|
||
"type": "select",
|
||
"default": "windows",
|
||
"options": [
|
||
{"value": "linux", "label": "Linux"},
|
||
{"value": "windows", "label": "Windows"},
|
||
],
|
||
"description": "Operating system for AgentBay cloud desktop (computer tools only)",
|
||
},
|
||
],
|
||
},
|
||
},
|
||
{
|
||
"name": "agentbay_browser_screenshot",
|
||
"display_name": "AgentBay: 浏览器截图",
|
||
"description": "[ENV: Browser] Take a screenshot of the current page in the headless browser. This browser is ISOLATED from the Cloud Desktop and Code Sandbox. Use this after clicking, typing, or submitting a form to verify the result — it preserves the current page state. Never call browser_navigate just to take a screenshot.",
|
||
"category": "agentbay",
|
||
"icon": "📸",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"save_to_workspace": {
|
||
"type": "boolean",
|
||
# Set to True ONLY when the user explicitly asks to SEE or SAVE
|
||
# a screenshot. Default False = in-memory for LLM vision only.
|
||
"description": "CRITICAL: Set to True IF AND ONLY IF the user explicitly asked you to SHOW them a screenshot or save it (e.g. \"截图给我看\", \"截图看看\", \"把截图发出来\"). If True, the image is saved to their workspace and you get a Markdown link. Default is False (internal in-memory analysis only, completely invisible to the user).",
|
||
"default": False,
|
||
},
|
||
},
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_browser_click",
|
||
"display_name": "AgentBay: 浏览器点击",
|
||
"description": "[ENV: Browser] Click an element in the headless browser (ISOLATED from Desktop and Code Sandbox). selector can be a CSS selector (e.g. #btn) or natural language description (e.g. 'the Send button').",
|
||
"category": "agentbay",
|
||
"icon": "🖱️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"selector": {"type": "string", "description": "CSS selector (e.g. #button) or natural language description of the element (e.g. 'the blue Submit button')"},
|
||
},
|
||
"required": ["selector"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_browser_type",
|
||
"display_name": "AgentBay: 浏览器输入",
|
||
"description": "[ENV: Browser] Type text into an element in the headless browser (ISOLATED from Desktop and Code Sandbox). selector can be a CSS selector or natural language description (e.g. 'phone number input').",
|
||
"category": "agentbay",
|
||
"icon": "⌨️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"selector": {"type": "string", "description": "CSS selector or natural language description of the input field (e.g. 'the phone number input' or 'input[type=tel]')"},
|
||
"text": {"type": "string", "description": "要输入的文本"},
|
||
},
|
||
"required": ["selector", "text"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_code_execute",
|
||
"display_name": "AgentBay: 代码执行",
|
||
"description": "[ENV: Code Sandbox] Execute code (Python, Bash, Node.js) in the AgentBay Code Sandbox. IMPORTANT: This sandbox is an ISOLATED environment — it does NOT share filesystem, processes, or network with the Headless Browser (browser_* tools) or Cloud Desktop (computer_* tools). Files created here are NOT accessible from other environments.",
|
||
"category": "agentbay",
|
||
"icon": "💻",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"language": {"type": "string", "enum": ["python", "bash", "node"], "description": "编程语言"},
|
||
"code": {"type": "string", "description": "要执行的代码"},
|
||
"timeout": {"type": "integer", "description": "超时时间（秒）", "default": 30},
|
||
},
|
||
"required": ["language", "code"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
# ── Browser: Extract & Observe ────────────────────────────────────────
|
||
{
|
||
"name": "agentbay_browser_extract",
|
||
"display_name": "AgentBay: Browser Extract",
|
||
"description": "[ENV: Browser] Extract structured data from the current browser page using a natural language instruction. This browser is ISOLATED from the Cloud Desktop and Code Sandbox. More efficient than taking a screenshot and parsing with vision.",
|
||
"category": "agentbay",
|
||
"icon": "📊",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"instruction": {"type": "string", "description": "Natural language description of what data to extract, e.g. 'extract all product names and prices'"},
|
||
"selector": {"type": "string", "description": "Optional CSS selector to scope the extraction to a specific element"},
|
||
},
|
||
"required": ["instruction"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_browser_observe",
|
||
"display_name": "AgentBay: Browser Observe",
|
||
"description": "[ENV: Browser] Observe the current browser page state and return a list of interactive elements. This browser is ISOLATED from the Cloud Desktop and Code Sandbox. Helps the agent understand what can be clicked/interacted with on the page.",
|
||
"category": "agentbay",
|
||
"icon": "👁️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"instruction": {"type": "string", "description": "Natural language description of what to observe, e.g. 'find the login button' or 'list all navigation links'"},
|
||
"selector": {"type": "string", "description": "Optional CSS selector to scope observation"},
|
||
},
|
||
"required": ["instruction"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_browser_login",
|
||
"display_name": "AgentBay: Browser Login",
|
||
"description": "[ENV: Browser] Use AgentBay's AI-driven login skill to automate complex login flows (CAPTCHAs, OTP, multi-step auth) in the headless browser. This browser is ISOLATED from the Cloud Desktop and Code Sandbox.",
|
||
"category": "agentbay",
|
||
"icon": "🔐",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"url": {"type": "string", "description": "The login page URL to navigate to"},
|
||
"login_config": {"type": "string", "description": "JSON string with login config"},
|
||
},
|
||
"required": ["url", "login_config"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
# ── Command (Shell) ───────────────────────────────────────────────────
|
||
{
|
||
"name": "agentbay_command_exec",
|
||
"display_name": "AgentBay: Shell Command",
|
||
"description": "[ENV: Code Sandbox] Execute a shell command in the AgentBay Code Sandbox. IMPORTANT: This sandbox is ISOLATED from the Headless Browser (browser_* tools) and Cloud Desktop (computer_* tools). Files and processes are NOT shared between environments. Returns stdout, stderr, and exit code.",
|
||
"category": "agentbay",
|
||
"icon": "🖥️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"command": {"type": "string", "description": "Shell command to execute, e.g. 'ls -la' or 'pip install pandas'"},
|
||
"timeout_ms": {"type": "integer", "description": "Timeout in milliseconds (default 50000)", "default": 50000},
|
||
"cwd": {"type": "string", "description": "Working directory for the command (optional)"},
|
||
},
|
||
"required": ["command"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
# ── Computer Use ──────────────────────────────────────────────────────
|
||
{
|
||
"name": "agentbay_computer_screenshot",
|
||
"display_name": "AgentBay: Desktop Screenshot",
|
||
"description": "[ENV: Cloud Desktop] Take a screenshot of the full Cloud Desktop (Windows/Linux). IMPORTANT: This desktop is an ISOLATED environment — it does NOT share filesystem, processes, or browser sessions with the Headless Browser (browser_* tools) or Code Sandbox (code_execute/command_exec). To browse the web on this desktop, use computer_start_app to open a browser app. Essential for understanding the current desktop state before performing GUI operations.",
|
||
"category": "agentbay",
|
||
"icon": "📸",
|
||
"is_default": False,
|
||
"parameters_schema": {"type": "object", "properties": {}},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_click",
|
||
"display_name": "AgentBay: Mouse Click",
|
||
"description": "[ENV: Cloud Desktop] Click the mouse at specific screen coordinates on the Cloud Desktop (ISOLATED from Browser and Code Sandbox). Take a screenshot first to identify the target position.",
|
||
"category": "agentbay",
|
||
"icon": "🖱️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"x": {"type": "integer", "description": "X coordinate to click"},
|
||
"y": {"type": "integer", "description": "Y coordinate to click"},
|
||
"button": {"type": "string", "enum": ["left", "right", "middle", "double_left"], "description": "Mouse button (default: left)", "default": "left"},
|
||
},
|
||
"required": ["x", "y"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_input_text",
|
||
"display_name": "AgentBay: Keyboard Input",
|
||
"description": "[ENV: Cloud Desktop] Type text at the current cursor position on the Cloud Desktop (ISOLATED from Browser and Code Sandbox). Click on the target input field first.",
|
||
"category": "agentbay",
|
||
"icon": "⌨️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"text": {"type": "string", "description": "Text to type"},
|
||
},
|
||
"required": ["text"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_press_keys",
|
||
"display_name": "AgentBay: Keyboard Shortcut",
|
||
"description": "[ENV: Cloud Desktop] Press keyboard keys or shortcuts on the Cloud Desktop (ISOLATED from Browser and Code Sandbox). For example ['ctrl', 'c'] for copy, ['alt', 'tab'] for window switch, ['enter'] to confirm.",
|
||
"category": "agentbay",
|
||
"icon": "⌨️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"keys": {"type": "array", "items": {"type": "string"}, "description": "List of keys to press simultaneously, e.g. ['ctrl', 'c']"},
|
||
"hold": {"type": "boolean", "description": "If true, hold keys down", "default": False},
|
||
},
|
||
"required": ["keys"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_scroll",
|
||
"display_name": "AgentBay: Scroll",
|
||
"description": "[ENV: Cloud Desktop] Scroll the screen at a specific position on the Cloud Desktop (ISOLATED from Browser and Code Sandbox).",
|
||
"category": "agentbay",
|
||
"icon": "🔃",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"x": {"type": "integer", "description": "X coordinate of scroll position"},
|
||
"y": {"type": "integer", "description": "Y coordinate of scroll position"},
|
||
"direction": {"type": "string", "enum": ["up", "down", "left", "right"], "description": "Scroll direction (default: down)", "default": "down"},
|
||
"amount": {"type": "integer", "description": "Scroll amount in steps (default: 1)", "default": 1},
|
||
},
|
||
"required": ["x", "y"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_move_mouse",
|
||
"display_name": "AgentBay: Mouse Move",
|
||
"description": "[ENV: Cloud Desktop] Move the mouse to coordinates on the Cloud Desktop without clicking. Useful for triggering hover effects, tooltips, or dropdown menus.",
|
||
"category": "agentbay",
|
||
"icon": "🖱️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"x": {"type": "integer", "description": "Target X coordinate"},
|
||
"y": {"type": "integer", "description": "Target Y coordinate"},
|
||
},
|
||
"required": ["x", "y"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_drag_mouse",
|
||
"display_name": "AgentBay: Mouse Drag",
|
||
"description": "[ENV: Cloud Desktop] Drag the mouse from one position to another on the Cloud Desktop. Useful for selecting text, moving files, resizing windows.",
|
||
"category": "agentbay",
|
||
"icon": "🖱️",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"from_x": {"type": "integer", "description": "Start X coordinate"},
|
||
"from_y": {"type": "integer", "description": "Start Y coordinate"},
|
||
"to_x": {"type": "integer", "description": "End X coordinate"},
|
||
"to_y": {"type": "integer", "description": "End Y coordinate"},
|
||
"button": {"type": "string", "enum": ["left", "right", "middle"], "description": "Mouse button (default: left)", "default": "left"},
|
||
},
|
||
"required": ["from_x", "from_y", "to_x", "to_y"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_get_screen_size",
|
||
"display_name": "AgentBay: Get Screen Size",
|
||
"description": "[ENV: Cloud Desktop] Get the screen resolution of the Cloud Desktop. Useful for calculating click coordinates.",
|
||
"category": "agentbay",
|
||
"icon": "📐",
|
||
"is_default": False,
|
||
"parameters_schema": {"type": "object", "properties": {}},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_start_app",
|
||
"display_name": "AgentBay: Start Application",
|
||
"description": "[ENV: Cloud Desktop] Start an application on the Cloud Desktop by its launch command (e.g. 'firefox', 'libreoffice --calc'). The desktop is ISOLATED from the Headless Browser and Code Sandbox environments.",
|
||
"category": "agentbay",
|
||
"icon": "🚀",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"cmd": {"type": "string", "description": "Application launch command, e.g. 'firefox' or 'libreoffice --calc'"},
|
||
"work_dir": {"type": "string", "description": "Working directory for the application (optional)"},
|
||
},
|
||
"required": ["cmd"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_get_cursor_position",
|
||
"display_name": "AgentBay: Get Cursor Position",
|
||
"description": "[ENV: Cloud Desktop] Get the current mouse cursor position on the Cloud Desktop.",
|
||
"category": "agentbay",
|
||
"icon": "📍",
|
||
"is_default": False,
|
||
"parameters_schema": {"type": "object", "properties": {}},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_get_active_window",
|
||
"display_name": "AgentBay: Get Active Window",
|
||
"description": "[ENV: Cloud Desktop] Get information about the currently focused window on the Cloud Desktop, including window ID, title, and position.",
|
||
"category": "agentbay",
|
||
"icon": "🪟",
|
||
"is_default": False,
|
||
"parameters_schema": {"type": "object", "properties": {}},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_activate_window",
|
||
"display_name": "AgentBay: Activate Window",
|
||
"description": "[ENV: Cloud Desktop] Bring a specific window to the foreground on the Cloud Desktop by its window ID. Use get_active_window or list_visible_apps to find window IDs.",
|
||
"category": "agentbay",
|
||
"icon": "🪟",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"window_id": {"type": "integer", "description": "Window ID to activate"},
|
||
},
|
||
"required": ["window_id"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_computer_list_visible_apps",
|
||
"display_name": "AgentBay: List Running Apps",
|
||
"description": "[ENV: Cloud Desktop] List all currently visible/running applications on the Cloud Desktop with their process info and window IDs.",
|
||
"category": "agentbay",
|
||
"icon": "📋",
|
||
"is_default": False,
|
||
"parameters_schema": {"type": "object", "properties": {}},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
{
|
||
"name": "agentbay_file_transfer",
|
||
"display_name": "AgentBay: File Transfer",
|
||
"description": (
|
||
"Transfer a file between any two endpoints: the agent workspace, "
|
||
"the AgentBay browser environment, the cloud desktop, or the code sandbox. "
|
||
"Workspace -> env: upload a workspace file into a cloud environment. "
|
||
"Env -> workspace: download a file from a cloud environment into the workspace. "
|
||
"Env -> env: transfer between environments transparently (no workspace involvement)."
|
||
),
|
||
"category": "agentbay",
|
||
"icon": "🔄",
|
||
"is_default": False,
|
||
"parameters_schema": {
|
||
"type": "object",
|
||
"properties": {
|
||
"from_type": {
|
||
"type": "string",
|
||
"enum": ["workspace", "browser", "computer", "code"],
|
||
"description": "Source endpoint: 'workspace' for agent workspace, or the AgentBay environment name.",
|
||
},
|
||
"from_path": {
|
||
"type": "string",
|
||
"description": "Source path. Relative if workspace (e.g. 'workspace/data.csv'), absolute if env (e.g. '/root/data.csv').",
|
||
},
|
||
"to_type": {
|
||
"type": "string",
|
||
"enum": ["workspace", "browser", "computer", "code"],
|
||
"description": "Destination endpoint: 'workspace' for agent workspace, or the AgentBay environment name.",
|
||
},
|
||
"to_path": {
|
||
"type": "string",
|
||
"description": "Destination path. Relative if workspace (e.g. 'workspace/output.csv'), absolute if env (e.g. '/root/output.csv').",
|
||
},
|
||
},
|
||
"required": ["from_type", "from_path", "to_type", "to_path"],
|
||
},
|
||
"config": {},
|
||
"config_schema": {},
|
||
},
|
||
]
|
||
|
||
BUILTIN_TOOLS = [
|
||
*BUILTIN_TOOLS,
|
||
# ── AgentBay Tools ──
|
||
*AGENTBAY_TOOLS,
|
||
]
|
||
|
||
async def seed_builtin_tools():
|
||
"""Insert or update builtin tools in the database."""
|
||
from app.models.tool import AgentTool
|
||
from app.models.agent import Agent
|
||
|
||
async with async_session() as db:
|
||
new_tool_ids = []
|
||
for t in BUILTIN_TOOLS:
|
||
result = await db.execute(select(Tool).where(Tool.name == t["name"]))
|
||
existing = result.scalar_one_or_none()
|
||
if not existing:
|
||
tool = Tool(
|
||
name=t["name"],
|
||
display_name=t["display_name"],
|
||
description=t["description"],
|
||
type="builtin",
|
||
category=t["category"],
|
||
icon=t["icon"],
|
||
is_default=t["is_default"],
|
||
parameters_schema=t.get("parameters_schema", {"type": "object", "properties": {}}),
|
||
config=t.get("config", {}),
|
||
config_schema=t.get("config_schema", {}),
|
||
source="builtin",
|
||
)
|
||
db.add(tool)
|
||
await db.flush() # get tool.id
|
||
if t["is_default"]:
|
||
new_tool_ids.append(tool.id)
|
||
logger.info(f"[ToolSeeder] Created builtin tool: {t['name']}")
|
||
else:
|
||
# Sync fields that may evolve
|
||
updated_fields = []
|
||
if existing.category != t["category"]:
|
||
existing.category = t["category"]
|
||
updated_fields.append("category")
|
||
if existing.description != t["description"]:
|
||
existing.description = t["description"]
|
||
updated_fields.append("description")
|
||
if existing.display_name != t["display_name"]:
|
||
existing.display_name = t["display_name"]
|
||
updated_fields.append("display_name")
|
||
if existing.icon != t["icon"]:
|
||
existing.icon = t["icon"]
|
||
updated_fields.append("icon")
|
||
if t.get("config_schema") and existing.config_schema != t["config_schema"]:
|
||
existing.config_schema = t["config_schema"]
|
||
updated_fields.append("config_schema")
|
||
# Merge new config defaults when config_schema changes
|
||
if t.get("config"):
|
||
existing.config = {**t["config"], **(existing.config or {})}
|
||
updated_fields.append("config")
|
||
if not existing.config and t.get("config"):
|
||
existing.config = t["config"]
|
||
updated_fields.append("config")
|
||
if existing.parameters_schema != t["parameters_schema"]:
|
||
existing.parameters_schema = t["parameters_schema"]
|
||
updated_fields.append("parameters_schema")
|
||
if updated_fields:
|
||
logger.info(f"[ToolSeeder] Updated {', '.join(updated_fields)}: {t['name']}")
|
||
|
||
# Auto-assign new default tools to all existing agents
|
||
if new_tool_ids:
|
||
agents_result = await db.execute(select(Agent.id))
|
||
agent_ids = [row[0] for row in agents_result.fetchall()]
|
||
for agent_id in agent_ids:
|
||
for tool_id in new_tool_ids:
|
||
# Check if already assigned
|
||
check = await db.execute(
|
||
select(AgentTool).where(
|
||
AgentTool.agent_id == agent_id,
|
||
AgentTool.tool_id == tool_id,
|
||
)
|
||
)
|
||
if not check.scalar_one_or_none():
|
||
db.add(AgentTool(agent_id=agent_id, tool_id=tool_id, enabled=True))
|
||
logger.info(f"[ToolSeeder] Auto-assigned {len(new_tool_ids)} new tools to {len(agent_ids)} agents")
|
||
|
||
OBSOLETE_TOOLS = ["bing_search", "read_webpage", "manage_tasks"]
|
||
for obsolete_name in OBSOLETE_TOOLS:
|
||
result = await db.execute(select(Tool).where(Tool.name == obsolete_name))
|
||
obsolete = result.scalar_one_or_none()
|
||
if obsolete:
|
||
await db.delete(obsolete)
|
||
logger.info(f"[ToolSeeder] Removed obsolete tool: {obsolete_name}")
|
||
|
||
await db.commit()
|
||
logger.info("[ToolSeeder] Builtin tools seeded")
|
||
|
||
|
||
async def clean_orphaned_mcp_tools():
|
||
"""Clean up orphan MCP tools that lost all their AgentTool assignments.
|
||
|
||
This happens when an Agent is deleted (cascade deletes AgentTool) but the
|
||
shared Tool record remains. We run this periodically/on-startup to prevent
|
||
the database from filling up with abandoned tool records.
|
||
"""
|
||
from app.models.tool import AgentTool
|
||
from sqlalchemy import and_, delete
|
||
|
||
async with async_session() as db:
|
||
# 1. Get all currently assigned tool IDs
|
||
all_assigned_r = await db.execute(select(AgentTool.tool_id).distinct())
|
||
assigned_ids = [row[0] for row in all_assigned_r.fetchall()]
|
||
|
||
# 2. Delete MCP tools that have NO tenant_id AND are NOT in the assigned list
|
||
# tenant_id == None ensures we don't delete Global Tools manually added by company admins
|
||
stmt = delete(Tool).where(
|
||
and_(
|
||
Tool.type == "mcp",
|
||
Tool.tenant_id == None,
|
||
~Tool.id.in_(assigned_ids) if assigned_ids else True
|
||
)
|
||
)
|
||
result = await db.execute(stmt)
|
||
deleted_count = result.rowcount
|
||
await db.commit()
|
||
|
||
if deleted_count > 0:
|
||
logger.info(f"[ToolSeeder] Cleaned up {deleted_count} orphaned MCP tools")
|
||
|
||
# ── Atlassian Rovo MCP Server Integration ──────────────────────────────────
|
||
|
||
ATLASSIAN_ROVO_MCP_URL = "https://mcp.atlassian.com/v1/mcp"
|
||
|
||
ATLASSIAN_ROVO_CONFIG_TOOL = {
|
||
"name": "atlassian_rovo",
|
||
"display_name": "Atlassian Rovo (Jira / Confluence / Compass)",
|
||
"description": (
|
||
"Connect to Atlassian Rovo MCP Server to access Jira, Confluence, and Compass. "
|
||
"Configure your API key to enable Jira issue management, Confluence page creation, "
|
||
"and Compass component queries."
|
||
),
|
||
"category": "atlassian",
|
||
"icon": "🔷",
|
||
"is_default": False,
|
||
"parameters_schema": {"type": "object", "properties": {}},
|
||
"config": {"api_key": ""},
|
||
"config_schema": {
|
||
"fields": [
|
||
{
|
||
"key": "api_key",
|
||
"label": "Atlassian API Key",
|
||
"type": "password",
|
||
"default": "",
|
||
"placeholder": "ATSTT3x... (service account key) or Basic base64(email:token)",
|
||
"description": (
|
||
"Service account API key (Bearer) or base64-encoded email:api_token (Basic). "
|
||
"Get your API key from id.atlassian.com/manage-profile/security/api-tokens"
|
||
),
|
||
},
|
||
]
|
||
},
|
||
}
|
||
|
||
|
||
async def seed_atlassian_rovo_config():
|
||
"""Ensure the Atlassian Rovo platform config tool exists in the database.
|
||
|
||
If the env var ATLASSIAN_API_KEY is set, it will be written into the tool config
|
||
so the platform is immediately ready without manual UI setup.
|
||
"""
|
||
import os
|
||
env_key = os.environ.get("ATLASSIAN_API_KEY", "").strip()
|
||
|
||
async with async_session() as db:
|
||
t = ATLASSIAN_ROVO_CONFIG_TOOL
|
||
result = await db.execute(select(Tool).where(Tool.name == t["name"]))
|
||
existing = result.scalar_one_or_none()
|
||
if not existing:
|
||
initial_config = dict(t["config"])
|
||
if env_key:
|
||
initial_config["api_key"] = env_key
|
||
tool = Tool(
|
||
name=t["name"],
|
||
display_name=t["display_name"],
|
||
description=t["description"],
|
||
type="mcp_config",
|
||
category=t["category"],
|
||
icon=t["icon"],
|
||
is_default=t["is_default"],
|
||
parameters_schema=t["parameters_schema"],
|
||
config=initial_config,
|
||
config_schema=t["config_schema"],
|
||
mcp_server_url=ATLASSIAN_ROVO_MCP_URL,
|
||
mcp_server_name="Atlassian Rovo",
|
||
source="admin",
|
||
)
|
||
db.add(tool)
|
||
await db.commit()
|
||
logger.info("[ToolSeeder] Created Atlassian Rovo config tool")
|
||
else:
|
||
updated = False
|
||
if existing.config_schema != t["config_schema"]:
|
||
existing.config_schema = t["config_schema"]
|
||
updated = True
|
||
if existing.mcp_server_url != ATLASSIAN_ROVO_MCP_URL:
|
||
existing.mcp_server_url = ATLASSIAN_ROVO_MCP_URL
|
||
updated = True
|
||
# Write env key into DB if not already stored
|
||
if env_key and (not existing.config or not existing.config.get("api_key")):
|
||
existing.config = {**(existing.config or {}), "api_key": env_key}
|
||
updated = True
|
||
if updated:
|
||
await db.commit()
|
||
logger.info("[ToolSeeder] Updated Atlassian Rovo config tool")
|
||
|
||
|
||
async def get_atlassian_api_key() -> str:
|
||
"""Read the Atlassian API key from the platform config tool."""
|
||
async with async_session() as db:
|
||
result = await db.execute(select(Tool).where(Tool.name == "atlassian_rovo"))
|
||
tool = result.scalar_one_or_none()
|
||
if tool and tool.config:
|
||
return tool.config.get("api_key", "")
|
||
return ""
|