ashbuilds/payload-ai

AI Plugin is a powerful extension for the Payload CMS, integrating advanced AI capabilities to enhance content creation and management.

Payload AI 플러그인 – 개요

무엇인가요: Payload CMS 내부에서 AI 기반 콘텐츠 생성, 편집, 번역, 미디어 생성 기능을 추가하는 플러그인입니다. OpenAI, Anthropic, Google Gemini, MiniMax 등의 대규모 언어 모델(LLM) 서비스와 ElevenLabs, DALL-E 등의 음성/이미지 생성기 등을 텍스트, 리치텍스트, 업로드 필드에서 호출할 수 있습니다.

왜 중요한가요: 콘텐츠 팀은 CMS를 벗어나지 않고도 초안 작성, 교정, 번역, 심지어 이미지나 오디오 생성을 자동화할 수 있어 워크플로우를 빠르고 일관되게 유지할 수 있습니다.

주요 기능 (README에 설명됨)

영역	기능
텍스트 및 리치텍스트 필드	• 작성 – 프롬프트로부터 새로운 콘텐츠 생성 • 교정 (베타) – 기존 글을 다듬기 • 번역 – 자동 언어 변환 • 다시 표현 (베타) – 다른 표현 방식 • 계획 중: 확장, 요약, 간단화
업로드 필드	• 음성 생성 – ElevenLabs 및 OpenAI TTS를 통해 • 이미지 생성 – OpenAI DALL-E 및 GPT-Image-1을 통해
고급 사용자 제어	• 자체 모델 도입 – 지원되는 프로바이더 또는 커스텀 OpenAI 호환 엔드포인트 연결 가능 • 필드 수준 프롬프트 – 각 필드에 맞게 AI 지시사항 맞춤 설정 • 접근 제어 – AI 사용 권한 제한 (예: 관리자만) • 프롬프트 편집기 – 프롬프트 텍스트를 편집할 수 있는 UI • i18n 지원 – 다국어 Payload 설정과 호환 • 커스텀 컴포넌트 – 자신의 React 컴포넌트로 UI 확장
upcoming	문서 분석기, 사실 확인, 자동 워크플로우, 에디터 제안, AI 챗 어시스턴트

설치 및 빠른 시작

# 플러그인 패키지 추가
pnpm add @ai-stack/payloadcms

payload.config.ts에 플러그인 등록:

import { payloadAiPlugin } from '@ai-stack/payloadcms'

export default buildConfig({
  plugins: [
    payloadAiPlugin({
      collections: { [Posts.slug]: true },
      debugging: false,
    })
  ],
})

필드에서 AI 기능 활성화 (예: 리치텍스트 필드) – 제공된 Lexical 에디터 기능을 추가합니다:

import { PayloadAiPluginLexicalEditorFeature } from '@ai-stack/payloadcms'
// 필드 정의 내부
editor: lexicalEditor({
  features: ({ rootFeatures }) => [
    // …기타 기능
    PayloadAiPluginLexicalEditorFeature(),
  ],
})

API 키 제공 – .env 파일 또는 플러그인 설정에 직접 입력. 지원되는 키: OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY, MINIMAX_API_KEY, ELEVENLABS_API_KEY.
서버 재시작 (옵션: payload generate:importmap 실행).

고급 설정 요약

접근 제어 – access.generate 및 access.settings 함수를 정의하여 AI 사용 제한 (예: 관리자만).
참조 이미지 리졸버 – 기존 미디어를 포함한 이미지→텍스트 또는 텍스트→이미지 프롬프트의 경우, resolveReferenceImage 콜백을 제공해야 하며, 이는 권한과 크기 제한을 고려해 저장소에서 이미지 블롭을 안전하게 가져와야 합니다.
멀티테넌트 / 커스텀 미디어 업로드 – 생성된 미디어의 저장 방식을 mediaUpload 함수로 재정의할 수 있습니다.
프롬프트 시딩 – seedPrompts를 사용하면 문서 생성 시 특정 필드(예: SEO 메타 설명)에 대해 자동으로 프롬프트를 생성할 수 있습니다.
커스텀 언어 옵션 – options.enabledLanguages로 AI 기능이 노출할 로케일을 제어할 수 있습니다.

문서 및 지원

데모 영상 – 플러그인 작동 방식을 빠르게 설명하는 (YouTube) 가이드.
완전 가이드 – guide.md는 커스텀 모델 설정, 프롬프트 엔지니어링, 문제 해결 방법을 다룹니다.
커뮤니티 – 도움과 논의를 위해 Payload Discord 채널에 참여하세요.
후원 – 저자는 Buy Me a Coffee를 통해 기부를 수락합니다.

누구에게 적합한가요?

콘텐츠 작성, 번역, 미디어 생성을 가속화하고 싶은 콘텐츠 팀.
자체 통합 레이어를 만들지 않고도 AI 지원이 필요한 개발자 (커스텀 Payload 기반 사이트 개발 중).
다중 테넌트 Payload 설치를 관리하고 각 테넌트별 AI 자격 증명과 엄격한 접근 제어가 필요한 에이전시.

모든 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.