Skip to content

[Agent Builder] Split action-policy-authoring from rule-authoring - #8402

Open
charlotte-hoblik wants to merge 6 commits into
mainfrom
charlotte-AB-action-policy-skill-1612
Open

charlotte-hoblik wants to merge 6 commits into
mainfrom
charlotte-AB-action-policy-skill-1612

Conversation

@charlotte-hoblik

@charlotte-hoblik charlotte-hoblik commented Sep 21, 2026 •

Copy link
Copy Markdown
Contributor

Kibana #281663 split action-policy handling out of the rule skill in 9.6, and #298119 then renamed the skills to rule-authoring and action-policy-authoring and removed their experimental-features gating. The skills reference still bundled them under rule-management.

  • Renames the rule skill entry to rule-authoring, with a note that it was previously rule-management. The old anchor still works. In 9.5 the skill also composes action policies and is assigned platform.alerting.manage_action_policy.
  • Adds an action-policy-authoring entry (9.6+ and Serverless).
  • Updates the inline tools list on the built-in tools reference to match.
  • Prerequisites: alerting:v2:enabled (on by default in 9.6, #298343). agentBuilder:experimentalFeatures applies to 9.5 only. In 9.6 and Serverless the skills are only available in Classic or Observability spaces and in Observability projects.
  • Updates the alerting page on creating rules with Agent Builder, now at alerting/esql/rules/ after [Alerting V2] Move the docs to alerting/esql #8516: skill names, requirements, notification setup by version, and the save order. In 9.5 a policy can't be saved until both its rule and workflow exist. In 9.6 only the workflow is required.
  • Points links to the moved alerting/esql/ pages.

Closes https://github.com/elastic/docs-content-internal/issues/1612

Merge after kibana#298119 reaches Serverless production. As of Oct 22 it is on QA but not on production.

@charlotte-hoblik charlotte-hoblik self-assigned this Sep 21, 2026
@charlotte-hoblik
charlotte-hoblik requested a review from a team as a code owner September 21, 2026 06:53
@charlotte-hoblik charlotte-hoblik added documentation Improvements or additions to documentation docs labels Sep 21, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@github-actions

github-actions Bot commented Sep 21, 2026 •

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Sep 21, 2026 •

Copy link
Copy Markdown
Contributor

✅ Elastic Docs Style Checker (Vale)

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale.

@nastasha-solomon nastasha-solomon left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes to the alerting v2 docs look good - thanks!

Kibana #281663 split action-policy handling out of the rule skill in 9.6,
and #298119 renamed the skills to rule-authoring and action-policy-authoring
and dropped the experimental-features gating. Document both skills, keep the
9.5 behaviour (rule-management, which also composes action policies), and
update the inline tools list and the alerting Agent Builder page to match.

- Scope agentBuilder:experimentalFeatures to 9.5 and drop
  alerting:v2:experimentalFeatures as a skill prerequisite.
- Add the 9.6 space and project availability limits.
- Point links at the moved alerting/esql pages.
- Scope the 9.5 save-order rule (policy blocked until rule exists).

Squashes the earlier branch history onto current main.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@charlotte-hoblik
charlotte-hoblik force-pushed the charlotte-AB-action-policy-skill-1612 branch from 06e3993 to cc79ad7 Compare October 22, 2026 10:36
@charlotte-hoblik charlotte-hoblik changed the title [Agent Builder] Split action-policy-management from rule-management [Agent Builder] Split action-policy-authoring from rule-authoring Oct 22, 2026
@charlotte-hoblik
charlotte-hoblik marked this pull request as ready for review October 24, 2026 17:27

This branch was successfully deployed

1 active deployment
docs-preview — 13e70ec6 Deployed Oct 24, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants