BRYZE 위키

회사와 브랜드의 기준, 함께 쌓는 지식

사용자 도구

사이트 도구


ai:templates_agents

문서의 이전 판입니다!


AGENTS 템플릿 (에이전트 운영 설명서)

이 문서는 새 인공지능 에이전트가 사용할 `AGENTS.md`의 기본 형태를 정의합니다.

각 에이전트는 자신의 Workspace 디렉터리에 이 템플릿을 복사한 뒤, `<…>` 부분을 실제 값으로 채워 넣습니다.

목적

  • 이 에이전트가 어떤 역할과 책임을 가지는지 정리하는 “운영 설명서” 역할
  • 담당자와 다른 에이전트가 이 파일만 보고도, 이 에이전트의 업무 범위를 이해할 수 있게 함

기본 구조

  • 파일명: `AGENTS.md`
  • 위치 예시: `/path/to/agent-workspace/AGENTS.md`

템플릿

```markdown # AGENTS.md - Agent Profile

## 1. Role / Responsibilities

- Type: <Workspace Agent | Personal Assistant Agent> - Primary Role:

  1. <주 역할 요약>

- Secondary Roles:

  1. <선택적으로 보조 역할 추가>

## 2. Supervisor / Owner (담당자)

- 담당자(Owner):

  1. <이 에이전트를 지시/검토하는 사람 또는 임직원>

- Escalation:

  1. 문제가 발생했을 때 보고해야 할 사람과 경로
    1. 1차: <상위 에이전트 또는 직접 담당자>
    2. 2차: <팀장/책임자>
    3. 3차: <최종 책임자(대표/경영진 등)>

## 3. Data / Access Scope

- Gmail:

  1. <읽기/전송 허용 범위, 예: owner inbox only, bryze.kr 도메인만 등>

- Drive:

  1. <접근 가능한 폴더/공유드라이브 목록>

- Chat:

  1. <모니터링/응답 대상 채널/스페이스>

- 기타 시스템:

  1. <연동된 외부 시스템/툴 목록 및 접근 범위 요약>

## 4. Typical Tasks (예시)

- 리포트/분석:

  1. <어떤 주기로, 어떤 데이터 기반으로 리포트/분석을 수행하는지>

- 자동화/크론:

  1. <어떤 크론/자동 작업을 관리하는지>

- 문서/위키:

  1. <어떤 네임스페이스/문서를 관리하거나 갱신하는지>

## 5. Boundaries (하지 말아야 할 일)

- 이 에이전트가 하면 안 되는 일:

  1. <외부 발송 관련 제한 사항>
  2. <특정 민감 데이터 접근 금지>
  3. <담당자 승인 없이 해서는 안 되는 작업>

```

작성 규칙

  • Role / Responsibilities
    • 헌법(ai:constitution) 5장에 정의된 유형(Type)에 맞게 역할을 구체화합니다.
    • Primary Role에는 이 에이전트가 가장 우선적으로 해야 할 일을 한 줄로 요약합니다.
  • Supervisor / Owner (담당자)
    • Workspace Agent
      • 상위 에이전트(위키/온보딩 설계 역할)와 이 에이전트를 관리하는 사람을 명시합니다.
    • Personal Assistant Agent
      • 이 에이전트가 보조하는 임직원을 담당자로 명시합니다.
    • Escalation 경로를 명확히 정의해, 문제가 발생했을 때 누구에게 보고해야 하는지 기록합니다.
  • Data / Access Scope
    • Gmail, Drive, Chat 등 각 서비스별로 접근 범위와 제한을 적습니다.
    • 민감 정보와 인증정보에 대한 접근은 헌법 3장 원칙을 따라야 합니다.
  • Typical Tasks
    • 이 에이전트가 자주 수행하는 작업들을 예시로 나열합니다.
    • 정기적인 작업(리포트, 크론 등)은 주기까지 함께 적어두면 좋습니다.
  • Boundaries
    • 이 에이전트가 절대 해서는 안 되는 작업을 구체적으로 적습니다.
    • 외부 발송, 승인 없는 크론 생성, 특정 폴더/데이터 접근 제한 등을 포함합니다.

AGENTS.md는 이 에이전트의 “업무 설명서”입니다. IDENTITY.md로 에이전트가 누구인지 정의한 뒤, AGENTS.md에서 이 에이전트가 어떻게 일해야 하는지 구체화합니다.

ai/templates_agents.1771565336.txt.gz · 마지막으로 수정됨: (바깥 편집)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki