Vumelanisa isisekelo sakho solwazi

4. Setha ukufinyelela, bese ushicilela

Kulesi sibonelo sesikhungo esiyimfihlo, qala uxhume ukungena kwamakhasimende okuqinisekisiwe. Dala izethameli bese ulondoloza u-data.id ozibuyisayo:

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"]}]}}'

Shintsha u-AUDIENCE_ID, ARTICLE_ID, ne-URL yokungena engezansi. Isicelo sokuqala senza isikhungo sosizo sibe ngu-Kuyasebenza futhi sisikhawulele kumakhasimende e-Pro. Esesibili sishicilela i-athikili. Indlela yokungena yohlelo lwakho kumele ishintshanise i-JWT yekhasimende esayiniwe nesikhungo sosizo; ukusetha u-signInUrl kuphela akungenisi muntu.

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"}'

Sebenzisa i-URL ebuyiswa ngu-GET /help-center ukuze uhlole ukubuka komfundi ongenile nesiphequluli esingangenile. Okhiye be-API ne-MCP basebenza njengabasebenzi futhi bangafunda okuqukethwe ngaphakathi kwemikhawulo yabo; impendulo yabo ephumelelayo ayifakazeli ukuthi ikhasimende lingayibona i-athikili.

Esikhungweni somphakathi, sebenzisa u-audience: "everyone" no-audienceId: null esikhungweni nase-athikili, futhi uhlole nokufinyelela kwesigaba. Ukuze ususe iqembu elinegama kuphela, thumela u-audienceId: null; ukufinyelela kwamakhasimende aqinisekisiwe kuphela kuhlala kunjalo ngaphandle uma ushintsha u-audience ngokuqondile. U-audienceId ongekho ugcina isabelo sangaphambili. Yonke imikhawulo yesikhungo sosizo, yesigaba, neye-athikili kumele ifane.

Imithetho enegama isebenzisa u-match: "all" noma "any", imibandela efika ku-10, namanani anezinhlobo eziqinile. Ama-operator: eq, neq, in, not_in, exists, not_exists, gt, gte, lt, lte. Ukuqhathanisa kwezinombolo kuthatha izinombolo; u-in/not_in uthatha ama-array amanani angu-1–100 alula; u-exists/not_exists akadingi u-value. Izici ezingekho ziyehluleka ukuqhathanisa. Bona ukuziphatha kwemithetho, ukudluliselwa, nokuxazulula izinkinga zokufinyelela.

5. Gcina ukuvumelanisa kusesikhathini

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"]}'

Sebenzisa indlela efanayo nge-MCP

1. Xhuma iklayenti lakho le-MCP bese ukhetha indawo yokusebenza efanele. Qinisekisa ukuthi inemikhawulo u-kb:read no-kb:write, nokufinyelela esiteshini sakho.
2. Sebenzisa i-ID yesiteshi evela ku-dashboard, noma ubize u-list_sources uma imininingwane yakho yokungena inayo no-conversations:read. Ungalokothi usebenzise i-siteId ye-widget esikhundleni sayo.
3. Sebenzisa izibonelo ezinhlanu zokuqala ezingezansi ngokulandelana. Shintsha u-SOURCE_ID nge-ID yesiteshi sakho, no-ARTICLE_ID/AUDIENCE_ID ngo-data.id womphumela ngamunye wangaphambili. Shintsha i-URL yokungena futhi uxhume ukungena ngaphambi kokushicilela.
4. Sebenzisa u-list_kb_articles ukuze ubuyekeze izinguquko. Hlela kabusha kuphela ngemva kokuqoqa uhlu oluphelele olungahlungiwe, kuhlanganise nezinhlaka. Vuselela izinhlu zakho ngemva kokubhala okuphumelelayo.

Isibonelo ngasinye sibonisa igama lethuluzi nama-argument alo. Izinkambu ze-upsert ziya ngqo ku-arguments; amathuluzi okubuyekeza afaka izinkambu ezishintshiwe ngaphakathi kuka-updates. Lokhu kungokufakwayo kocingo lwethuluzi, hhayi isicelo se-HTTP esiya ku-endpoint ye-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"
    }
  }
}