문서 사이트에 AI 에이전트 연결하기
Claude Code, Codex, ChatGPT 또는 직접 만든 스크립트를 사용하여 문서 사이트 페이지를 초안 작성, 정리 및 게시하세요. Pro 이상의 플랜, 문서 사이트 권한, 사이트 범위 지정 및 게시 규칙을 확인하고 전체 AI 에이전트 및 API 가이드 링크를 참조하세요.
Claude Code, Codex, Cursor, Claude 또는 ChatGPT와 같은 AI 에이전트는 사용자를 대신하여 문서 사이트를 읽고 쓸 수 있습니다. 기사 초안 작성, 독자 평가가 낮은 페이지 수정, 콘텐츠 공백 해결, 번역 또는 게시 등의 작업을 수행합니다. 이 문서에서는 문서 사이트와 관련된 구체적인 내용을 다룹니다. 토큰, 커넥터, 사용량 및 오류에 대한 설명은 AI 에이전트 및 API에서 확인할 수 있습니다.
시작하기 전에
- AI 에이전트 및 API는 Pro, 비즈니스, 사용자 지정 플랜에서 사용할 수 있으며, Claude 및 ChatGPT용 커넥터가 포함되어 있습니다. 무료 및 Starter 플랜에는 포함되어 있지 않으며, 워크스페이스가 해당 플랜으로 변경되면 토큰과 앱이 작동을 멈춥니다.
- 에이전트는 해당 토큰을 생성하거나 연결한 사람의 역할을 수행합니다. 에이전트는 사이트에서 해당 사용자가 할 수 있는 범위를 넘어서는 작업을 수행할 수 없습니다.
- API 호출에는 크레딧이 소모되지 않습니다. AI를 사용하여 페이지를 번역하거나 사이트 페이지를 생성하는 작업에는 크레딧이 소모되며, 이는 크레딧을 사용할 수 있는 토큰이 있을 때만 가능합니다.
에이전트 연결하기
워크스페이스 메뉴를 열고 AI 에이전트 및 API를 선택하거나, 문서 사이트의 설정 메뉴에서 AI 에이전트 및 API를 선택하세요(해당 사이트의 활동 내역이 열립니다).
- Claude Code, Codex, Cursor 또는 스크립트용 API 토큰: 토큰 → 새 토큰으로 이동한 후 4단계 마법사(용도, 권한, 제한, 검토)를 따르세요. 작성자 또는 게시자와 같은 문서 사이트 사전 설정을 선택하고, 제한 → 문서 사이트에서 사이트를 선택한 다음, 한 번만 표시되는 토큰을 복사하세요. API 토큰 생성을 참조하세요.
- Claude.ai 또는 ChatGPT용 커넥터: 연결된 앱에서 커넥터 URL을 복사하여 해당 앱에 붙여넣고, 로그인한 뒤 사이트와 액세스를 선택하세요. AI 앱 및 에이전트 연결을 참조하세요.
문서 사이트 사전 설정
| 사전 설정 | 화면 설명 | 용도 |
|---|---|---|
| 작성자 | "에이전트가 초안을 작성하고, 사람이 검토 후 게시합니다." | 기사 및 변경 로그 항목 초안 작성, 이미지 업로드 |
| 게시자 | "독자가 보는 내용을 변경할 수 있는 신뢰할 수 있는 자동화." | 게시, 설정 및 사이트 생성을 포함한 문서 사이트의 모든 작업 |
| 고객 지원 어시스턴트 | "게시된 문서에서 답변합니다. 다른 작업은 수행하지 않습니다." | 게시된 공개 페이지만 검색하는 도움말 봇 |
| 읽기 전용 | "조사, 감사 및 번역 확인." | 콘텐츠 읽기 |
| 분석가 | "콘텐츠와 독자 신호를 읽어 수정 사항을 제안합니다." | 콘텐츠 및 인사이트 읽기 |
프로듀서 및 워크스페이스 에이전트는 동영상 추가 및 크레딧 사용 기능을 포함합니다. 모든 권한과 권한 부여 가능 대상에 대한 정보는 에이전트 권한을 확인하세요.
문서 사이트 권한
| 권한 | 허용 작업 |
|---|---|
content:read |
사이트, 페이지, 기사(초안 포함), 수정 내역, 변경 로그 및 사이트 페이지 읽기 |
articles:write |
기사 초안 생성 및 게시되지 않은 기사 편집 |
structure:write |
섹션 생성 및 편집, 페이지 이동, 숨기기 및 이름 변경 |
site-pages:write |
홈, 연락처, 법적 고지 등 사이트 페이지 편집 |
changelog:write |
변경 로그 항목을 초안으로 생성 및 편집 |
media:write |
이미지 업로드 |
site:publish |
게시: 독자가 보는 내용 변경, 라이브 콘텐츠 편집, 페이지 준비 완료 표시 |
insights:read |
검색 공백, 답변되지 않은 질문 및 페이지 피드백 읽기 |
site:configure |
사이트 설정, 모양 및 탐색 변경 |
sites:create |
새 문서 사이트 생성 |
help:read |
게시된 공개 페이지만 검색(고객 지원 어시스턴트용) |
읽기 권한은 모든 멤버에게 열려 있습니다. 쓰기 및 정리 권한은 소유자, 관리자, 편집자 및 콘텐츠 작성자에게 있습니다. 게시 및 사이트 설정 권한은 소유자, 관리자 및 편집자에게 있습니다("소유자, 관리자 및 편집자만 게시 권한을 부여할 수 있습니다."). 사이트 생성 권한은 소유자 및 관리자에게 있습니다.
토큰이 적용되는 사이트
제한 → 문서 사이트에서 모든 사이트("새 사이트를 포함한 이 워크스페이스의 모든 문서 사이트.") 또는 선택된 사이트를 선택하세요. 토큰이나 연결된 앱은 자신이 포함된 사이트만 보고 변경할 수 있습니다. 기사가 범위 밖의 사이트에도 표시되는 경우, "이 기사는 해당 토큰이 변경할 수 없는 사이트에도 표시됩니다."라는 메시지와 함께 변경이 거부됩니다.
라이브 콘텐츠에는 게시 권한이 필요합니다
site:publish 권한이 없으면 에이전트는 독자가 보는 내용을 변경할 수 없습니다. 라이브 상태인 기사를 편집하려고 하면 거부되며("이 콘텐츠는 게시된 사이트에서 라이브 상태이므로 변경하려면 site:publish 권한이 필요합니다."), 에이전트는 대신 검토를 위해 초안을 제출할 수 있습니다. "agent님이 site의 page에 대한 검토를 요청했습니다"라는 알림을 받게 되며, "게시된 내용은 없습니다. 기사를 읽고 준비가 되면 게시하세요."라는 메시지가 표시됩니다.
에이전트가 수행한 모든 변경 사항은 페이지 기록에 "에이전트 name (token)"으로 표시됩니다. 게시 작업은 토큰당 시간당 10회로 제한됩니다. 일시 중지된 사이트는 에이전트에게 읽기 전용으로 표시됩니다: "이 사이트는 일시 중지되었거나 오프라인 상태이며 읽기 전용입니다."
에이전트가 사이트에서 할 수 있는 작업
사이트 목록 확인 및 페이지 트리 읽기, 페이지 검색 및 읽기, Markdown 미리보기, 기사 생성 및 업데이트, 검토를 위한 제출, 섹션 및 페이지 정리, 사이트 페이지 및 변경 로그 편집, 이미지 업로드, 인사이트 읽기 및 공백을 해결된 것으로 표시, 설정, 모양, 탐색 및 리디렉션 변경, 사이트 생성, 페이지 번역, 사이트 페이지 생성, 게시 및 롤백 작업을 수행할 수 있습니다. 각 작업에는 일치하는 권한이 필요합니다.