Vumelanisa isiseko sakho solwazi

4. Seta ufikelelo, uze upapashe

Kulo mzekelo weziko labucala, qala uqhagamshele ukungena kwabathengi abaqinisekisiweyo. Yenza abaphulaphuli uze ugcine i-data.id ebuyisiweyo:

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

Tshintsha i-AUDIENCE_ID, i-ARTICLE_ID ne-URL yokungena engezantsi. Isicelo sokuqala senza iziko loncedo lisebenze kwaye lilithintele kubathengi bePro. Esesibini sipapasha inqaku. Inkqubo yokungena ye-app yakho kufuneka itshintshiselane nge-JWT yomthengi etyikityiweyo neziko loncedo; ukuseta i-signInUrl kodwa akungenisi mntu.

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 yi-GET /help-center ukuvavanya umboniso womfundi ongeneyo nebrawuza ephumileyo. Izitshixo ze-API ne-MCP zisebenza njengabasebenzi kwaye zingafunda umxholo ngaphakathi kwemida yazo; impendulo yazo ephumeleleyo ayingqini ukuba umthengi angalibona inqaku.

Kwiziko loluntu, sebenzisa audience: "everyone" ne-audienceId: null kwiziko nakwinqaku, uze ujonge nofikelelo lodidi. Ukuze ususe iqela elinegama kuphela, thumela audienceId: null; ufikelelo lwabaqinisekisiweyo kuphela luyahlala ngaphandle kokuba utshintsha i-audience ngokucacileyo. I-audienceId engafakwanga igcina isabelo sangaphambili. Zonke izithintelo zeziko loncedo, zodidi nezenqaku kufuneka zihambelane.

Imithetho enamagama isebenzisa match: "all" okanye "any", ukuya kuthi ga kwiimeko ezili-10, namaxabiso anohlobo olungqongqo. Abaqhubi: eq, neq, in, not_in, exists, not_exists, gt, gte, lt, lte. Uthelekiso lwamanani luthatha amanani; in/not_in zithatha ii-array zamaxabiso ali-1–100; exists/not_exists azifaki value. Iimpawu ezingekhoyo azoneliseki kuthelekiso. Jonga indlela imithetho esebenza ngayo, ilifa nokusombulula iingxaki zofikelelo.

5. Gcina ukuvumelanisa kuhlaziyiwe

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. Qhagamshela umxhasi wakho we-MCP uze ukhethe indawo yokusebenzela echanekileyo. Qinisekisa ukuba ine-kb:read ne-kb:write, nofikelelo kwisitishi sakho.
2. Sebenzisa i-ID yesitishi yedashbhodi, okanye ubize list_sources ukuba iinkcukacha zakho zokungena zine-conversations:read. Ungaze ufake endaweni yayo i-siteId yewijethi.
3. Qhuba imizekelo emihlanu yokuqala engezantsi ngokulandelelana. Tshintsha i-SOURCE_ID nge-ID yesitishi sakho, ne-ARTICLE_ID/AUDIENCE_ID nge-data.id yesiphumo ngasinye sangaphambili. Tshintsha i-URL yokungena uze uqhagamshele ukungena phambi kokupapasha.
4. Sebenzisa i-list_kb_articles ukuphonononga utshintsho. Qhuba ukulandelelanisa kuphela emva kokuqokelela uluhlu olupheleleyo olungahluzwanga, kuquka iidrafti. Hlaziya uluhlu lwakho emva kokubhala okuphumeleleyo.

Umzekelo ngamnye ubonisa igama lesixhobo neengxoxo zaso. Amabala e-upsert angena ngqo kwii-arguments; izixhobo zohlaziyo zibeka amabala atshintshiweyo ngaphakathi kwe-updates. La ngamagalelo okubiza izixhobo, hayi isicelo se-HTTP kwindawo yokugqibela 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"
    }
  }
}