에이전트 리소스

모든 에이전트 기반 앱에는 에이전트 리소스, 즉 에이전트를 나만의 것으로 만드는 사용자 정의 레이어가 함께 제공됩니다. 여기에는 팀 지침(AGENTS.md), 공유 학습(LEARNINGS.md), 개인 구조적 메모리(memory/MEMORY.md), 에이전트가 요청 시 가져오는 skills, 사용자 정의 하위 에이전트, 예약된 작업 및 연결된 MCP 서버 등 Claude 코드/Codex 설정에서 기대할 수 있는 모든 것이 포함되어 있습니다.

비틀림: 파일 시스템 파일이 아니라 PostgreSQL/PGlite 행입니다. 각 사용자는 데이터베이스에 저장된 자신만의 에이전트 리소스를 얻습니다. 가동할 개발 상자도 없고, 사용자당 컨테이너도 없고, 마운트할 파일도 없습니다. 멀티 테넌트 SaaS는 개인 메모리, 개인 MCP 서버, 개인 skills, 개인 하위 에이전트 등 모든 행이 행으로 구성되어 있고 공유 코드베이스가 이 모든 것을 한 번에 호스팅하기 때문에 모든 사용자에게 본질적으로 무료로 완전히 사용자 정의 가능한 에이전트를 제공할 수 있습니다.

동일한 기능. 다른 경제학. 이것이 SaaS에 중요한 이유는 앱를 참조하세요.

개요

리소스에는 세 가지 런타임 범위가 있습니다.

• 개인 — 단일 사용자(이메일)로 범위가 지정됩니다. 기본 설정, 메모 및 사용자별 컨텍스트에 적합합니다.
• 공유/조직 — 앱 또는 조직의 모든 사용자에게 표시됩니다. 앱/팀 지침, skills 및 공유 구성에 적합합니다.
• 작업 공간 — 디스패치 리소스에서 관리되는 상속된 전역 기본값입니다. 회사 정보, 포지셔닝, 브랜드 지침, 글로벌 가드레일, 작업 공간 전체 skills 및 공유 MCP 서버에 적합합니다. 앱은 런타임에 이를 읽습니다. 각 앱에 복사되지는 않습니다.

인앱 리소스 탭에는 세 가지 범위가 모두 표시됩니다. 개인 및 공유/조직 리소스를 편집할 수 있습니다. Workspace 범위 리소스는 앱 패널에서 읽기 전용이고 Dispatch에서 중앙에서 편집되므로 모든 앱은 동기화 단계 없이 동일한 표준 파일을 볼 수 있습니다.

에이전트가 각 리소스를 사용하는 방법을 제어하는 표준 경로:

이러한 경로는 작업 영역, 조직/앱, 개인의 세 가지 범위 모두에 적용됩니다. 동일한 경로가 여러 수준에 존재하는 경우 나중 범위가 우선합니다.

리소스를 가져가세요

이미 읽을 수 있는 텍스트 리소스의 체크섬 JSON 팩을 내보내고(export-resource-pack) 다른 앱이나 사용자로 가져옵니다(import-resource-pack). Resources 탭의 Export pack / Import pack 은 같은 액션을 호출합니다.

• 내보내기는 텍스트만 포함합니다. 바이너리 업로드는 생략됩니다. API 키 형태의 문자열과 MCP env / headers 토큰 필드는 가려집니다. 가져온 뒤 MCP를 다시 연결하세요.
• 가져오기는 기본이 personal 범위이며 충돌 시 건너뜁니다. 조직 가져오기는 조직 파일 편집과 같은 관리자 쓰기 ACL이 필요합니다. 워크스페이스 가져오기는 불가합니다.
• 텍스트 파일 200개 또는 1MB를 넘는 팩은 자르지 않고 too_large 로 실패합니다. 체크섬 불일치는 닫힌 실패입니다.

시작하기: 1분 둘러보기

60초 안에 상담원의 행동 방식을 변경하세요.

1. 리소스 탭 → 공유 → AGENTS.md를 엽니다(누락된 경우 + → 파일으로 생성).

2. 규칙 하나를 추가하세요. 예:

   ## 톤
   
   간결하게 작성하세요. 답을 제시하세요.

3. 저장하고 채팅으로 전환하고 무엇이든 물어보세요. 상담원은 즉시 새 규칙을 따릅니다.

원할 때 다음 단계:

• Skills (+ → 스킬) — /skill-name와의 채팅에서 호출되는 집중 방법 파일입니다.
• 에이전트 (+ → 에이전트) — @agent-name로 호출되는 재사용 가능한 하위 에이전트 페르소나.
• 예약된 작업 (+ → 예약된 작업) — cron에서 실행되는 프롬프트입니다. 일정 및 트리거는 Recurring Jobs를 참조하세요.
• 메모리 — 공유 LEARNINGS.md 및 개인 memory/MEMORY.md는 대화 전반에 걸쳐 지속적인 컨텍스트를 제공합니다.

전역 리소스 및 표준 경로

작업 공간 범위 리소스는 Dispatch의 리소스 페이지에서 관리되며 런타임 시 앱에 의해 상속됩니다. 복사 또는 동기화 단계가 없습니다. Dispatch는 두 가지 부여 범위를 지원합니다:

• 모든 앱 — 작업 공간의 모든 앱이 상속하는 전역 리소스입니다. 대부분의 회사, 브랜드, 페르소나, 포지셔닝, 메시징 및 가드레일 컨텍스트는 모든 앱이어야 합니다.
• 선택한 앱 — 앱별 컨텍스트 또는 도구를 위해 특정 앱에 부여된 리소스입니다. 이러한 정보는 아껴서 사용하세요.

경로는 에이전트가 리소스를 사용하는 방법을 결정합니다(위의 Overview 표 참조). 이곳은 많은 앱이 활용할 수 있는 핵심 페르소나, 포지셔닝, 메시징, 회사 정보, 브랜드 지침, 지원 정책, 공유 skills 또는 공유 HTTP MCP 도구를 위한 최적의 공간입니다.

새로운 작업 공간을 위한 유용한 스타터 팩:

context/company.md              # 회사가 하는 일, ICP, 제품, 링크
context/brand.md                # 음성, 시각적 정체성, 철자법, 금지된 사용
context/messaging.md            # 포지셔닝, 가치 제안, 입증 포인트, 반대 의견
instructions/guardrails.md      # 규정 준수, 에스컬레이션 및 승인 규칙
skills/company-voice/SKILL.md   # on-demand guidance for customer-facing writing
agents/<slug>.md                # reusable custom agent profiles

context/ 파일을 사실대로 유지하고 쉽게 훑어볼 수 있습니다. instructions/guardrails.md에 매 턴마다 적용해야 하는 규칙을 입력하세요. 상담원이 회사의 목소리에 맞춰 의도적으로 사본을 변형하거나 검토해야 하는 경우 skills/company-voice/SKILL.md를 사용하세요.

하나의 앱이나 팀에 대한 전역 기본값을 재정의하려면 해당 앱에 동일한 경로를 사용하여 공유/조직 리소스를 만듭니다. 한 사람에 대해 이를 재정의하려면 동일한 경로를 사용하여 개인 리소스를 만듭니다. 작업 영역 파일을 모든 앱에 복사하지 마세요. 런타임은 읽기 시 스택을 확인합니다.

workspace context/brand.md
-> shared/app context/brand.md
-> personal context/brand.md

예:

# 브랜드

- Voice: direct, warm, concrete
- Use: "workspace", "agent", "team"
- Avoid: unsupported superlatives and vague AI claims

리소스 탭

상담사 패널에는 Chat 및 CLI와 함께 리소스 탭이 포함되어 있습니다. 여기에는 모든 리소스의 폴더 구성 트리, 텍스트 파일용 인라인 편집기(Markdown, JSON, YAML, 일반 텍스트) 및 + 메뉴의 입력된 생성 흐름(파일, Skills, 에이전트, 예약된 작업)이 표시됩니다. 사용자는 상속된 작업 공간 기본값을 찾아보고 개인 또는 조직 리소스를 생성/편집/삭제할 수 있습니다.

리소스를 열면 편집기에 workspace default -> organization/app override -> personal override 스택이 포함된 유효 컨텍스트 스트립이 표시되므로 상속된 내용과 재정의가 활성화된 이유를 확인할 수 있습니다. Dispatch는 제어 영역 측에서 동일한 모델을 보여줍니다. 리소스 페이지에서 Effective in app을 사용하거나 앱 카드의 컨텍스트 대화 상자에서 리소스 행의 스택을 확장합니다.

디스패치 승인 정책이 활성화되면 모든 앱 리소스를 생성, 업데이트 또는 삭제하면 승인 요청이 즉시 적용되지 않고 대기열에 추가됩니다. 생성/편집/삭제 대화 상자에는 저장 전 영향 미리보기가 표시됩니다.

언제든지 이 문서로 돌아가려면 리소스 도구 모음에서 ? 아이콘을 클릭하세요.

에이전트가 리소스를 사용하는 방법

내장 앱 에이전트는 통합 resources 도구를 사용하여 리소스를 관리합니다. action: "list", "read", "effective", "write", "promote" 또는 "delete"를 사용합니다. 외부 CLI/코드 에이전트는 동등한 pnpm action resource-* 명령을 사용할 수 있습니다.

모든 대화가 시작될 때 상담원은 자동으로 다음 내용을 읽습니다.

AGENTS.md 및 지침

AGENTS.md는 기본적으로 시드되고 작업 공간, 공유/조직 및 개인 범위에서 순서대로 로드됩니다. 즉, 회사 전체 기본값을 위한 작업 공간, 팀 규칙을 위한 공유/앱, 사용자별 기본 설정을 위한 개인입니다. instructions/ 아래의 파일은 모든 차례(규정 준수 규칙, 에스컬레이션 정책, 브랜드 목소리)를 적용하고 동일한 우선 순위를 따르는 별도의 가드레일 문서입니다. 일반 채팅과 통합 트리거 실행 모두 응답하기 전에 이를 로드합니다.

AGENTS.md
instructions/customer-support-guardrails.md
instructions/legal-review-policy.md

참조 자료

재사용 가능한 회사 컨텍스트는 context/(페르소나, 포지셔닝, 제품 정보, 브랜드 지침, 경쟁 제품 정보)에 따릅니다. 에이전트는 이들의 색인을 확인하고 작업이 이에 의존할 수 있는 경우 resources 도구(action: "read")를 사용하여 관련 파일을 읽습니다. 앱이나 사용자에 대해 작업공간 기본값이 재정의되었는지 확인하려면 action: "effective"를 사용하세요.

메모리

에이전트 리소스에는 현재 두 개의 메모리 표면이 있습니다:

• 프로젝트 전반의 규칙, 수정 및 지속적인 팀 지식을 위한 공유 범위의 LEARNINGS.md.
• 현재 사용자에 대한 구조화된 메모리에 대한 개인 범위의 memory/MEMORY.md.

리소스 시스템은 이전 작업 공간과의 호환성을 위해 개인 LEARNINGS.md도 시드하지만 채팅 사전 로드 경로는 공유 LEARNINGS.md와 개인 memory/MEMORY.md입니다.

저장되는 내용. 에이전트를 수정("항상 Y 대신 X 사용"), 선호도 공유("간결한 답변을 선호합니다") 또는 컨텍스트 공개("우리 팀에서는 이를 '디스패치 레이어'라고 함")할 때 에이전트는 해당 학습 내용을 캡처하여 실수를 반복하거나 다시 요청하지 않습니다. 프로젝트 전반의 학습은 공유된 LEARNINGS.md로 진행됩니다. 사용자별 메모리는 memory/ 아래에 있습니다. capture-learnings 스킬은 시기와 방법을 설명합니다.

적합한 위치

사용자는 리소스 탭에서 직접 이러한 메모리 파일을 편집할 수 있습니다. 이는 일반 리소스입니다. 상담원이 잘못 입력한 줄을 삭제하고, memory/MEMORY.md에서 개인 기본 설정을 유지하거나, 팀 전체 규칙을 AGENTS.md로 승격하세요.

AGENTS.md, skills, 메모리, 사용자 지정 에이전트, MCP 서버 등 이러한 표면은 모두 동일한 기본 리소스 형태(path + scope + content)이며 동일한 방식으로 처리되고 해결됩니다.

Skills

Skills는 /skill-name와의 채팅에서 호출되는 에이전트 주문형 도메인 지식을 제공하는 skills/ 경로(바람직하게는 skills/<name>/SKILL.md) 아래의 Markdown 리소스 파일입니다. 리소스 탭에서 추가하거나 코드 모드의 .agents/skills/에서 추가하세요.

기술 형식, 범위, 검색 및 작성을 위한 단일 소스인 Skills Guide를 참조하세요.

맞춤 에이전트

사용자 지정 에이전트는 agents/*.md 아래에 Markdown 리소스로 저장된 재사용 가능한 로컬 하위 에이전트 프로필입니다. 이는 맞춤형 에이전트 형식의 표준 홈입니다.

고유한 이름, 설명, 모델 기본 설정 및 지침 세트를 갖춘 집중된 대표자를 원할 때 사용하십시오. skills와 달리 사용자 지정 에이전트는 수동적 지침이 아닙니다. 기본 에이전트가 @ 멘션을 통해 호출하거나 하위 에이전트 생성 중에 선택하여 호출할 수 있는 운영 페르소나입니다.

에이전트 형식

사용자 지정 에이전트는 YAML 머리말과 Markdown 지침을 사용합니다.

권장 규칙:

• agents/<slug>.md에 맞춤형 에이전트 저장
• 프로필에 분명히 다른 모델이 필요한 경우가 아니면 model: inherit를 사용하세요
• 지금은 tools: inherit를 유지하세요. 이 필드는 향후 도구 정책을 위해 예약되어 있습니다.

원격 에이전트와 맞춤형 에이전트

에이전트 리소스에는 두 가지 에이전트 유형이 있습니다.

• 사용자 지정 에이전트 — 현재 앱/런타임 내에서 실행되는 agents/*.md의 로컬 프로필
• 연결된 에이전트 — remote-agents/*.json의 매니페스트로 설명되는 원격 A2A 피어(레거시 agents/*.json 매니페스트는 계속 인식됨)

하나의 앱 내에서 위임을 위해 사용자 정의 에이전트를 사용합니다. A2A를 통해 다른 앱에 전화해야 할 때 연결된 에이전트를 사용하세요.

@ 태그와 / 슬래시 명령

채팅 입력에 @를 입력해 에이전트, 파일 또는 리소스를 참조하거나 /를 입력해 skill을 호출하세요. 둘 다 커서 위치에 드롭다운을 열고 항목을 선택하면 인라인 칩을 추가합니다. 전체 작동 방식(라우팅, MentionProvider, 하위 에이전트 선택)은 에이전트 멘션을, skills 작성 및 검색 방법은 Skills 가이드를 참조하세요.

코드 대 앱 모드

자원 시스템은 두 모드에서 동일하게 작동합니다. 차이점은 @ 태깅 및 / 명령에 사용할 수 있는 추가 소스입니다.

작업공간 연결

작업 공간 연결을 사용하면 앱이 자격 증명을 복제하지 않고도 동일한 공급자 계정(Slack, GitHub, HubSpot 등)을 공유할 수 있습니다. 연결은 공급자 ID, 계정 레이블, 상태, 범위, 앱 부여 및 자격 증명 참조를 PostgreSQL/PGlite에 기록합니다. 비밀은 자격 증명 저장소에 보관됩니다. 연결은 SLACK_BOT_TOKEN와 같은 자격 증명 키 이름만 가리킵니다.

빠른 시작, 연결/부여/자격 증명 참조 API 및 구체적인 Slack, HubSpot 및 GitHub 예는 Workspace Connections를 참조하세요.

자원 API

리소스는 서버 코드 actions 또는 REST API에서 관리할 수 있습니다.

서버 API

REST 엔드포인트가 자동으로 마운트됨:

액션 API

에이전트는 이러한 기본 제공 actions를 사용합니다. 자신의 actions에서 호출할 수도 있습니다:

# 모든 리소스 나열
pnpm action resource-list --scope all

# 리소스 읽기
pnpm action resource-read --path "skills/my-skill/SKILL.md"

# Dispatch가 관리하는 상속된 작업공간 컨텍스트 읽기
pnpm action resource-read --scope workspace --path "context/brand.md"

# Show workspace -> organization/app -> personal precedence for a path
pnpm action resource-effective --path "context/brand.md"

# 리소스 작성
pnpm action resource-write --path "notes/meeting.md" --content "# 회의록..."

# 리소스 삭제
pnpm action resource-delete --path "notes/old.md"

다음 단계

• Skills 가이드 — skills/에서 참조하는 skill 파일을 작성하고 범위 지정하기
• 에이전트 멘션 — @ 멘션과 / 명령의 전체 작동 방식
• 반복 작업 — Scheduled Tasks에서 만든 프롬프트 예약하기
• Workspace 거버넌스 — workspace 변경을 검토하고 승인하며 소유하는 주체
• 다중 앱 Workspace — 하나의 workspace가 포괄하는 배포 형태
• Workspace 연결 — 앱 간에 제공업체 자격 증명 공유하기