AI

@easy-cms/plugin-ai เพิ่มผู้ให้บริการ AI ในหมวด AI ของ Settings → การเชื่อมต่อ: Anthropic (Claude), OpenAI (GPT), Google Gemini และเซิร์ฟเวอร์ใดก็ได้ที่มี API แบบ OpenAI (Ollama, OpenRouter) Easy CMS เรียกผ่าน HTTP จากเซิร์ฟเวอร์ key จึงไม่ไปถึง browser

npm install @easy-cms/plugin-ai

pnpm add @easy-cms/plugin-ai

yarn add @easy-cms/plugin-ai

bun add @easy-cms/plugin-ai

import { aiPlugin } from '@easy-cms/plugin-ai'
 
export default defineConfig({
  // …
  plugins: [aiPlugin()],
})

plugin เพิ่ม collection ai-usage (บันทึกการใช้งาน ไม่แสดงใน admin) ให้สร้าง migration (easy-cms migrate:create ai ดู Migrations)

เชื่อมผู้ให้บริการ

1. Settings → การเชื่อมต่อ → AI แล้วกด เชื่อมบัญชี ที่ผู้ให้บริการ
2. อ่านและยอมรับว่าจะส่งอะไรไปให้ผู้ให้บริการ (ครั้งเดียวต่อผู้ให้บริการ ผู้ที่ยอมรับจะถูกบันทึกในบันทึกการใช้งาน)
3. วาง API key กด ค้นหา Model เพื่อเลือก model (ถ้าว่าง: ใช้ค่าเริ่มต้น) แล้ว บันทึก ตอนเชื่อมต่อจะถาม model หนึ่งคำ การ์ดจะแสดง model และ token ที่ใช้

ถ้ามี key ใน environment ผู้ให้บริการนั้นจะมีการเชื่อมต่อ "Environment" ที่ใช้ model เริ่มต้น การ์ดของแต่ละการเชื่อมต่อแสดง จำนวนคำขอและ token ของเดือนนี้

ฟีเจอร์

ฟีเจอร์ที่ใช้ AI แสดงในกล่อง ฟีเจอร์ AI ด้านบนของหมวด AI แต่ละฟีเจอร์ปิดได้ หรือใช้การเชื่อมต่ออื่นแทน การเชื่อมต่อหลัก (ตัวแรกที่เชื่อมไว้ จนกว่าผู้ดูแลจะเลือก) plugin เพิ่มฟีเจอร์ของตัวเองใน aiFeatures ของ config

aiFeatures: [{ id: 'summary', label: 'สรุป', description: 'เขียนเกริ่นนำของโพสต์', default: true }]

Limit

ผู้ใช้แต่ละคนส่งได้ไม่เกิน 100 คำขอต่อวัน (ตาม timeZone) คำขอที่ 101 จะถูกปฏิเสธ ผู้ดูแลเปลี่ยนตัวเลขได้ในกล่อง ฟีเจอร์ AI และกำหนดแยกต่อ role ได้ใน Settings → Roles (ใส่ 0: role นั้นใช้ AI ไม่ได้) ในโค้ด:

aiPlugin({ limits: { perUserPerDay: 50, roles: { editor: 20 } } })

กล่องนี้แสดงจำนวนคำขอและ token ของเดือนนี้ แยกตามผู้ใช้และตามฟีเจอร์ ไม่เก็บ prompt หรือคำตอบ เก็บแค่ใครถาม ฟีเจอร์ การเชื่อมต่อ token และเวลา เป็นเวลา 90 วัน

ในโค้ดของคุณ

ถ้าไม่มี plugin cms.ai เป็น null บนเซิร์ฟเวอร์:

const result = await cms.ai?.generate(
  {
    feature: 'summary', // หนึ่งใน aiFeatures ที่เปิดอยู่
    system: 'You write short, plain excerpts.',
    prompt: `Summarize in one sentence:\n\n${post.text}`,
    images: [{ media: post.cover }], // หรือ { data: base64, mediaType }
    json: { type: 'object', properties: { excerpt: { type: 'string' } } }, // รูปแบบของคำตอบ
    maxTokens: 300, // ค่าเริ่มต้น 1024
  },
  { user, about: { collection: 'posts', id: post.id } }, // นับเข้า limit ของผู้ใช้
)
result.json // { excerpt: '…' } และมี result.text, result.usage, result.connection

ผู้ให้บริการที่ไม่ว่าง (429, 5xx) จะถูกถามซ้ำอีกหนึ่งครั้ง คำขอหนึ่งใช้เวลาได้ไม่เกิน 60 วินาที key ที่ถูกปฏิเสธ (401, 403) จะทำเครื่องหมายที่การเชื่อมต่อ ขึ้นบนแดชบอร์ด และส่ง integration.failed เช่นไปยังการแจ้งเตือน ไม่มี REST endpoint สำหรับ prompt แต่ละฟีเจอร์มี endpoint ของตัวเองที่กำหนด prompt ไว้บนเซิร์ฟเวอร์

ตัวเลือก

ขั้นต่อไป

• การเชื่อมต่อ: การเชื่อมต่อ secret และการยอมรับนโยบาย
• Roles: limit AI ของ role