재사용할 Agent 지침 작성
Agent 페이지는 반복해서 사용할 지침, 스킬, 역할과 메모리를 보관합니다. AI 클라이언트가 읽을 수 있는 문서이며, 페이지를 만들었다고 자율 작업자가 실행되거나 모든 외부 AI가 자동으로 지키는 것은 아닙니다.
Product Launch 연습에서는 다음과 같은 지침을 쓸 수 있습니다.
출시 자료를 작성할 때:
- 새 팀원이 이해할 수 있는 쉬운 문장을 씁니다.
- 사실 설명에는 워크스페이스 자료를 인용합니다.
- 해결되지 않은 질문은 만들어 답하지 말고 목록으로 남깁니다.
- Context 수정 제안은 사람이 검토하도록 제출합니다.
Agent 페이지 열기
에이전트는 실험 중인 메뉴이며 기본적으로 숨겨져 있습니다. 메뉴를 보이게 하려면 설정을 열고 내 계정의 실험실에서 Agent 메뉴 표시를 선택합니다. 그러면 지식 아래 컨텍스트 바로 다음에 미리보기 배지가 붙은 에이전트가 나타납니다. 변경은 바로 적용되고 권한은 바뀌지 않으며, 이 브라우저에서 현재 계정에만 저장됩니다.
메뉴를 숨기면 바로가기와 브라우저 Agent 검색이 사라집니다. 내비게이션과 상단 이동 목록의 에이전트 항목, 대시보드 영역의 에이전트 타일, Setup의 AI 규칙 카드가 보이지 않을 뿐입니다. Agent 페이지, 초안, 활성화, 번들과 MCP의 Agent 도구는 그대로 동작합니다. 메뉴가 없어도 다음 방법으로 Agent 페이지를 열 수 있습니다.
/workspaces/<workspace_id>/agent아래 복사한 Agent 문서 링크를 엽니다.- Agent 메뉴 표시를 켠 뒤 검색 → 범위 → 에이전트를 이용합니다.
- 활동에서 Agent 페이지 링크를 따라갑니다.
MCP 클라이언트는 메뉴 설정과 관계없이 도구로 Agent 페이지를 읽습니다.
분류 선택
| 분류 | 담을 내용 |
|---|---|
| 에이전트 가이드 | 공통 작업 규칙과 주의 사항 |
| 페르소나 | 수행할 역할과 의사소통 방식 |
| 스킬 | 출시 브리프 점검 같은 반복 작업 절차 |
| 메모리 | 관련 작업에서 참고할 배경 지식 |
민감 분류와 민감도 설정은 내용 접근과 활성화를 제한합니다. 비밀번호나 서비스 키를 지침 페이지에 적지 마세요.
초안 만들고 활성화하기
- Editor 또는 Owner가 에이전트에서 분류에 맞는 새 Agent 페이지 작업을 선택합니다.
- 제목, 분류, 본문과 사유를 입력합니다. 템플릿은 먼저 읽고 워크스페이스에 맞게 바꿉니다.
- 생성 대화상자에서 초안 생성을 선택합니다. 초안을 저장한 상태는 활성 상태가 아닙니다.
- Owner가 내용을 확인하고 필요한 리뷰를 진행한 뒤 권한이 허용하는 초안 활성화를 사용합니다.
- 본문 보기에서 원하는 활성 버전인지 확인합니다.
제목은 1자 이상 256자 이하여야 하며, 이 범위를 벗어나면 대화상자에 1~256자를 입력하세요.가 표시됩니다. 본문은 frontmatter를 포함해 최대 1,000,000자, 사유는 최대 2,000자까지 입력할 수 있습니다. 더 긴 입력은 줄이지 않고 거부합니다.
일반 워크스페이스 화면의 활성화에는 해당 공간의 Owner 권한이 필요하며 MCP/agent 실행 주체는 할 수 없습니다. 민감한 페이지도 워크스페이스 Owner가 활성화해야 합니다. Editor는 제안을 작성할 수 있어도 활성화 권한은 없을 수 있습니다. 서버 관리자라는 이유만으로 워크스페이스 내용에 접근할 수 있는 것은 아닙니다.
활성 페이지를 수정하면 대기 중인 초안을 만듭니다. 교체 초안을 활성화할 때까지 기존 활성 버전을 사용합니다. 과거 Agent 버전을 복원하면 새 초안이 생기며 즉시 활성 버전을 바꾸지는 않습니다. 활성화와 복원 때에는 저장된 버전을 현재 제한으로 다시 검사합니다. 제한을 넘는 버전은 활성화하거나 복원할 수 없으므로 새 초안을 작성하세요.
히스토리를 열면 최신 50개 버전을 최신순으로 확인할 수 있으며, 더 오래된 버전을 불러오는 작업은 없습니다. 행의 선택으로 해당 버전을 읽고 선택 해제로 활성 버전으로 돌아옵니다. 활성 버전이 없으면 최신 초안으로 돌아옵니다. 변경 내용은 바로 앞 개정과 비교하며, 두 버전 비교에서는 다른 쌍을 고를 수 있습니다. Agent의 이전 버전: v… 표시는 개정 순서를 나타냅니다. 선택해 읽는 내용이 실제 사용 중인지 판단하려면 활성 버전 표시를 확인하세요. 페이지 히스토리 읽기를 참고하세요.
Agent 탐색기에서 변경 확인하기
탐색기의 Agent 페이지 행에는 작은 표시가 붙습니다.
| 표시 | 의미 |
|---|---|
| 속이 빈 원 | 일반: 최근 내용 변경이 없습니다. |
| 채워진 점 | 최근 변경: 72시간 안에 활성화로 페이지 내용이 바뀌었습니다. 활성화만 해당하며, 이전 활성 버전과 내용이 다르거나 처음 활성화할 때만 표시됩니다. 초안을 만들거나 복원하는 일, 제목이나 슬러그만 바꾸는 일은 해당하지 않습니다. |
| 시계 | 리뷰 대기 또는 수정 요청: 페이지의 현재 초안에 활성화 리뷰가 열려 있습니다. Editor와 Owner에게만 보입니다. |
대기 중인 초안이 있다는 것만으로는 시계가 표시되지 않습니다. 행에 마우스를 올리거나 키보드 포커스를 옮기면 제목과 최근 변경 · 3시간 전 같은 상태 줄이 나타납니다. 긴 제목은 말줄임표로 줄여 표시할 수 있으므로 전체 제목은 페이지를 열어 확인하세요. 행 메뉴에도 같은 상태 요약이 표시됩니다.
자주 보는 페이지는 행 메뉴(⋯ 또는 마우스 오른쪽 클릭)에서 내 즐겨찾기에 추가를 선택해 표시할 수 있습니다. 페이지 아이콘에 별이 붙습니다. 즐겨찾기는 이 워크스페이스에서 내 계정에만 보입니다. 별을 없애려면 내 즐겨찾기에서 해제를 선택합니다.
클라이언트가 실제 사용하도록 하기
클라이언트가 Agent 페이지를 명시적으로 읽거나 연동으로 Agent 입력 번들을 요청해야 합니다. 저장하거나 활성화하는 것만으로 모든 프롬프트에 들어가지는 않습니다. 현재 Ask 답변 작성이 모든 Agent 페이지를 자동 적용한다고 가정하지 마세요.
번들은 읽을 수 있는 지침과 요청한 근거를 특정 버전으로 묶은 자료입니다. 입력량 예산과 만료 시간이 있습니다. 번들 탭에서는 그 페이지를 포함하거나 제외한 기록을 볼 수 있습니다.
이 버전의 선택은 규칙을 따릅니다.
- 항상 주입, 기본 주입 정책은 읽을 수 있는 활성 페이지를 포함할 수 있습니다.
- 요청한 분류에 해당하는 페이지가 포함될 수 있습니다.
- 작업 일치 시 정책은 분류·제목·슬러그의 단어와 작업 의도를 비교합니다. 언어 모델이 최적의 스킬을 추론하는 방식은 아닙니다.
- 권한, 비활성 정책, 초안 상태와 입력량 예산에 따라 페이지를 제외할 수 있습니다.
항상 주입은 권한 검사 뒤의 번들 선택 정책입니다. 접근 제한을 무시하거나 외부 클라이언트가 반드시 번들을 사용한다는 뜻은 아닙니다.
번들 요청에는 위의 네 분류만 지정할 수 있습니다. Context 참조와 Library 아티팩트 참조는 각각 최대 128개, 합쳐서 최대 256개입니다. 제한을 넘는 요청은 validation_failed로 실패하며 dtxWiki가 임의로 줄이지 않습니다.
지침이 반영되지 않는 것 같을 때
활성 버전이 맞는지, 클라이언트가 페이지를 읽거나 번들을 만들었는지, 페이지가 제외되었는지 확인합니다. Chats에서 도구 호출을 확인할 수 있습니다. 번들이 만료되었다면 새로 만듭니다. 반환된 자료를 실제 작업에 사용하는 일은 외부 클라이언트의 동작에 달려 있습니다.
에이전트 메뉴가 보이지 않는다면 삭제된 것이 아니라 숨겨진 것입니다. 설정 → 실험실에서 Agent 메뉴 표시를 켜거나 /agent 주소를 직접 여세요.
구현 근거: Agent 화면, 활성화 권한, 번들 선택 규칙, 번들 요청 제한, 실험실 메뉴, 메뉴 표시 조건, 탐색기 표시.