Sinkroniseer jou kennisbasis

4. Stel toegang en publiseer dan

Vir hierdie voorbeeld van 'n privaat sentrum koppel jy eers geverifieerde kliëntaanmelding. Skep die gehoor en stoor sy teruggegewe 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"]}]}}'

Vervang AUDIENCE_ID, ARTICLE_ID en die aanmeld-URL hieronder. Die eerste versoek maak die hulpsentrum Regstreeks en beperk dit tot Pro-kliënte. Die tweede publiseer die artikel. Jou app se aanmeldvloei moet 'n ondertekende kliënt-JWT met die hulpsentrum uitruil; om net signInUrl te stel, meld niemand aan nie.

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

Gebruik die URL wat GET /help-center teruggee om die aangemelde lesersaansig en 'n afgemelde blaaier te toets. API-sleutels en MCP tree as personeel op en kan inhoud binne hul bestekke lees; hul suksesvolle antwoord bewys nie dat 'n kliënt die artikel kan sien nie.

Vir 'n openbare sentrum gebruik jy audience: "everyone" en audienceId: null op die sentrum en artikel, en gaan die kategorie se toegang ook na. Om net 'n benoemde groep te verwyder, stuur audienceId: null; toegang net vir geverifieerdes bly tensy jy audience uitdruklik verander. 'n Weggelate audienceId behou die vorige toewysing. Alle hulpsentrum-, kategorie- en artikelbeperkings moet pas.

Benoemde reëls gebruik match: "all" of "any", tot 10 voorwaardes en streng getikte waardes. Operateurs: eq, neq, in, not_in, exists, not_exists, gt, gte, lt, lte. Numeriese vergelykings neem getalle; in/not_in neem skikkings van 1–100 skalaarwaardes; exists/not_exists laat value weg. Ontbrekende eienskappe misluk vergelykings. Sien reëlgedrag, oorerwing en probleemoplossing vir toegang.

5. Hou die sinkronisering op datum

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

Gebruik dieselfde werkvloei deur MCP

1. Koppel jou MCP-kliënt en kies die regte werkspasie. Bevestig dat dit kb:read en kb:write het, met toegang tot jou kanaal.
2. Gebruik die paneelbord se kanaal-ID, of roep list_sources as jou geloofsbrief ook conversations:read het. Moet nooit die widget se siteId in die plek daarvan gebruik nie.
3. Hardloop die eerste vyf voorbeelde hieronder in volgorde. Vervang SOURCE_ID met jou kanaal-ID, en ARTICLE_ID/AUDIENCE_ID met elke vroeëre resultaat se data.id. Vervang die aanmeld-URL en koppel aanmelding voordat jy publiseer.
4. Gebruik list_kb_articles om veranderinge te hersien. Hardloop net 'n herrangskikking nadat jy die volledige ongefiltreerde lys versamel het, insluitend konsepte. Herlaai jou lyste ná suksesvolle skrywes.

Elke voorbeeld wys die hulpmiddel se naam en sy argumente. Upsert-velde gaan direk in arguments; bywerk-gereedskap sit veranderde velde binne updates. Dit is invoere vir gereedskapoproepe, nie 'n HTTP-versoek na die MCP-eindpunt nie.

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