agent-info

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 的代码、或用户询问"我有哪些员工"时使用。

List Available Agents

Query all agents accessible to the current user. Returns each agent's code (agentId), name, description and type.

Core Capabilities

• Get all available agents for the user (including built-in, custom, and public)
• Support fuzzy filtering by name
• The returned code field is the agentId, usable directly in createTopicAndSend and similar APIs

Quick Start

Typical Workflow

1. Query all agents (list.py)
   ↓ Get code / name / type
2. Use code directly as agentId in code generation

Available Scripts

---

list.py - List Agents

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

---

Use Cases

1. Get real agentId for micro-app code generation

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
);

2. User asks about available agents

When user asks "what agents do I have" or "show me available agents", run the script to get the full list.