이 문서에서 하는 것
- 에이전트를 만들고(시스템 프롬프트/예시), 클래스에 배포·공유·포크하는 과정을 내 에이전트 화면 기준으로 정리해.
화면 흐름
- 클래스 선택: 좌측 드롭다운에서 클래스별로 에이전트 목록을 필터링한다.
- 에이전트 목록: 카드에 배지로 상태(활성/종료)와 최근 수정일이 표시된다. 핀/프로젝트 배지로 주요 항목을 고정할 수 있다.
- 생성/편집: “새 에이전트” 버튼으로 system prompt, few-shot, 기본 파라미터(스타일/temperature 등)를 입력한다.
- 버전 관리: 업데이트 시 새 버전으로 저장해 클래스 배포 전 테스트할 수 있다.
- 공유/포크: 클래스에 배포하거나, 학생·강사가 개인화할 수 있도록 포크를 허용한다.
권장 구성
- system prompt: 역할/목표/금지/출력 형식을 명시. 규칙은 우선순위(필수 → 선택)로 정렬.
- few-shot 예시: 1~3개, 짧은 형식 중심. 비용·latency를 고려해 길이를 최소화.
- 기본 옵션: 스타일 프리셋, temperature/top_p, max_tokens를 기본값으로 저장해 세션마다 반복 설정을 줄인다.
비용/지연에 영향 주는 지점
- system prompt 길이 + few-shot 토큰 → baseline 대비 prompt 토큰 증가폭을 Practice에서 기록.
- RAG/도구를 함께 켤 때 컨텍스트가 늘어나므로 top_k, max_chunks를 보수적으로 시작한다.
라이프사이클 체크리스트
- 생성: system prompt 초안 작성 → few-shot 추가(필요 시).
- 테스트: /practice/agents 절차로 baseline과 비교.
- 배포: 클래스에 공유하고, 필요한 경우 사용 제한(편집 권한/포크 허용 여부)을 설정.
- 운영: 품질/비용 로그를 보고 system prompt와 few-shot을 주기적으로 다듬는다.
다음 문서
- /agents/system-prompt (프롬프트 구조)
- /agents/sharing (클래스 배포)
- /agents/forking (개인화 흐름)