Update to Kapa

{
  "description": "Set up a Kapa Zendesk Help Center source so help center articles are ingested. Use when the user wants Kapa to answer from their Zendesk knowledge base.",
  "included_files": [],
  "name": "kapa-setup-zendesk-helpcenter",
  "skill_md_contents": "---\nname: kapa-setup-zendesk-helpcenter\ndescription: Set up a Kapa Zendesk Help Center source so help center articles are ingested. Use when the user wants Kapa to answer from their Zendesk knowledge base.\n---\n\n# Set up Zendesk Help Center\n\nConnects through OAuth, so the user approves it in their browser.\n\n## 1. Create the source\n\n`create_zendesk_helpcenter_source` with `project` and `name`. Keep the id.\n\n## 2. Start the connection\n\n`connect_zendesk_helpcenter` with the source `id` and the user's `subdomain`,\nthe first label of their zendesk.com host. For `https://acme.zendesk.com` that\nis `acme`.\n\nIt returns an `auth_url`. **Open it in the user's browser** and ask them to\napprove it there.\n\n## 3. Wait for the user, then check once\n\nThe approval happens in the browser, so there is nothing to poll. Ask the user\nto tell you when they have approved it, then call\n`check_zendesk_helpcenter_connection` **once**. It answers with the connection,\nor null if they have not finished.\n\n## 4. Configure what it ingests\n\n`configure_zendesk_helpcenter` with `auth_method` set to `oauth`. Without that\nthe grant is never attached and the source has no credential.\n\n`url` is the **API root, not the browser URL**. Take the part before `/hc` and\nappend `/api/v2`, and put the locale in `language_code`. So\n`https://acme.zendesk.com/hc/en-us` becomes `url=https://acme.zendesk.com/api/v2`\nand `language_code=en-us`. Putting the locale in both doubles it in every\ningested link.\n\nAsk which parts of the help center to read. `include_categories` and\n`include_sections` take what the user picks, and leaving both out reads the\nwhole help center.\n\n## Notes\n\nThe grant belongs to whoever approves it, so only that person can configure the\nsource afterwards.\n\nAn \"invalid authorization request, no such client\" error is a Zendesk-side\nconfiguration problem, not something to retry. Tell the user their Zendesk\naccount needs the Kapa OAuth client registered.\n\n## Finish the job\n\nSaving the configuration starts ingestion. There is no separate publish step.\n\nThen call `list_sources` with `project_id` to confirm what the project holds.\n\n## Shared Kapa workflow rules\n\nTools act as the connected user with that user's project permissions. Resolve the intended project and use only authorized data. Do not invent credentials, source IDs, filters, or tool results. Check the available tool schema before passing arguments.\n\nExplain and obtain approval for ingestion and its quota cost before saving a configuration that starts ingestion or calling `start_crawl`; existing explicit approval for that exact action is sufficient. Ask the user to choose source scope and filters. Validate credentials and discover accessible content before saving. Keep credentials out of visible results, logs, and exported artifacts. Use a secure credential input if the host provides one.\n\nFor a web source, preview the exact configuration and inspect the extracted article content before ingestion. Report queued, running, failed, and completed states accurately. If uncertain about Kapa behavior, use `search_kapa_docs` when available.\n"
}