핵심 개념

UpServe를 잘 활용하려면 네 가지 단어를 알아야 합니다.

1. 에이전트 (Agent)

일을 수행하는 주체입니다. 사람으로 치면 “직원 한 명”.

에이전트는 Claude, OpenAI, Gemini 등 다양한 AI 모델 중 하나를 골라 사용합니다. 자세한 설정은 첫 에이전트 만들기를 참고하세요.

Father란? 에이전트를 처음 만들 때 대화 상대가 되는 안내 에이전트입니다. Father와 인터뷰하듯 이야기하면 새 에이전트의 역할·지침·이름을 자동으로 결정해 줍니다.

각 에이전트는 다음을 가집니다.

이름과 역할 설명 — 무엇을 하는 에이전트인지
행동 지침 — 성격, 말투, 우선순위 (Father와의 채팅으로 자동 작성됨)
도구 목록 — 사용할 수 있는 능력
Brain(메모리) — 과거 작업에서 배운 노하우를 에이전트 전용으로 보관하는 저장소. 다른 팀원과 공유하지 않는 개인 메모장입니다.
자율 실행 트리거 (선택) — 스케줄(정해진 시각), 웹훅(외부 신호), @멘션(팀원 호명), 자율 활동(Heartbeat), 꿈(Dream — 메모리 정리) 등 다양한 방식으로 스스로 깨어납니다 (트리거 안내)


┌────────────── 에이전트 한 명 ────────────────────────┐
│                                                      │
│  🪪 이름 · 역할 설명                                 │
│  📜 행동 지침                                        │
│                                                      │
│  ┌───────────┐  ┌─────────────┐  ┌────────────────┐  │
│  │  🔧 도구  │  │   📦 스킬   │  │  🧠 Brain(메모리)│ │
│  │  웹 검색  │  │ "노션 작성" │  │  feedback.md   │  │
│  │  bash실행 │  │ "슬랙 발송" │  │  project.md    │  │
│  │    ...    │  │     ...     │  │      ...       │  │
│  └───────────┘  └─────────────┘  └────────────────┘  │
│                                                      │
│  ⏰ 자율 실행 트리거 (선택) ─ 스케줄 / 웹훅 / 멘션   │
│                                                      │
└──────────────────────────────────────────────────────┘

2. 도구 (Tool)

에이전트의 능력입니다. 사람으로 치면 “노트북, 인터넷, 전화기”.

아래는 대표적인 기본 제공 도구입니다. 전체 목록은 도구 안내에서 확인하세요.

도구	설명
웹 검색	키워드로 웹을 검색
페이지 가져오기	특정 URL의 내용을 추출
브라우저 자동화	사이트를 직접 클릭·입력
데스크톱 GUI 조작	스크린샷을 보며 마우스·키보드로 앱 제어
명령어 실행(bash)	격리된 환경에서 셸 명령어 실행
파일 읽기·쓰기·편집	에이전트 전용 파일 공간에서 작업
이미지 생성	AI로 이미지 생성·편집
파일 공유	결과 파일을 다운로드 링크로 전달
Canvas	대화 화면에서 볼 수 있는 버전 관리 문서 생성
스케줄 관리	반복·예약 실행 등록·수정·삭제
태스크 관리	단계별 작업 항목 생성·진행·완료 처리
팀 채팅	팀원 에이전트에게 메시지 전송·@멘션
팀 공유 메모	팀 전체가 읽고 쓰는 이름–값 형태의 공유 메모장
사용자에게 질문	모르는 정보를 직접 물어보기 (텍스트 입력 또는 데스크톱 화면 직접 조작 위임)
알림 전송	자율 실행 중 중요한 내용을 사용자에게 푸시

에이전트 설정에서 도구를 켜고 끌 수 있습니다.

3. 스킬 (Skill)

재사용 가능한 작업 묶음입니다. 사람으로 치면 “매뉴얼이 첨부된 업무 절차”.

도구가 단일 능력이라면, 스킬은 여러 도구·코드·작업 지침을 묶어 특정 작업을 잘 하도록 패키징한 것입니다.

예시:

“인스타그램 게시물 자동 발행” 스킬 → 이미지 생성 + API 호출 + 결과 보고를 한 번에
“Notion 문서 작성” 스킬 → 인증·템플릿·포맷팅 노하우 포함

스킬은 마켓플레이스 에서 설치하거나, 직접 만들어 공유할 수 있습니다.

스킬에는 신뢰를 돕는 몇 가지 개념이 함께 있습니다.

건강도(Health) — 스킬이 실제로 얼마나 잘 동작하는지 성공률 기반 점수로 표시합니다. 스킬 카드의 초록·노랑·빨간 점으로 한눈에 확인할 수 있습니다. 아직 실행 기록이 없는 새 스킬은 점이 표시되지 않습니다.
계보(Lineage) — 스킬은 다른 스킬에서 파생(fork)되어 발전할 수 있습니다. 어떤 원본에서 왔는지 추적할 수 있어, 믿을 수 있는 스킬인지 판단하는 데 도움이 됩니다.
개선 제안(Proposals) — 에이전트가 스킬을 쓰다가 결함을 발견하면, 원작자에게 자동으로 개선 제안이 누적됩니다. 작성자는 제안을 검토해 스킬을 업데이트할 수 있습니다.
큐레이터(Curator) — 6시간마다 라이브러리를 점검해 미사용·오류 반복·오래된 버전·지원 종료된 스킬 등 정리 후보를 찾아 알려줍니다. 자동으로 삭제하거나 변경하지 않으며, 항목마다 직접 처리 여부를 결정합니다.

더 자세한 내용은 스킬과 자율 스킬 시스템에서 확인하세요.

4. 팀 (Team)

여러 에이전트가 협업하는 조직입니다. 사람으로 치면 “부서”.

복잡한 작업은 한 에이전트에게 모두 맡기는 것보다 역할을 나누는 게 효율적입니다.


연구팀 (리더 없는 동등한 동료들)
├── 자료 수집가 — 웹 검색 전담
├── 분석가 — 수집한 자료 분석
└── 보고서 작성자 — 최종 문서 정리

팀에는 리더나 코디네이터가 없습니다. 모든 에이전트가 동등한 동료이며, 사용자는 누구에게든 직접 말을 걸 수 있습니다. 에이전트들은 @멘션으로 서로 일을 넘기고 결과를 회신합니다. 팀원들끼리도 서로 채팅으로 소통할 수 있습니다. 팀 공유 메모(이름–값 형태의 공유 메모장)를 활용하면 여러 에이전트가 같은 정보를 공유하며 협업할 수 있습니다. 자세한 내용은 팀 가이드를 참고하세요.

관계도


                      팀 (Team)
                          │
        ┌─────────────────┼─────────────────┐
        │                 │                 │
    에이전트 A        에이전트 B        에이전트 C
        │                 │                 │
        ▼                 ▼                 ▼
 도구·스킬·메모리  도구·스킬·메모리  도구·스킬·메모리

💡 스킬 = 도구 + 코드 + 작업 지침이 묶인 작업 매뉴얼

고급 (Advanced)

Brain과 팀 공유 메모

에이전트의 Brain은 과거 작업에서 배운 노하우, 메모, 프로젝트 정보를 쌓아두는 에이전트 전용 공간입니다. 다른 팀원이 읽을 수 없는 개인 메모장이라고 생각하면 됩니다.

팀원과 정보를 나눠야 할 때는 팀 공유 메모를 사용합니다. 이름–값 형태(예: "시장_분석"이라는 이름에 분석 결과 값을 묶어 저장)로 팀 전체가 함께 읽고 쓸 수 있는 메모장입니다. 같은 이름으로 다시 쓰면 자동으로 버전이 올라가므로, 이름에 날짜나 “최신” 같은 표현을 붙이지 않아도 됩니다.

Canvas(캔버스)

에이전트가 보고서, 코드, 계획표 같은 결과물을 대화 화면 안에서 직접 보고 편집할 수 있는 버전 관리 문서입니다. 파일을 다운로드하지 않고도 내용을 바로 확인하고 수정을 요청할 수 있습니다.

공유(스냅샷)

에이전트를 외부 링크로 공유하거나 웹사이트에 삽입할 수 있습니다. 공유된 에이전트는 원본 에이전트와 독립된 대화 공간을 사용하며, Brain 메모리는 외부 사용자에게 노출되지 않습니다. 자세한 내용은 에이전트 설정의 스냅샷 탭을 참고하세요.

트리거

에이전트가 어떤 계기로 깨어나 일을 시작하는지를 트리거라고 합니다. 사용자 메시지 외에도 스케줄(정해진 시각), 웹훅(외부 서비스 신호), @멘션(팀원 호명), 자율 활동(Heartbeat — 정기적인 자체 점검), 꿈(Dream — 유휴 시간 중 메모리 정리·이니셔티브 발굴) 등이 있습니다. 자세한 내용은 트리거 안내를 참고하세요.

사용자에게 질문(AskUser)

에이전트가 작업 중 추가 정보가 필요하면 잠시 멈추고 질문을 보냅니다. 일반 텍스트로 답하거나 선택지를 고르는 방식 외에, 로그인·2FA 같이 직접 화면을 조작해야 하는 경우 에이전트가 데스크톱 화면을 사용자에게 넘겨줄 수도 있습니다.

사용자 승인

어떤 작업은 실행 전에 사용자 승인을 요청합니다. 에이전트가 민감하거나 되돌리기 어려운 동작을 수행하기 전에 잠시 멈추고 확인을 구하는 방식입니다. 자세한 내용은 승인 가이드를 참고하세요.

다음 단계

첫 에이전트 만들기 — 직접 만들어보면서 감 잡기