내장 Agent

Elftia는 다양한 시나리오에 맞게 미리 구성된 Agent를 제공하는 Agent 갤러리를 제공합니다. 이러한 Agent를 직접 사용하거나 이를 기반으로 맞춤 버전을 만들 수 있습니다.

Agent 갤러리

Agent 갤러리는 사전 설정된 Agent를 사용 사례별 카테고리로 구성하여 적합한 Agent를 빠르게 찾을 수 있게 해줍니다.

Agent 탐색하기

사이드바의 Agent 아이콘을 클릭해 Agent 패널을 엽니다
상단에 Gallery / My Agents 전환 탭이 표시됩니다
"Gallery" 탭을 선택해 모든 사전 설정 Agent를 둘러봅니다
검색 상자나 카테고리 필터를 사용해 빠르게 찾습니다

Agent 카테고리

Category	Description	Included Agent Types
Work	업무	프로젝트 관리, 작업 분해, 회의록, 주간 보고서
Business	비즈니스	비즈니스 분석, 시장 조사, 기획 제안
Tools	도구	파일 처리, 데이터 변환, 자동화 스크립트
Language	언어	번역, 교정, 문법 검사, 다국어
Office	오피스	문서 작성, 스프레드시트 처리, 프레젠테이션
Creative	크리에이티브	카피라이팅, 스토리 작성, 브레인스토밍
Coding	코딩	코드 생성, 코드 리뷰, 버그 수정, 테스트
Education	교육	지식 Q&A, 튜터링, 학습 계획

Agent 선택 및 사용

갤러리에서 Agent 카드를 클릭합니다
Agent의 세부 정보를 확인합니다.
- Description — Agent의 기능과 적용 가능한 시나리오
- Tool list — Agent가 사용할 수 있는 도구
- Permission mode — 도구 실행을 위한 보안 수준
- Model — Agent가 사용하는 LLM 모델
"Use"를 클릭해 대화를 시작합니다
"Favorite"를 클릭해 Agent를 빠른 액세스 목록에 추가할 수도 있습니다

즐겨찾기와 평점

Favorite — Agent 카드의 별 아이콘을 클릭합니다. 즐겨찾기한 Agent는 "My Agents" 목록 상단에 표시됩니다
Rate — Agent를 사용한 후 평점을 매겨 다른 사용자가 품질 좋은 Agent를 발견하는 데 도움을 줄 수 있습니다

Agent 구성 형식

각 Agent는 본문이 시스템 프롬프트 역할을 하고 YAML frontmatter를 사용해 구성 매개변수를 정의하는 Markdown 파일입니다.

파일 구조

---
name: Code Review Assistant
description: Review code quality, identify potential issues, and suggest improvements
model: main
permissionMode: default
tools:
  - Read
  - Glob
  - Grep
  - ListDir
skills:
  - code-standards
---

You are a professional code review assistant.

## Review Focus

1. Code quality and readability
2. Potential bugs and performance issues
3. Security vulnerabilities
4. Adherence to best practices

## Output Format

For each issue found, provide:
- Issue description
- Severity (High / Medium / Low)
- Suggested fix

구성 필드 참조

Field	Type	Required	Description
`name`	string	Yes	Agent 이름
`description`	string	Yes	Agent 설명(갤러리 카드에 표시)
`model`	string	No	모델 선택(별칭 지원, 기본값: `main`)
`permissionMode`	string	No	권한 모드(기본값: `default`)
`tools`	string[]	No	허용된 도구 목록(비어 있으면 모두 상속)
`skills`	string[]	No	자동 로드할 Skill 이름

모델 별칭

Agent 구성의 model 필드는 구성이 특정 모델에 묶이지 않도록 다음 별칭을 지원합니다.

Alias	Meaning	Description
`main`	메인 모델	현재 세션 구성의 메인 모델을 사용합니다(기본값)
`inherit`	상속된 모델	`main`과 동일하며, 부모 Agent의 모델을 상속합니다
`background`	백그라운드 모델	사용자가 구성한 백그라운드 모델(경량)을 사용합니다
`sonnet`	Sonnet 계열	부모 모델을 Sonnet 계열로 전환합니다(Anthropic만 해당)
`opus`	Opus 계열	부모 모델을 Opus 계열로 전환합니다(Anthropic만 해당)
`haiku`	Haiku 계열	부모 모델을 Haiku 계열로 전환합니다(Anthropic만 해당)

:::tip 의미 기반 별칭 사용 main, inherit, background 같은 의미 기반 별칭을 사용하는 것이 좋습니다. 이 별칭들은 특정 제공업체에 묶이지 않습니다. sonnet, opus, haiku는 Anthropic 모델을 사용할 때만 효과가 있습니다. :::

권한 모드

Mode	Description
`default`	민감한 도구(Bash, Write, Edit)는 사용자 확인이 필요합니다
`acceptEdits`	파일 편집은 자동으로 승인되지만, Shell 및 MCP 도구는 여전히 확인이 필요합니다
`bypassPermissions`	모든 도구가 확인 없이 자동으로 실행됩니다
`plan`	읽기 전용 모드입니다. Read, ListDir, Glob, Grep 같은 읽기 전용 도구만 허용됩니다

Agent 저장 위치

Agent 구성 파일은 다음 위치에 배치할 수 있습니다.

Location	Path	Scope
프로젝트 수준	`.claude/agents/*.md`	현재 프로젝트에서만 사용 가능
개인 수준	`~/.claude/agents/*.md`	모든 프로젝트에서 사용 가능
내장	앱에 번들로 포함	모든 사용자가 사용 가능

로드 우선순위: 프로젝트 수준 > 개인 수준 > 내장. 동일한 Agent 이름이 여러 위치에 있으면 프로젝트 수준 버전이 우선합니다.

FAQ

Problem	Cause	Solution
Agent가 갤러리에 표시되지 않음	Agent 구성 파일이 올바른 경로에 없음	파일이 `.claude/agents/` 디렉터리에 있는지 확인하세요
Agent가 특정 도구를 사용할 수 없음	해당 도구가 `tools` 필드에 나열되어 있지 않음	frontmatter에 도구 이름을 추가하세요
모델 별칭이 적용되지 않음	Anthropic에서만 지원되는 별칭을 사용 중	`main` 또는 `background` 의미 기반 별칭으로 전환하세요
커스텀 Agent가 다른 프로젝트에 표시되지 않음	프로젝트 수준 디렉터리에 저장됨	`~/.claude/agents/`(개인 수준)로 이동하세요

Agent 갤러리​

Agent 탐색하기​

Agent 카테고리​

Agent 선택 및 사용​

즐겨찾기와 평점​

Agent 구성 형식​

파일 구조​

구성 필드 참조​

모델 별칭​

권한 모드​

Agent 저장 위치​

FAQ​

관련 링크​