Sign In

5-2.ChatGPT(Codex) 에이전트 팀 GEO 점검 대시보드 만들기

이번 실습에서 할 일

5-1에서 리서치 팀(researcher, analyst, reviewer)을 만들어 GEO 리서치를 맡겼어요. 이번에는 그 팀에 디자이너와 개발자를 한 명씩 더 뽑아서, 리서치 결과를 실제로 쓸 수 있는 도구로 만들고 인터넷에 공개해 봐요.
만들 것: GEO 점검 대시보드
•
사이트 주소(URL)를 넣으면 이런 걸 보여 줘요:
◦
ChatGPT, Perplexity, Google, Claude, 네이버의 검색용 로봇이 사이트에 들어올 수 있는지
◦
AI 검색에 인용되지 못하게 막는 설정이 있는지
◦
그 밖에 공식 안내에 나온 기본 조건을 갖췄는지
•
결과는 항목마다 충족 / 미충족 / 확인 불가로 보여 주고, 고치는 방법과 근거 링크를 함께 보여 줘요.
점수를 매기지 않는 이유
어느 플랫폼도 "GEO 점수" 계산법을 공개하지 않았어요. 점수를 만들면 근거 없는 숫자가 돼요. 이 도구는 "AI 검색에 나올 준비가 됐는지"를 점검하는 도구이고, 노출을 보장하지 않아요.

이번 팀 구성

팀원
하는 일
researcher
점검 기준에 필요한 공식 안내 보충 조사
5-1에서 만든 팀원
analyst
점검 기준표 만들기 (이 도구의 "규칙집")
5-1에서 만든 팀원
designer
화면 디자인 (배치, 색, 말투)
새로 추가
builder
디자인 안과 기준표대로 대시보드 만들기
새로 추가
reviewer
기준표와 근거, 도구와 기준표가 맞는지 검토
5-1에서 만든 팀원 (역할 추가)
메인
순서 진행, 공개한 뒤 실제 사이트로 점검해 보기
여러분이 대화하는 채팅창 AI
실제 회사의 프로젝트 팀과 같아요: 리서치 → 기획 → 디자인 → 개발 → 검수.

전체 흐름

단계
하는 일
남는 것
0
준비: 5-1 결과 확인, Vercel 가입, 플러그인 설치
①
팀원 추가
designer.toml, builder.toml
②
팀에게 도구 만들기 맡기기
criteria.md, design.md, site/
③
화면 확인하고 고칠 점 요청
④
인터넷에 공개
공개 URL
⑤
실제 사이트로 점검해 보기
⑥
결과를 이 페이지 댓글로 올리기

0. 시작 전 준비

1) 5-1 결과 확인
agent-practice 폴더에 지난 번 실습에서 만든 아래 파일이 있어야 해요. 없으면 5-1 페이지를 먼저 마쳐 주세요.
.codex/agents/ 안에 researcher.toml, analyst.toml, reviewer.toml
AGENTS.md
research/research-1-2.md
2) Vercel 가입
•
Vercel(버셀)이란? 내가 만든 웹사이트나 앱을 클릭 몇 번으로 인터넷 주소에 올려 주는(배포) 클라우드 서비스예요. 개인 용도는 무료로 쓸 수 있어요.
1.
https://vercel.com/signup 에서 가입해요. 무료 요금제(Hobby)를 고르면 돼요.
•
Hobby 요금제는 개인적이고 비상업적인 용도로만 쓸 수 있어요. 수업 실습은 괜찮아요. 회사 업무에 계속 쓰려면 유료 요금제가 필요해요.
3) Codex에 Vercel 플러그인 설치
1.
왼쪽 아이콘 줄의 맞춤 설정 → 플러그인 → 검색창에 vercel → Vercel(▲ 로고, Build and deploy apps)의 +를 눌러요. 비슷한 이름의 다른 플러그인이 같이 보이니 ▲ 로고를 확인하세요.
2.
Vercel 계정 연결 화면이 뜨면 로그인하고 허용해요. 우측 ChatGPT > 플러그인 설치완료 확인
•
플러그인 > 설정 클릭하면 아래처럼 확인 가능
다음으로 넘어가기 전 체크
5-1 파일이 모두 있다
Vercel에 가입했고, 플러그인 목록에 Vercel이 설치되어 있다
사용량이 넉넉할 때 시작한다 (이번 실습은 사용량을 많이 써요. 불안하면 실습이니까 하위 모델 사용해도 괜찮아요.)

① 팀원 추가하기

이번 단계 목표: 팀원 파일을 추가하는 것만으로 팀이 커지는 걸 확인해요.
따라하기
1.
앱에서 Codex를 고르고, 왼쪽 agent-practice 아래 5-1에서 쓰던 채팅을 열어요.
2.
아래 프롬프트를 통째로 복사해서 이어서 보내요.
복사할 프롬프트 ① 팀원 추가
리서치 팀에 팀원 2명을 추가하고, 기존 팀원 하나의 역할을 넓히고 싶어.

[새 하위 에이전트 2개] .codex/agents/ 폴더에 TOML 파일로 만들어 줘. 각 파일에 name, description, developer_instructions를 넣어 줘.
- designer.toml: model = "gpt-6-sol", model_reasoning_effort = "medium"
  웹 도구의 화면 디자인 안을 글로 쓴다. 코드는 쓰지 않는다.
  디자인 안에는 화면 배치, 색과 글꼴, 상태별 표시(충족/미충족/확인 불가/참고), 버튼과 안내 문구의 말투, 모바일 화면 처리를 적는다.
  처음 보는 마케터가 설명 없이 쓸 수 있게, 간결하고 읽기 쉬운 화면을 기본으로 한다.
  레퍼런스 사이트나 이미지를 받으면 분위기와 구성만 참고하고, 로고·이미지·문구는 그대로 가져오지 않는다.
- builder.toml: model = "gpt-6.1-sol", model_reasoning_effort = "high"
  디자인 안(design.md)과 점검 기준표(criteria.md)대로 웹 도구를 만든다.
  기준표에 없는 판정, 점수, 효과 주장은 넣지 않는다. 외부 라이브러리는 쓰지 않는다. 배포는 하지 않는다.
  URL을 대신 가져오는 서버 기능을 만들 때는 반드시 아래 안전 규칙을 지킨다.
  · 한 번에 URL 하나, http와 https만 허용
  · 10초 안에 응답이 없으면 중단
  · localhost와 내부망 주소는 거부
  · 가져온 내용은 저장하지 않음
  · 상대 사이트가 막으면(403 등) 오류가 아니라 "확인 불가"로 돌려줌

[reviewer 역할 추가] reviewer.toml의 developer_instructions에 아래 두 가지 검토를 추가해 줘. 읽기 전용 설정은 그대로 둬.
1. 점검 기준표의 각 항목이 근거 출처와 맞는지, 공식 안내와 업계 제안이 구분됐는지
2. 만든 도구가 기준표에 없는 판정, 점수, 효과 주장을 하지 않는지, 안전 규칙을 지키는지

[AGENTS.md] 기존 리서치 순서는 그대로 두고, "점검 도구 만들기 순서"를 새로 추가해 줘.
1) 보충 리서치가 필요한 항목을 정해 researcher에게 맡긴다 (최대 3개)
2) analyst가 점검 기준표를 만든다
3) designer가 디자인 안을 쓴다
4) builder가 도구를 만든다
5) reviewer가 검토하고, 지적 목록을 메인이 research/review-notes-5-2.md에 저장한 뒤 builder가 반영한다
6) 마지막에 에이전트별로 맡은 일, 사용한 모델, 한 일을 표로 알려 준다
배포는 내가 "배포 승인"이라고 말하기 전에는 하지 않는다.

새 팀원 지침에도 기존 작업 규칙 6개를 넣어 줘.
지정한 모델 중 쓸 수 없는 것이 있으면 쓸 수 있는 모델로 바꾸고 알려 줘.
파일을 만들거나 고치기 전에 무엇을 바꿀지 먼저 목록으로 보여 주고 내 확인을 받아.
3.
바꿀 목록이 나오면 확인하고 진행하라고 답해요.
이렇게 보이면 성공
•
.codex/agents/ 안에 팀원 파일이 5개 있어요. (researcher, analyst, reviewer, designer, builder)
•
AGENTS.md에 "점검 도구 만들기 순서"가 추가됐어요.

② 팀에게 점검 도구 맡기기

사용량 주의 (Plus 요금제) 이 단계는 팀원 5명이 30분 넘게 일해서 사용량을 아주 많이 써요. Plus 요금제는 중간에 한도에 걸릴 가능성이 높아요.
•
시작 전에 다른 작업으로 사용량을 쓰지 않은 상태에서 시작하세요.
•
사용량을 아끼려면 시작 전에 입력창 오른쪽 아래의 모델을 확인하세요. GPT-6.1 Sol High를 쓰고 있다면 GPT-6 Sol이나 낮은 추론 수준(Medium)으로 변경하는 방법도 있으니 참고하세요. 팀원들은 파일에 정해 둔 모델을 그대로 쓰기 때문에, 메인 모델만 바꾸면 돼요.
•
한도에 걸리면 처음부터 다시 하지 말고, 다시 채워질 때까지 기다렸다가 같은 채팅에서 "이어서 진행해 줘"라고 하세요.
따라하기
1.
왼쪽 agent-practice에서 새 채팅을 여는 것을 권장해요. 새 팀원과 AGENTS.md는 채팅을 시작할 때 읽히기 때문이에요.
그다음 아래 프롬프트를 보내요. 안전 규칙과 순서는 이미 팀 파일에 있어서 "무엇을 만들지"만 적으면 돼요.
복사할 프롬프트 ② 점검 도구 만들기
AGENTS.md의 "점검 도구 만들기 순서"대로 에이전트 팀으로 GEO 점검 대시보드를 만들어 줘.
재료는 research/research-1-2.md야.

[1. 보충 리서치] research-1-2.md에서 점검 기준을 만들기에 부족한 내용을 공식 문서로 보충해 줘. 결과는 research/research-5-2-gap.md.
아래 후보는 공식 근거를 확인한 것만 판정 항목으로 쓰고, 공식 근거가 없으면 "참고(업계 제안)"로 분류해.
- 검색 노출용 로봇의 robots.txt 허용 여부: OAI-SearchBot(ChatGPT), PerplexityBot, Googlebot, Claude-SearchBot, Yeti(네이버)
- 학습용 로봇(GPTBot, Google-Extended, ClaudeBot): 검색 노출과 별개인지 확인하고, 판정하지 않고 "참고"로만 보여 줄 것
- 페이지의 noindex, nosnippet, max-snippet 설정
- 구조화 데이터(JSON-LD) 유무 (내용이 화면과 맞는지는 사람이 확인하도록 안내)
- robots.txt의 사이트맵 표기
- 네이버 AI 브리핑 관련 공식 안내가 있는지
- llms.txt (공식 안내가 없으면 "참고(업계 제안)")

[2. 점검 기준표] site/criteria.md에 항목마다 정리해 줘.
항목 / 무엇을 확인하나 / 판정 방법(충족·미충족·확인 불가 조건) / 근거 출처와 확인일 / 공식 안내 또는 업계 제안 / 미충족일 때 고치는 방법

[3. 디자인 안] site/design.md

[4. 대시보드] site/ 폴더
- index.html: 화면
- api/check.js: URL을 받아 robots.txt와 페이지 HTML을 대신 가져오는 Vercel 서버 기능
화면에 꼭 들어갈 것:
- URL 입력칸과 점검 버튼
- URL 점검이 안 될 때를 위한 "직접 붙여 넣기"(robots.txt 내용, 페이지 HTML)
- 맨 위 판정 요약(충족 몇 개, 미충족 몇 개). 점수는 만들지 마
- 항목별 결과 카드: 판정, 고치는 방법, 근거 링크
- 하단 안내: "AI 검색 노출을 보장하지 않는 준비 상태 점검입니다. 기준 확인일: {날짜}. 수업 실습용으로 AI가 공개 자료를 정리했습니다."
- 한국어, 모바일에서도 보기 좋게

[5. 검토] reviewer
2.
메인 채팅의 하위 에이전트 활동과 오른쪽 패널에서 팀원들이 차례로 일하는 모습을 봐요. researcher → analyst → designer → builder → reviewer 순서예요.
3.
끝나면 에이전트별 표(맡은 일, 모델, 한 일)를 확인해요.
이렇게 보이면 성공
•
site/criteria.md: 점검 기준표. 열어서 항목마다 근거가 붙어 있는지 보세요.
•
site/design.md: 디자인 안. 여러분이 직접 고칠 수 있는 파일이에요.
•
site/index.html, site/api/check.js: 도구
•
research/review-notes-5-2.md: reviewer의 지적
안 될 때
•
시간이 오래 걸려요 → 팀원 5명이 차례로 일해서 30분 넘게 걸릴 수 있어요(라이언 리허설: 약 34분). 중간에 끊지 말고 기다려요.
•
팀원을 쓰지 않고 혼자 처리해요 → "designer와 builder 에이전트를 하위 에이전트로 띄워서 진행해 줘"라고 이름을 콕 집어 요청해요.
•
사용량 한도 안내가 떠요 → 사용량이 다시 채워질 때까지 기다렸다가, 같은 채팅에서 "이어서 진행해 줘"라고 해요.

③ 화면 확인하기

따라하기
1.
"site/index.html을 브라우저로 열어서 보여 줘"라고 요청해요. 또는 탐색기에서 site/index.html을 더블클릭해 열어요.
•
지금은 URL 점검이 동작하지 않는 게 정상이에요. 인터넷에 공개해야 켜지는 기능이에요.
2.
고칠 점이 있으면 말로 요청해요.
•
색이나 배치를 바꾸고 싶으면: "design.md에서 메인 색을 {색}으로 바꾸고, 대시보드에 반영해 줘"
•
레퍼런스로 바꾸고 싶으면: 마음에 드는 사이트 주소를 적거나 화면 캡처를 첨부하고, "이 레퍼런스의 분위기로 design.md를 고치고 대시보드에 반영해 줘"라고 해요.
◦
우리 회사 사이트를 레퍼런스로 주면 회사 도구처럼 바뀌어요.
◦
레퍼런스는 분위기와 구성만 참고해요. 다른 회사의 로고, 이미지, 문구를 그대로 가져오지 않아요.
•
판정 기준을 바꾸고 싶으면: "criteria.md부터 고치고, 도구에 반영해 줘"
•
도구는 항상 기준표와 디자인 안을 따라가요. 파일을 고치는 게 핵심이에요.

④ 인터넷에 공개하기

공개 전 확인 (공개 주소는 누구나 볼 수 있어요)
회사 내부 자료, 고객 정보, 개인정보가 없다
화면에 근거 없는 점수나 수치가 없다
다른 회사의 로고, 이미지, 문구를 그대로 쓰지 않았다
하단에 "노출을 보장하지 않는 준비 상태 점검" 안내가 있다
따라하기
1.
아래 프롬프트를 보내요.
복사할 프롬프트 ③ 공개 준비
@vercel 로 site 폴더를 공개하려고 해.
수업 친구들이 로그인 없이 볼 수 있도록 정식(production) 배포를 할 거야.
배포하기 전에 프로젝트 이름, 배포할 폴더, 공개 범위를 먼저 보여 줘.
화면이 동작하는 데 필요한 파일만 올리고, criteria.md·design.md 같은 작업 문서와 테스트용 파일은 올리지 마.
내가 "배포 승인"이라고 말하기 전에는 배포하지 마.
2.
보여 준 내용을 확인하고 배포 승인이라고 입력해요.
3.
공개 URL이 나오면 눌러서 열어 봐요.
안 될 때
•
Vercel 로그인 화면이 떠요 → 0단계에서 가입한 계정으로 로그인하고 허용해요.
•
공개 URL을 열면 로그인하라고 나와요 → 미리보기(preview)로 배포된 거예요. "정식(production)으로 다시 배포해 줘"라고 요청해요.
•
배포가 실패해요 → "Vercel 빌드 로그를 읽고 원인을 고쳐 줘"라고 요청해요.
•
준비 단계에서 "권한 오류(403)" 같은 문구가 보여요 → 배포 승인 후 "Production 배포 완료"와 공개 URL이 나오면 괜찮아요.

⑤ 실제 사이트로 점검해 보기

따라하기
1.
메인에게 먼저 시험 점검을 맡겨요.
복사할 프롬프트 ④ 시험 점검
공개한 대시보드에서 URL 점검으로 사이트 3곳을 점검해 봐 줘.
잘 알려진 대형 사이트 1곳, 공공기관 사이트 1곳, 그리고 점검이 막힐 만한 사이트 1곳으로 골라.
결과가 criteria.md 기준대로 나오는지, 막힌 경우 "확인 불가"로 제대로 표시되는지 확인해 줘.
고칠 게 있으면 무엇을 고칠지 먼저 보여 주고, 내가 승인하면 고친 뒤 같은 프로젝트로 다시 배포해 줘.
2.
이제 내가 관리하는 사이트나 관심 브랜드 공식 사이트의 URL을 직접 넣어 점검해요.

⑥ 결과 포스팅하기

포스팅 전 확인
점검한 사이트는 내가 관리하는 사이트이거나 공식 사이트다
캡처에 이름, 이메일, 폴더 경로, 다른 대화 목록이 보이지 않는다 (보이면 가려요)
특정 회사를 깎아내리거나 단정하는 표현이 없다
과제-Project > "[Emerging Trends] 개인 과제(중간고사 대체)" > "2.대시보드 > 웹 배포 실습"
1.
내 대시보드 공개 URL - 예시: https://geo-check-dashboard.vercel.app/
2.
점검 결과 화면 캡처 1장 (점검한 사이트 주소와 판정 결과가 보이게)
내 대시보드: {공개 URL}
점검한 사이트: {사이트 이름}
•
점검 결과 화면 캡처
다른 친구의 대시보드도 열어 보세요. 같은 리서치에서 출발했는데도 디자인과 기준이 조금씩 달라요.

여기까지 수고하셨습니다

지금 agent-practice 폴더에 있어야 하는 것
agent-practice/
├─ AGENTS.md
├─ .codex/agents/  (researcher, analyst, reviewer, designer, builder)
├─ research/
│   ├─ research-1-2.md
│   ├─ research-5-2-gap.md
│   └─ review-notes-5-2.md
└─ site/
    ├─ index.html
    ├─ api/check.js
    ├─ criteria.md
    └─ design.md
Tip
•
기준은 바뀌어요: 플랫폼 안내는 자주 바뀌어요. 몇 달 뒤에는 "criteria.md의 근거를 다시 확인해서 바뀐 게 있으면 고치고 다시 배포해 줘"라고 팀에게 맡기면 돼요. 팀과 기준을 파일로 남겨 둔 덕분이에요.
•
공개를 그만두고 싶으면: Vercel 대시보드에서 프로젝트를 삭제하면 공개 URL이 사라져요.
•
사용량: 한도에 걸리면 다시 채워질 때까지 기다렸다가 같은 채팅에서 "이어서 진행해 줘"라고 해요.
•
본 실습에서는 대시보드의 기능과 성능을 필드에서 사용할 수준으로 다듬는 것은 포함되어 있지 않아요.
•
기능을 대폭 확장하고, 성능을 높이고, 디자인도 고급스럽게 하는 작업(이른바 '깎아 나간다'고 표현)은 개인의 몫입니다.
•
본 실습을 통해서 AI 에이전트 매커니즘을 이해하셨으니, 각자 처음부터 기획하고, 팀을 만들어서 만들고 싶은 것들을 만들어 보시길 바라겠습니다.
👍