跳到主要内容

内置 Agent

Elftia 提供了一个 Agent 市场(Gallery),预置了多种场景的 Agent 配置。你可以直接使用这些 Agent,也可以基于它们创建自定义版本。

Agent 市场​

Agent 市场将预置 Agent 按使用场景分为多个类别,方便快速查找。

浏览 Agent​

  1. 点击侧边栏的 Agent 图标 打开 Agent 面板
  2. 在顶部可以看到 市场 / 我的 Agent 切换标签
  3. 选择「市场」标签浏览所有预置 Agent
  4. 使用搜索框或类别筛选快速定位

Agent 类别​

类别图标包含的 Agent 类型
Work工作项目管理、任务分解、会议纪要、周报
Business商务商业分析、市场研究、策划方案
Tools工具文件处理、数据转换、自动化脚本
Language语言翻译、校对、语法检查、多语言
Office办公文档撰写、表格处理、演示文稿
Creative创意文案创作、故事编写、头脑风暴
Coding编程代码生成、代码审查、Bug 修复、测试
Education教育知识问答、课程辅导、学习计划

选择和使用 Agent​

  1. 在市场中点击感兴趣的 Agent 卡片
  2. 查看 Agent 的详细信息:
    • 描述 — Agent 的能力和适用场景
    • 工具列表 — Agent 可以使用的工具
    • 权限模式 — 工具执行的安全级别
    • 模型 — Agent 使用的 LLM 模型
  3. 点击「使用」按钮开始对话
  4. 也可以点击「收藏」将 Agent 添加到快速访问列表

收藏与评分​

  • 收藏 — 点击 Agent 卡片上的星标图标,收藏后的 Agent 会出现在「我的 Agent」列表顶部
  • 评分 — 使用后可以为 Agent 评分,帮助其他用户发现优质 Agent

Agent 配置格式​

每个 Agent 本质上是一个 Markdown 文件,使用 YAML frontmatter 定义配置参数,正文部分作为系统提示(System Prompt)。

文件结构​

---
name: 代码审查助手
description: 审查代码质量,发现潜在问题,提出改进建议
model: main
permissionMode: default
tools:
- Read
- Glob
- Grep
- ListDir
skills:
- code-standards
---

你是一个专业的代码审查助手。

## 审查重点

1. 代码质量和可读性
2. 潜在的 Bug 和性能问题
3. 安全漏洞
4. 最佳实践遵循情况

## 输出格式

对每个发现的问题,给出:
- 问题描述
- 严重程度(高/中/低)
- 修改建议

配置字段说明​

字段类型必填说明
namestring是Agent 名称
descriptionstring是Agent 描述(显示在市场卡片中)
modelstring否模型选择(支持别名,默认 main)
permissionModestring否权限模式(默认 default)
toolsstring[]否允许使用的工具列表(空则继承所有)
skillsstring[]否自动加载的技能名称列表

模型别名​

Agent 配置中的 model 字段支持以下别名,让配置不绑定具体模型:

别名含义说明
main主模型使用当前会话配置的主模型(默认)
inherit继承模型与 main 相同,继承父 Agent 模型
background后台模型使用用户配置的后台模型(轻量级)
sonnetSonnet 系列将父模型切换为 Sonnet 系列(仅 Anthropic)
opusOpus 系列将父模型切换为 Opus 系列(仅 Anthropic)
haikuHaiku 系列将父模型切换为 Haiku 系列(仅 Anthropic)

:::tip 推荐使用语义别名 推荐使用 main、inherit、background 等语义别名,它们不绑定特定提供商。sonnet、opus、haiku 仅在使用 Anthropic 模型时有效。 :::

权限模式​

模式说明
default敏感工具(Bash、Write、Edit)需要用户确认
acceptEdits文件编辑自动通过,Shell 和 MCP 工具仍需确认
bypassPermissions所有工具自动执行,不需要确认
plan只读模式,仅能使用 Read、ListDir、Glob、Grep 等只读工具

Agent 存储位置​

Agent 配置文件可以放在以下位置:

位置路径作用域
项目级.claude/agents/*.md仅当前项目可用
个人级~/.claude/agents/*.md所有项目可用
内置应用内置所有用户可用

加载优先级:项目级 > 个人级 > 内置。同名 Agent 中,项目级覆盖个人级。

常见问题​

问题原因解决方案
市场中看不到某个 AgentAgent 配置文件不在正确路径检查文件是否在 .claude/agents/ 目录下
Agent 无法使用某个工具tools 字段中未列出该工具在 frontmatter 中添加工具名称
模型别名不生效使用了仅 Anthropic 支持的别名改用 main 或 background 语义别名
自定义 Agent 在其他项目看不到放在了项目级目录移动到 ~/.claude/agents/ 个人级目录

相关链接​