菜单
Query the list of all agents (employees) available to the current user. Use when generating code that requires a real agentId, or when the user asks "which agents/employees do I have".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | agent-info |
| description | Query the list of all agents (employees) available to the current user. Use when generating code that requires a real agentId, or when the user asks "which agents/employees do I have". |
| name-cn | 员工信息查询 |
| description-cn | 查询当前用户可用的所有员工（Agent）列表。当需要生成包含 agentId 的代码、或用户询问"我有哪些员工"时使用。 |
Query all agents accessible to the current user. Returns each agent's code (agentId), name, description and type.
code field is the agentId, usable directly in createTopicAndSend and similar APIs1. Query all agents (list.py)
↓ Get code / name / type
2. Use code directly as agentId in code generation
Query all agents available to the current user.
SYNOPSIS
python scripts/list.py [OPTIONS]
OPTIONS
| Option | Type | Required | Description |
|---|---|---|---|
--name-filter <keyword> | string | No | Fuzzy filter by agent name (case-insensitive) |
--type-filter <type> | string | No | Filter by type: official / custom / public |
OUTPUT
On success, returns JSON:
{
"total": 5,
"agents": [
{
"code": "SMA-xxxx",
"name": "Data Analyst",
"description": "Professional data analysis assistant",
"type": "custom"
}
]
}
code is the agentId, pass directly to window.Magic.project.createTopicAndSend(msg, {agentId: code})type values: official (built-in), custom (user-created), public (team/public shared)EXAMPLES
# 查询全部员工
python scripts/list.py
# 按名称过滤
python scripts/list.py --name-filter "数据分析"
# 按类型过滤
python scripts/list.py --type-filter custom
Before generating micro-app code that dispatches tasks to agents, run the script to get the agent list, then use the real code in generated code:
python scripts/list.py --name-filter "researcher"
Use the returned code directly:
const { topicId } = await window.Magic.project.createTopicAndSend(
message,
{ agentId: "SMA-xxxx" } // real code from list.py
);
When user asks "what agents do I have" or "show me available agents", run the script to get the full list.
Use for reading, analyzing, summarizing, and converting complex documents into Markdown artifacts or other supported document formats.
Use when the user provides API keys, tokens, or other configuration values that should persist across sessions, or when the user asks to query, list, or delete saved environment variables. Manages personal env by default and workspace env only when explicitly requested.
Create, modify, evaluate, package, and upload skills. Use when users want to create a skill from scratch, edit or optimize an existing skill, run evals to test a skill, benchmark skill performance, optimize a skill's description for better triggering accuracy, package a skill into a zip, or upload a skill to their skill library. Also use when user asks to "capture this workflow as a skill", "make a skill for X", "turn this into a reusable skill", "package this skill", or "upload to my skill library".
Discover, connect to, and invoke tools on MCP (Model Context Protocol) servers. CRITICAL - When the user message contains [@mcp:...] mention, you MUST load this skill first to use MCP tools correctly.
Use when the user wants to interact with DingTalk/钉钉 in any way — including but not limited to: reading, querying, searching, sending, replying to, forwarding, or recalling DingTalk/钉钉 chat messages and chat history; managing group chats and conversations; sending DING alerts; querying contacts, org structure, AI search, or coworkers; reading, searching, creating, or editing DingTalk/钉钉 docs, drive files, sheets, AI tables, wiki, mail, calendar events, meeting rooms, AI meeting minutes, attendance, OA approvals, todos, reports/logs, live sessions, AI apps, permissions, or open-platform docs.
Use when the user wants to interact with Lark/Feishu/飞书 in any way — including but not limited to: reading, querying, searching, sending, replying to, forwarding, or downloading Lark/Feishu/飞书 IM messages and chat history; managing group chats; listing, viewing, searching, creating, or editing cloud docs/files, Drive, Markdown, spreadsheets, Base tables, wiki, whiteboards, slides, apps, calendars/events/meeting rooms, contacts/org structure, tasks/todos, approvals, attendance, mail, minutes, VC notes, OKRs, real-time events, or custom Lark CLI skills. Load this skill first to find the right sub-skill.