본문으로 건너뛰기

재사용할 Agent 지침 작성

Agent 페이지는 반복해서 사용할 지침, 스킬, 역할과 메모리를 보관합니다. AI 클라이언트가 읽을 수 있는 문서이며, 페이지를 만들었다고 자율 작업자가 실행되거나 모든 외부 AI가 자동으로 지키는 것은 아닙니다.

Product Launch 연습에서는 다음과 같은 지침을 쓸 수 있습니다.

출시 자료를 작성할 때:
- 새 팀원이 이해할 수 있는 쉬운 문장을 씁니다.
- 사실 설명에는 워크스페이스 자료를 인용합니다.
- 해결되지 않은 질문은 만들어 답하지 말고 목록으로 남깁니다.
- Context 수정 제안은 사람이 검토하도록 제출합니다.

분류 선택​

분류담을 내용
에이전트 가이드공통 작업 규칙과 주의 사항
페르소나수행할 역할과 의사소통 방식
스킬출시 브리프 점검 같은 반복 작업 절차
메모리관련 작업에서 참고할 배경 지식

민감 분류와 민감도 설정은 내용 접근과 활성화를 제한합니다. 비밀번호나 서비스 키를 지침 페이지에 적지 마세요.

초안 만들고 활성화하기​

  1. Editor 또는 Owner가 에이전트에서 분류에 맞는 새 Agent 페이지 작업을 선택합니다.
  2. 제목, 분류, 본문과 이유를 입력합니다. 템플릿은 먼저 읽고 워크스페이스에 맞게 바꿉니다.
  3. 생성 대화상자에서 초안 생성을 선택합니다. 초안을 저장한 상태는 활성 상태가 아닙니다.
  4. Owner가 내용을 확인하고 필요한 리뷰를 진행한 뒤 권한이 허용하는 초안 활성화를 사용합니다.
  5. 본문 보기에서 원하는 활성 버전인지 확인합니다.

일반 워크스페이스 화면의 활성화에는 해당 공간의 Owner 권한이 필요하며 MCP/agent 실행 주체는 할 수 없습니다. 민감한 페이지도 워크스페이스 Owner가 활성화해야 합니다. Editor는 제안을 작성할 수 있어도 활성화 권한은 없을 수 있습니다. 서버 관리자라는 이유만으로 워크스페이스 내용에 접근할 수 있는 것은 아닙니다.

활성 페이지를 수정하면 대기 중인 초안을 만듭니다. 교체 초안을 활성화할 때까지 기존 활성 버전을 사용합니다. 과거 Agent 버전을 복원하면 새 초안이 생기며 즉시 활성 버전을 바꾸지는 않습니다.

클라이언트가 실제 사용하도록 하기​

클라이언트가 Agent 페이지를 명시적으로 읽거나 연동으로 Agent 입력 번들을 요청해야 합니다. 저장하거나 활성화하는 것만으로 모든 프롬프트에 들어가지는 않습니다. 현재 Ask 답변 작성이 모든 Agent 페이지를 자동 적용한다고 가정하지 마세요.

번들은 읽을 수 있는 지침과 요청한 근거를 특정 버전으로 묶은 자료입니다. 입력량 예산과 만료 시간이 있습니다. 번들 탭에서는 그 페이지를 포함하거나 제외한 기록을 볼 수 있습니다.

이 버전의 선택은 규칙을 따릅니다.

  • 항상, 기본 활성 정책은 읽을 수 있는 활성 페이지를 포함할 수 있습니다.
  • 요청한 분류에 해당하는 페이지가 포함될 수 있습니다.
  • 작업 일치는 분류·제목·슬러그의 단어와 작업 의도를 비교합니다. 언어 모델이 최적의 스킬을 추론하는 방식은 아닙니다.
  • 권한, 비활성 정책, 초안 상태와 입력량 예산에 따라 페이지를 제외할 수 있습니다.

항상은 권한 검사 뒤의 번들 선택 정책입니다. 접근 제한을 무시하거나 외부 클라이언트가 반드시 번들을 사용한다는 뜻은 아닙니다.

지침이 반영되지 않는 것 같을 때​

활성 버전이 맞는지, 클라이언트가 페이지를 읽거나 번들을 만들었는지, 페이지가 제외되었는지 확인합니다. Chats에서 도구 호출을 확인할 수 있습니다. 번들이 만료되었다면 새로 만듭니다. 반환된 자료를 실제 작업에 사용하는 일은 외부 클라이언트의 동작에 달려 있습니다.

다음: MCP 연결, 리뷰.

구현 근거: Agent 화면, 활성화 권한, 번들 선택 규칙.