Add > Guide > Intelligent Assessment, Intelligent Fixes, Policy Pack Summary and restructure AI section > Draft #352

RahulSrivastav14 · 2025-06-23T13:55:47Z

Validating guide: /guardrails-docs/docs/guides/using-guardrails/enable-intelligent-assessment/index.md

Overview Validator Prompt:

Overview Section [PASS]

Criteria	Pass/Fail/Warning	Suggestions
Overview content exists between H1 and `## Prerequisites`	✅
Overview starts with "In this guide, you will:"	✅
Uses second person	✅
Contains at least one hyperlink	✅
Overview is a list or paragraph	✅

Prerequisites Validator Prompt:

Prerequisites Section [PASS]

Criteria	Pass/Fail/Warning	Suggestions
`## Prerequisites` section present	✅
Section comes after overview	✅
Prerequisites are a bulleted list	✅
Simple items do not end with periods	✅
Sentences/fragments end with periods	✅
Only setup/access items included	✅
Uses second person where appropriate	✅

Steps Validator Prompt:

Here is the validation of the steps section for the provided markdown file:

Steps Section [PASS]

Criteria	Pass/Fail/Warning	Location	Suggestions
At least one step section present	✅	-	-
Step headers are H2	✅	-	-
Step headers are sequential	✅	-	-
Step header format	✅	-	-
Step header starts with verb	✅	-	-
Step content is present	✅	-	-
Steps are before Review/Next Steps/Troubleshooting	✅	-	-
No skipped or duplicate step numbers	✅	-	-
Uses second person where appropriate	✅	-	-
Images/callouts are allowed	✅	-	-
Review section is titled exactly '## Review'	❌	-	The document does not contain a Review section. Consider adding one if appropriate.

The steps section follows the required format and passes all validation criteria except for the missing Review section, which is optional. Great job on the step-by-step instructions!

Troubleshooting Validator Prompt:

Here is the validation of the Troubleshooting section in the provided markdown file:

Troubleshooting Section [PASS]

Criteria	Pass/Fail/Warning	Suggestions
`## Troubleshooting` section present	✅
Section is in markdown table format	✅
Last row mentions Further Assistance	✅

The Troubleshooting section passes all the specified criteria. It is present, formatted as a markdown table, and the last row mentions "Further Assistance" as required.

Callout Validator Prompt:

Callout Section [PASS]

Criteria	Pass/Fail/Warning	Location	Suggestions
All callouts use correct format	✅	All callouts	N/A
Only allowed callout types used	✅	All callouts	N/A

github-actions · 2025-06-23T13:55:55Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-23T14:15:35Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-23T18:06:21Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-23T18:18:40Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-23T18:26:52Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-24T03:27:52Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-24T04:36:54Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

…eatures

github-actions · 2025-06-24T17:16:45Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-25T07:28:48Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-25T09:16:27Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-25T09:46:20Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

Copilot

Pull Request Overview

This PR restructures the AI section by introducing dedicated guides for Intelligent Assessment, Intelligent Fixes, and Policy Pack Summary, and updating navigation to include the new AI features.

Add new AI feature guides under docs/guides/using-guardrails/ai/
Update sidebar and main index to surface the AI section
Rename and adjust the MCP install guide to “Install Guardrails MCP”

Reviewed Changes

Copilot reviewed 10 out of 34 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
docs/sidebar.json	Insert placeholder entry for the new AI sidebar
docs/guides/using-guardrails/index.md	Replace “AI Tools” link with new “AI” section link and updated description
docs/guides/using-guardrails/ai/install-mcp/index.md	Rename frontmatter and heading to “Install Guardrails MCP”
docs/guides/using-guardrails/ai/index.md	Add landing page for the AI section
docs/guides/using-guardrails/ai/policy-pack-development/index.md	Add guide for Policy Pack Development with AI tools
docs/guides/using-guardrails/ai/ai-sidebar.json	Define sidebar items for the AI section
docs/guides/using-guardrails/ai/ai-configuration/index.md	Add Turbot AI Configuration guide
docs/guides/using-guardrails/ai/enable-policy-pack-summary/index.md	Add guide for enabling Policy Pack Summary
docs/guides/using-guardrails/ai/enable-intelligent-fixes/index.md	Add guide for enabling Intelligent Fixes
docs/guides/using-guardrails/ai/enable-intelligent-assessment/index.md	Add guide for enabling Intelligent Assessment

Comments suppressed due to low confidence (2)

docs/guides/using-guardrails/ai/ai-configuration/index.md:115

[nitpick] Remove trailing slash in the link for consistency with other guides (use /enable-intelligent-fixes).

- [Enable Intelligent Fixes](/guardrails/docs/guides/using-guardrails/ai/enable-intelligent-fixes/)

docs/guides/using-guardrails/ai/ai-configuration/index.md:116

[nitpick] Remove trailing slash in the link for consistency with other guides (use /enable-policy-pack-summary).

- [Enable Policy Pack Summary](/guardrails/docs/guides/using-guardrails/ai/enable-policy-pack-summary/)

docs/guides/using-guardrails/ai/enable-intelligent-assessment/index.md

docs/guides/using-guardrails/ai/enable-policy-pack-summary/index.md

docs/guides/using-guardrails/ai/enable-intelligent-fixes/index.md

docs/guides/using-guardrails/ai/ai-configuration/index.md

github-actions · 2025-06-27T17:26:22Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-27T17:34:07Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-30T09:33:32Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-30T09:39:37Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-30T10:16:35Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-30T10:31:15Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-30T10:39:04Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-30T11:30:14Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

…for Guardrails'

github-actions · 2025-06-30T12:46:17Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-30T12:58:10Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-30T13:02:07Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

github-actions · 2025-06-30T13:23:29Z

Preview Available 🚀

Commit Author: abhiturbot
Commit Message: Add changelog for te v5.51.8

Preview Link: turbot-com-git-docs-guardrailsadd-ai-assessment-guide-turbot.vercel.app

…Summary and restructure AI section > Draft (#352) Co-authored-by: raj <[email protected]> Co-authored-by: Sumit Popat <[email protected]> Co-authored-by: David Boeke <[email protected]>

Add > Guide > intelligent Assessment > Draft

2b17fbb

RahulSrivastav14 requested a review from rajlearner17 June 23, 2025 13:55

RahulSrivastav14 self-assigned this Jun 23, 2025

Updates

172a70f

Update > Images and Sidebar

1b07ef3

Update sidebar

48a7a22

Update using guardrails section

1ecd269

Updates to satisfy more informational need

5878050

Updates to separate the sidebar and landing page

56ad65c

rajlearner17 linked an issue Jun 24, 2025 that may be closed by this pull request

Add guide - Add Intelligent Assessment Feature #350

Closed

rajlearner17 changed the title ~~Add > Guide > intelligent Assessment > Draft~~ Add > Guide > Intelligent Assessment > Draft Jun 24, 2025

Updates and refactored the AI segment to consolidate all AI related f…

0cac0f7

…eatures

Updates

cf51d09

rajlearner17 assigned rajlearner17 and unassigned RahulSrivastav14 Jun 25, 2025

rajlearner17 changed the title ~~Add > Guide > Intelligent Assessment > Draft~~ Add > Guide > Intelligent Assessment, Intelligent Fixes, Policy Pack Summary and restructure AI section > Draft Jun 25, 2025

Updates

76ccab2

Updates

7d0faf8

rajlearner17 marked this pull request as ready for review June 25, 2025 09:46

rajlearner17 requested a review from Copilot June 27, 2025 17:16

Copilot AI reviewed Jun 27, 2025

View reviewed changes

Tidyup - copilot review

b605aa7

Tidy up

57b71a1

Tidy up and update Turbot AI Configuration

4eb4e79

Tidy up Policy Pack Development with AI Tools

32a623a

Tidy up Enable Intelligent Assessment

b76d387

Tidy up formats and content

333fe3f

Tidy up Enable Policy Pack Summary

17a223d

reorganize sidebar for ai and developers sections

a913bf7

Update sidebar and guides to include links to 'Developing guardrails …

1f87b14

…for Guardrails'

Updates

c628a7b

Update landing page

20f5a29

Updates and tidyup

5f3bae8

rajlearner17 merged commit 9971ef4 into main Jun 30, 2025
4 checks passed

rajlearner17 deleted the add-ai-assessment-guide branch June 30, 2025 13:30

Add > Guide > Intelligent Assessment, Intelligent Fixes, Policy Pack Summary and restructure AI section > Draft #352

Add > Guide > Intelligent Assessment, Intelligent Fixes, Policy Pack Summary and restructure AI section > Draft #352

Uh oh!

Conversation

RahulSrivastav14 commented Jun 23, 2025 • edited by rajlearner17 Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Overview Validator Prompt:

Prerequisites Validator Prompt:

Steps Validator Prompt:

Troubleshooting Validator Prompt:

Callout Validator Prompt:

Uh oh!

github-actions bot commented Jun 23, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 23, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 23, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 23, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 23, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 24, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 24, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 24, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 25, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 25, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 25, 2025

Preview Available 🚀

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Jun 27, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 27, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 30, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 30, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 30, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 30, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 30, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 30, 2025

Preview Available 🚀

Uh oh!

github-actions bot commented Jun 30, 2025

Preview Available 🚀

RahulSrivastav14 commented Jun 23, 2025 •

edited by rajlearner17

Loading