Check why an article is unavailable to AI
An article must pass several checks before Sidekick or Sherpa can use it. The preparation state is only one of those checks.
Check the article
- Confirm that the intended revision is published.
- Check the Staff AI or Customer AI flag for the intended assistant.
- Check that Exclude from all AI is off.
- Confirm that the reader is allowed to use the article's audience.
- Check the preparation state beside the article.
- For Sherpa, check the configured source folders, tags, products and languages.
- For imported content, check for a Freshdesk source-policy hold or expired policy verification.
Understand preparation
Pending or Processing means preparation has not finished. Ready means the current prepared revision can be considered for retrieval. Not included means the current policy does not include the article. Revoked means its previous prepared content must no longer be used. A failure needs attention in Operations > Jobs.
Ready does not promise that every answer will cite the article. The question must still match its content and the caller's permissions.
Retry a failure
Open the failed job and read the error. Restore the unavailable scanner or model service before retrying. Check storage capacity too. Repeatedly retrying an unchanged service failure will not fix the cause.
Test the result
Use a question the article actually answers. Review the answer and citations. If the evidence is insufficient, improve the content or use a human response. Do not turn on Customer AI for a staff-only article to make a test pass.