프롬프트에서 게시까지: AI 코딩 에이전트로 Payload 블로그 자동화하기

블로그 글을 게시하는 일은 제품 변경 사항을 출시하는 일과 같아야 합니다. 아이디어가 초안이 되고, 초안이 구조화된 콘텐츠가 되고, 콘텐츠에 이미지가 더해지고, 실제 페이지가 확인됩니다. 시간이 오래 걸리는 부분은 대개 문단 하나를 쓰는 일이 아닙니다. 그 주변에 있는 자잘한 인수인계입니다.

이 글은 그 작업 흐름을 기록한 것입니다. 목표는 간단했습니다. AI 코딩 에이전트로 Payload CMS 게시를 자동화하는 완성된 블로그 글을 만들고, 품질 좋은 생성 이미지를 넣고, 운영 블로그에 게시한 다음, 최종 페이지가 웹사이트에 표시되는지 확인하는 것이었습니다.

해야 할 일

이 요청에는 거창한 콘텐츠 전략이 필요하지 않았습니다. 필요한 것은 운영 환경에 게시하기까지의 깔끔한 경로였습니다.

작업 흐름이 명확하면 AI 코딩 에이전트는 이 경로를 잘 처리할 수 있습니다. Markdown 초안을 작성하고, 필수 프런트매터를 검증하고, 이미지 파일을 준비하고, 승인된 게시 명령을 실행하고, JSON 결과를 살펴본 뒤, 공개 URL을 열어 실제로 보이는지 확인할 수 있습니다.

마지막 단계가 중요합니다. 저장소에 생성된 파일이 있다고 해서 블로그가 게시된 것은 아닙니다. 이미지가 없는 데이터베이스 행도 완성된 경험이 아닙니다. 명령이 성공했더라도 실제 페이지를 확인하지 않았다면 아직 절반만 끝난 셈입니다.

자동화 작업 흐름

게시 작업은 다섯 부분으로 이루어졌습니다.

먼저 에이전트는 고정된 슬러그, 게시 시각, 요약, 카테고리 목록, SEO 제목과 설명이 포함된 Markdown 글을 만들었습니다. Markdown은 읽기 쉽고, 변경 사항을 비교할 수 있으며, 빠르게 고치기 쉬워 글 작성에 적합합니다.

다음으로 에이전트는 SVG 대신 비트맵 이미지를 준비했습니다. 자동화에 관한 블로그이므로 이미지는 편집 기사의 사진처럼 느껴져야 했습니다. 잘 정돈된 작업 공간, 화면 속 코드와 CMS 구조, 단지 생성한 글이 아니라 디자인한 글처럼 보이게 할 만큼의 시각적 질감이 필요했습니다.

세 번째로 Markdown을 Payload의 리치 텍스트 문서 모델로 변환했습니다. Payload는 블로그 콘텐츠를 구조화된 Lexical 데이터로 저장하므로, 게시 스크립트는 사람이 읽기 좋은 초안과 웹사이트가 요구하는 정확한 CMS 형식 사이를 이어 줍니다.

네 번째로 승인된 운영 환경 게시 명령을 통해 콘텐츠를 기록했습니다. 그러면 작업 경로가 좁고 확인 가능하게 유지됩니다. 데이터베이스를 수동으로 수정하거나, 관리 화면을 무작정 클릭하거나, 나중에 유지보수 담당자가 역으로 파악해야 하는 별도 기록 경로를 만들 필요가 없습니다.

다섯 번째로 게시 후 실제 블로그 페이지를 확인했습니다. 확인은 게시 작업의 일부이지, 나중에 덧붙이는 있으면 좋은 단계가 아닙니다.

여기에 Payload가 잘 맞는 이유

Payload는 콘텐츠 모델이 명확해 에이전트가 게시하기에 적합합니다. 글에는 제목, 슬러그, 요약, 상태, 로케일, 작성자, 카테고리, 이미지 관계, SEO 필드가 있습니다. 에이전트는 무엇이든 기록하기 전에 이 필드들을 검토할 수 있습니다.

이 구조는 모호한 지시를 반복 가능한 작업으로 바꿉니다. "블로그를 만들어 줘" 대신 "유효한 글 문서를 만들고, 유효한 이미지를 첨부하고, 상태를 published로 지정해 게시한 뒤 경로를 확인해 줘"가 됩니다.

또한 유용한 안전 경계가 만들어집니다. 에이전트가 데이터베이스 구조를 새로 만들어낼 필요가 없습니다. 기존 컬렉션 계약을 읽고, CMS가 이미 이해하는 필드를 제공하며, 나머지는 Payload가 적용하게 합니다.

에이전트가 실제로 한 일

에이전트는 게시 요구 사항에서 시작해 블로그 초안을 Markdown으로 생성했습니다. 운영 환경에 적합한 슬러그를 만들고, 미리보기에 맞게 요약을 짧게 유지하고, 글의 목적에 맞는 카테고리를 추가했습니다.

다음으로 대표 이미지를 래스터 파일로 준비했습니다. 이미지를 Payload 미디어에 업로드해 글에서 대표 이미지와 SEO 이미지로 직접 참조할 수 있게 했습니다.

그다음 시험 실행을 했습니다. 시험 실행은 중요한 예행연습입니다. 운영 환경에 기록하기 전에 프런트매터를 파싱할 수 있고, Markdown을 Lexical 콘텐츠로 바꿀 수 있으며, 글의 구조가 준비됐다는 것을 입증합니다.

에이전트는 그 후에야 글을 게시했습니다. 결과물은 단순한 로컬 파일이 아니라 완성된 CMS 항목입니다.

유용한 부분

진짜 가치는 AI 에이전트가 블로그 글을 쓸 수 있다는 데 있지 않습니다. 문단은 누구나 생성할 수 있습니다.

유용한 점은 에이전트가 초안, 이미지 파일, 스키마를 고려한 변환, 운영 환경 기록, 실제 페이지 확인까지 게시 과정 전체를 처리할 수 있다는 것입니다. 덕분에 콘텐츠 작업을 느슨하게 하지 않으면서 더 빠르게 진행할 수 있습니다. Markdown이 남으므로 검토할 수 있습니다. 하나의 명령으로 게시하므로 통제할 수 있습니다. 마지막 확인을 이론이 아니라 웹사이트에서 하므로 실용적입니다.

신뢰할 수 있을 만큼 작고, 실제 시간을 아낄 만큼 완결돼 있으며, 다른 엔지니어가 다시 실행할 만큼 명확한 것. 좋은 자동화는 이런 모습입니다.

이 작업 중에 에이전트는 Sno의 AI 메모리와 Scale 방식의 자동화 기법을 사용해 과정을 반복 가능하고, 확인 가능하며, 빠르게 유지했습니다.