finding-agents

查找 Agent

此技能可帮助你查找同一 Letta 服务上的其他 Agent。

何时使用此技能

• 用户询问自己还有哪些其他 Agent
• 用户想按名称查找特定 Agent
• 用户想列出带有特定标签的 Agent
• 你需要查找用于迁移记忆的 Agent ID
• 你通过消息搜索找到一个 agent_id，需要了解该 Agent 的详细信息

CLI 用法

letta agents list [options]

选项

选项	说明
--name <name>	精确匹配名称
--query <text>	按名称模糊搜索
--tags <tag1,tag2>	按标签筛选（以逗号分隔）
--match-all-tags	要求匹配所有标签（默认：任意标签）
--include-blocks	在响应中包含 agent.blocks
--limit <n>	结果数量上限（默认：20）

常见用法

查找 Letta Code Agent

由 Letta Code 创建的 Agent 带有 origin:letta-code 标签。若要只查找 Letta Code Agent：

letta agents list --tags "origin:letta-code"

当用户要查找自己在 Letta Code CLI 会话中使用过的 Agent 时，这很有用。

查找所有 Agent

如果用户有在 Letta Code 之外创建的 Agent（例如通过 ADE、SDK 等方式创建），请在搜索时不使用标签筛选条件：

letta agents list

示例

列出所有 Agent（最多 20 个）：

letta agents list

按名称精确查找 Agent：

letta agents list --name "ProjectX-v1"

按名称搜索 Agent（模糊匹配）：

letta agents list --query "project"

只查找 Letta Code Agent：

letta agents list --tags "origin:letta-code"

查找带有多个标签的 Agent：

letta agents list --tags "frontend,production" --match-all-tags

在结果中包含记忆块：

letta agents list --query "project" --include-blocks

输出

返回包含 Agent 完整详细信息的原始 API 响应。关键字段：

• id - Agent ID（例如：agent-abc123）
• name - Agent 名称
• description - Agent 描述
• tags - Agent 标签
• blocks - 记忆块（如果使用了 --include-blocks）

相关技能

• migrating-memory - 找到 Agent 后，使用此技能复制/共享记忆块

按主题查找 Agent

如果你需要查找处理过特定主题的 Agent：

1. 搜索所有 Agent 的消息：

   letta messages search --query "topic" --all-agents --limit 10
   

2. 记下匹配消息中的 agent_id 值
3. 获取 Agent 详细信息：

   letta agents list --query "partial-name"
   

   或在 Letta API 中直接使用 agent_id