ซิงค์ฐานความรู้ของคุณ

4. ตั้งค่าการเข้าถึง แล้วเผยแพร่

สำหรับตัวอย่างศูนย์ช่วยเหลือแบบส่วนตัวนี้ ให้เชื่อมต่อการเข้าสู่ระบบของลูกค้าที่ยืนยันตัวตนแล้วก่อน จากนั้นสร้างกลุ่มผู้ชมและบันทึก data.id ที่ส่งกลับมา:

curl --fail-with-body -X POST "$BASE/audiences" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Pro customers","rules":{"match":"all","conditions":[{"trait":"plan","op":"in","value":["pro","business"]}]}}'

แทนที่ AUDIENCE_ID, ARTICLE_ID และ URL สำหรับเข้าสู่ระบบด้านล่าง คำขอแรกจะเปิดให้ศูนย์ช่วยเหลือใช้งานจริง (Live) และจำกัดให้เฉพาะลูกค้า Pro คำขอที่สองจะเผยแพร่บทความ ขั้นตอนเข้าสู่ระบบของแอปคุณต้องแลกเปลี่ยน JWT ของลูกค้าที่ลงนามแล้วกับศูนย์ช่วยเหลือ การตั้งค่า signInUrl เพียงอย่างเดียวไม่ได้ทำให้ใครเข้าสู่ระบบ

curl --fail-with-body -X PATCH "$BASE/help-center" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled":true,"title":"Acme Help Center","audience":"verified","audienceId":"AUDIENCE_ID","signInUrl":"https://app.example.com/login"}'

# Replace ARTICLE_ID and AUDIENCE_ID with the returned data.id values.
curl --fail-with-body -X PATCH "$BASE/articles/ARTICLE_ID" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audienceId":"AUDIENCE_ID","status":"published"}'

ใช้ URL ที่ได้จาก GET /help-center เพื่อทดสอบมุมมองของผู้อ่านที่เข้าสู่ระบบแล้ว และเบราว์เซอร์ที่ยังไม่ได้เข้าสู่ระบบ คีย์ API และ MCP ทำงานในฐานะทีมงานและอ่านเนื้อหาได้ตามขอบเขตสิทธิ์ ผลลัพธ์ที่สำเร็จจึงไม่ได้พิสูจน์ว่าลูกค้าจะมองเห็นบทความนั้น

สำหรับศูนย์ช่วยเหลือแบบสาธารณะ ให้ใช้ audience: "everyone" และ audienceId: null ทั้งในศูนย์ช่วยเหลือและบทความ และตรวจสอบการเข้าถึงของหมวดหมู่ด้วย หากต้องการนำออกเฉพาะกลุ่มที่ระบุชื่อ ให้ส่ง audienceId: null การเข้าถึงแบบเฉพาะผู้ที่ยืนยันตัวตนจะยังคงอยู่จนกว่าคุณจะเปลี่ยน audience อย่างชัดเจน หากไม่ระบุ audienceId ระบบจะคงการกำหนดเดิมไว้ ข้อจำกัดของศูนย์ช่วยเหลือ หมวดหมู่ และบทความต้องสอดคล้องกันทั้งหมด

กฎของกลุ่มที่ระบุชื่อใช้ match: "all" หรือ "any" มีเงื่อนไขได้สูงสุด 10 ข้อ และค่าต้องมีชนิดข้อมูลที่ถูกต้องอย่างเคร่งครัด ตัวดำเนินการ: eq, neq, in, not_in, exists, not_exists, gt, gte, lt, lte การเปรียบเทียบตัวเลขรับค่าเป็นตัวเลข in/not_in รับอาร์เรย์ของค่าสเกลาร์ 1–100 ค่า ส่วน exists/not_exists ไม่ต้องระบุ value แอตทริบิวต์ที่ไม่มีอยู่จะทำให้การเปรียบเทียบไม่ผ่าน ดูการทำงานของกฎ การสืบทอด และการแก้ไขปัญหาการเข้าถึง

5. ทำให้การซิงค์เป็นปัจจุบันอยู่เสมอ

curl --fail-with-body --get "$BASE/articles" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  --data-urlencode "page=1" --data-urlencode "limit=100" \
  --data-urlencode "status=published" \
  --data-urlencode "updatedSince=2026-09-01T00:00:00Z"

# Get the full sanitized HTML and read-only analytics for one article.
curl --fail-with-body "$BASE/articles/ARTICLE_ID" \
  -H "Authorization: Bearer $SONNY_API_KEY"

curl --fail-with-body -X POST "$BASE/media" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  -F "file=@billing.png;type=image/png"

curl --fail-with-body -X PUT "$BASE/articles/reorder" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids":["ARTICLE_ID_1","ARTICLE_ID_2"]}'

ใช้ขั้นตอนเดียวกันผ่าน MCP

1. เชื่อมต่อไคลเอนต์ MCP ของคุณ และเลือกเวิร์กสเปซให้ถูกต้อง ตรวจสอบว่ามี kb:read และ kb:write พร้อมสิทธิ์เข้าถึงช่องทางของคุณ
2. ใช้ ID ช่องทางจากแดชบอร์ด หรือเรียก list_sources หากข้อมูลรับรองของคุณมี conversations:read ด้วย ห้ามใช้ siteId ของวิดเจ็ตแทนเด็ดขาด
3. รันตัวอย่าง 5 รายการแรกด้านล่างตามลำดับ แทนที่ SOURCE_ID ด้วย ID ช่องทางของคุณ และแทนที่ ARTICLE_ID/AUDIENCE_ID ด้วย data.id จากผลลัพธ์ก่อนหน้าแต่ละรายการ แทนที่ URL สำหรับเข้าสู่ระบบและเชื่อมต่อการเข้าสู่ระบบก่อนเผยแพร่
4. ใช้ list_kb_articles เพื่อตรวจสอบการเปลี่ยนแปลง จัดเรียงลำดับหลังจากรวบรวมรายการทั้งหมดแบบไม่กรอง รวมถึงฉบับร่างแล้วเท่านั้น และรีเฟรชรายการหลังการเขียนที่สำเร็จ

แต่ละตัวอย่างแสดงชื่อเครื่องมือและอาร์กิวเมนต์ ฟิลด์ของ upsert ใส่ใน arguments โดยตรง ส่วนเครื่องมืออัปเดตจะใส่ฟิลด์ที่เปลี่ยนไว้ใน updates ข้อมูลเหล่านี้เป็นอินพุตของการเรียกใช้เครื่องมือ ไม่ใช่คำขอ HTTP ไปยังเอนด์พอยต์ MCP

{
  "name": "upsert_kb_category",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "externalId": "billing",
    "name": "Billing",
    "position": 0
  }
}

{
  "name": "upsert_kb_article",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "externalId": "billing-guide",
    "title": "Manage billing",
    "body": "## Find your invoices\n\nOpen **Settings → Billing** in your account.",
    "bodyFormat": "markdown",
    "categoryExternalId": "billing",
    "status": "draft"
  }
}

{
  "name": "create_kb_audience",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "name": "Pro customers",
    "rules": {
      "match": "all",
      "conditions": [
        {
          "trait": "plan",
          "op": "in",
          "value": [
            "pro",
            "business"
          ]
        }
      ]
    }
  }
}

{
  "name": "update_help_center",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "updates": {
      "enabled": true,
      "title": "Acme Help Center",
      "audience": "verified",
      "audienceId": "AUDIENCE_ID",
      "signInUrl": "https://app.example.com/login"
    }
  }
}

{
  "name": "update_kb_article",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "articleId": "ARTICLE_ID",
    "updates": {
      "audience": "verified",
      "audienceId": "AUDIENCE_ID",
      "status": "published"
    }
  }
}

{
  "name": "list_kb_articles",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "page": 1,
    "limit": 100,
    "updatedSince": "2026-09-01T00:00:00Z"
  }
}

{
  "name": "reorder_kb_articles",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "ids": [
      "ARTICLE_ID_1",
      "ARTICLE_ID_2"
    ]
  }
}

{
  "name": "update_kb_audience",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "audienceId": "AUDIENCE_ID",
    "updates": {
      "name": "Paid customers"
    }
  }
}