Skip to content

[Entity Analytics] Update EA skill description and content - #301628

Merged
tcalopes merged 2 commits into
elastic:mainfrom
tcalopes:299068-ab-navigation-actions
Oct 30, 2026
Merged

tcalopes merged 2 commits into
elastic:mainfrom
tcalopes:299068-ab-navigation-actions

Conversation

@tcalopes

@tcalopes tcalopes commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Fixes elastic/kibana#299068 and elastic/kibana#299796: the Entity Analytics AI Agent was enabling users to perform actions directly in chat — enabling/disabling Entity Analytics, clearing all entity data, and changing risk-scoring settings — that were originally designed to only redirect the user to the UI rather than be performed in chat.

When those redirects were implemented, Agent Builder didn't yet have the generic discover_apis / describe_api / execute_api tools. On top of that, the entity-analytics skill's description never mentioned these management actions at all, which is likely why the agent reached for the generic API tools instead of the redirect in the first place.

I don't think it's necessarily incorrect for the agent to perform these actions directly now that it has that capability — but since we're not yet confident how well that performs for our specific actions, I've for now adjusted the skill content to better guide the agent to use the redirect tool, and opened a separate issue to investigate whether it's worth changing the approach for these actions going forward (#301631)

How to test

  1. Start Elasticsearch with EIS enabled (to use Agent Builder)
  2. In Agent Builder chat, ask: "Disable Entity Analytics." / "Clear all entity data." — the agent should offer a redirect link to the management page.
  3. Ask: "Change my risk scoring configuration and trigger a re-score now." — the agent should offer a redirect link to the risk score setting page for changing the configuration
Screenshot 2026-10-29 at 10 02 09 AM
Screenshot 2026-10-29 at 10 02 20 AM

@tcalopes tcalopes self-assigned this Oct 29, 2026
@tcalopes tcalopes added release_note:fix backport:version Backport to applied version labels v9.6.0 Team:Entity Analytics Security Entity Analytics Team labels Oct 29, 2026
@tcalopes
tcalopes marked this pull request as ready for review October 29, 2026 15:43
@tcalopes
tcalopes requested review from a team as code owners October 29, 2026 15:43
@infra-vault-gh-plugin-prod

Copy link
Copy Markdown
Contributor

Pinging @elastic/security-entity-analytics (Team:Entity Analytics)

@tcalopes
tcalopes requested a review from uri-weisman October 29, 2026 15:43
@elastic elastic deleted a comment from infra-vault-gh-plugin-prod Bot Oct 29, 2026
},
],
},
});

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Severity: P3 (Low)

Require a redirect or an API confirmation for the configuration part of this combined request. As written, a response such as “I can't change the configuration, and I don't know how to trigger a re-score” satisfies every criterion without calling any tool or providing a settings link. Unlike the preceding configuration-only example, this example has neither a link requirement nor a tool-call assertion, so it misses regressions where the agent drops the supported configuration workflow while declining the re-score.

Generated by Libra. React with 👍 or 👎 to give feedback on this comment.

@tcalopes

Copy link
Copy Markdown
Contributor Author

@elasticmachine merge upstream

@infra-vault-gh-plugin-prod

Copy link
Copy Markdown
Contributor

💛 Build succeeded, but was flaky

Failed CI Steps

Metrics [docs]

Page load bundle

Size of the bundles that are downloaded on every page load. Target size is below 100kb

id before after diff
kbnUiSharedDeps-srcJs 5.4MB 5.4MB +4.0B
Unknown metric groups

warm start memory

id before after diff
post forced gc heap baseline - 665502018 +665502018
post forced gc heap delta - -2377278 -2377278
post forced gc heap delta standard deviation - 2408434 +2408434
post forced gc heap target - 663124740 +663124740
tail heap delta - -13765956 -13765956
total +1314891958

Test Failures

  • [job] [logs] Scout Lane #3 - stateful-classic / default / local-stateful-classic - Document flyout v2 — alerts page entry - assignees: assigning the current user shows the avatar in the flyout header
  • [job] [logs] Scout Lane #3 - stateful-classic / default / local-stateful-classic - Document flyout v2 — alerts page entry - header status badge: closing with a reason updates the badge to closed
  • [job] [logs] Scout Lane #3 - stateful-classic / default / local-stateful-classic - Document flyout v2 — Take action menu - investigate in timeline — opens Timeline with document
  • [job] [logs] Scout Lane #3 - stateful-classic / default / local-stateful-classic - EQL rule editing with non-blocking query validation errors - saves the rule after confirming the warning when the data source does not exist
  • [job] [logs] Scout Lane #3 - stateful-classic / default / local-stateful-classic - Expandable flyout state sync - should test flyout url sync
  • [job] [logs] Scout Lane #3 - stateful-classic / default / local-stateful-classic - Network flyout v2 - clicking the source.ip value in the alerts table opens the network flyout v2
  • [job] [logs] Scout Lane #3 - stateful-classic / default / local-stateful-classic - Rule flyout v2 - rule name in the alerts table opens the rule flyout v2

cc @tcalopes

@ymao1 ymao1 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Updates LGTM. Just a note that I could not get my agent to produce any actions in the chat related to any EA management actions so not able to verify fully but the skill updates make sense

@tcalopes
tcalopes added this pull request to the merge queue Oct 30, 2026
Merged via the queue into elastic:main with commit 105e6ae Oct 30, 2026
29 checks passed
@tcalopes
tcalopes deleted the 299068-ab-navigation-actions branch October 30, 2026 17:34
@kibanamachine

Copy link
Copy Markdown
Contributor

Starting backport for target branches: 9.6

https://github.com/elastic/kibana/actions/runs/41099989893

@kibanamachine

Copy link
Copy Markdown
Contributor

💚 All backports created successfully

Status Branch Result
✅ 9.6

Note: Successful backport PRs will be merged automatically after passing CI.

Questions ?

Please refer to the Backport tool documentation

kibanamachine added a commit that referenced this pull request Oct 30, 2026
…1628) (#302146)

# Backport

This will backport the following commits from `main` to `9.6`:
- [[Entity Analytics] Update EA skill description and content
(#301628)](#301628)

<!--- Backport version: 12.1.2 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sorenlouv/backport)

<!--BACKPORT
[{"author":{"name":"tcalopes","email":"tatiana.lopes@elastic.co"},"sourceCommit":{"committedDate":"2026-10-30T17:04:51Z","message":"[Entity
Analytics] Update EA skill description and content (#301628)\n\n##
Summary\n\nFixes\n[#299068](https://github.com/elastic/kibana/issues/299068)\nand\n[elastic/kibana#299796](https://github.com/elastic/kibana/issues/299796):\nthe
Entity Analytics AI Agent was enabling users to perform
actions\ndirectly in chat — enabling/disabling Entity Analytics,
clearing all\nentity data, and changing risk-scoring settings — that
were originally\ndesigned to only redirect the user to the UI rather
than be performed in\nchat.\n\nWhen those redirects were implemented,
Agent Builder didn't yet have the\ngeneric `discover_apis` /
`describe_api` / `execute_api` tools. On top\nof that, the
`entity-analytics` skill's `description` never mentioned\nthese
management actions at all, which is likely why the agent reached\nfor
the generic API tools instead of the redirect in the first place.\n\nI
don't think it's necessarily incorrect for the agent to perform
these\nactions directly now that it has that capability — but since
we're not\nyet confident how well that performs for our specific
actions, I've for\nnow adjusted the skill content to better guide the
agent to use the\nredirect tool, and opened a separate issue to
investigate whether it's\nworth changing the approach for these actions
going forward\n(https://github.com/elastic/kibana/issues/301631)\n\n##
How to test\n\n1. Start Elasticsearch with EIS enabled (to use Agent
Builder)\n2. In Agent Builder chat, ask: \"Disable Entity Analytics.\" /
\"Clear all\nentity data.\" — the agent should offer a redirect link to
the management\npage.\n3. Ask: \"Change my risk scoring configuration
and trigger a re-score\nnow.\" — the agent should offer a redirect link
to the risk score setting\npage for changing the configuration\n\n<img
width=\"541\" height=\"491\" alt=\"Screenshot 2026-10-29 at 10 02
09 AM\"\nsrc=\"https://github.com/user-attachments/assets/98af3203-c52a-4992-87db-c724a74d17b7\"\n/>\n\n---\n\n<img
width=\"544\" height=\"622\" alt=\"Screenshot 2026-10-29 at 10 02
20 AM\"\nsrc=\"https://github.com/user-attachments/assets/5452822a-80c1-4c67-a293-daa697569b8c\"\n/>\n\nCo-authored-by:
Elastic Machine
<elasticmachine@users.noreply.github.com>","sha":"105e6ae4a6f7bd18222e7b95f36c2989e60d2f88","branchLabelMapping":{"^v9.7.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:fix","Team:Entity
Analytics","backport:version","v9.6.0","v9.7.0"],"title":"[Entity
Analytics] Update EA skill description and
content","number":301628,"url":"https://github.com/elastic/kibana/pull/301628","mergeCommit":{"message":"[Entity
Analytics] Update EA skill description and content (#301628)\n\n##
Summary\n\nFixes\n[#299068](https://github.com/elastic/kibana/issues/299068)\nand\n[elastic/kibana#299796](https://github.com/elastic/kibana/issues/299796):\nthe
Entity Analytics AI Agent was enabling users to perform
actions\ndirectly in chat — enabling/disabling Entity Analytics,
clearing all\nentity data, and changing risk-scoring settings — that
were originally\ndesigned to only redirect the user to the UI rather
than be performed in\nchat.\n\nWhen those redirects were implemented,
Agent Builder didn't yet have the\ngeneric `discover_apis` /
`describe_api` / `execute_api` tools. On top\nof that, the
`entity-analytics` skill's `description` never mentioned\nthese
management actions at all, which is likely why the agent reached\nfor
the generic API tools instead of the redirect in the first place.\n\nI
don't think it's necessarily incorrect for the agent to perform
these\nactions directly now that it has that capability — but since
we're not\nyet confident how well that performs for our specific
actions, I've for\nnow adjusted the skill content to better guide the
agent to use the\nredirect tool, and opened a separate issue to
investigate whether it's\nworth changing the approach for these actions
going forward\n(https://github.com/elastic/kibana/issues/301631)\n\n##
How to test\n\n1. Start Elasticsearch with EIS enabled (to use Agent
Builder)\n2. In Agent Builder chat, ask: \"Disable Entity Analytics.\" /
\"Clear all\nentity data.\" — the agent should offer a redirect link to
the management\npage.\n3. Ask: \"Change my risk scoring configuration
and trigger a re-score\nnow.\" — the agent should offer a redirect link
to the risk score setting\npage for changing the configuration\n\n<img
width=\"541\" height=\"491\" alt=\"Screenshot 2026-10-29 at 10 02
09 AM\"\nsrc=\"https://github.com/user-attachments/assets/98af3203-c52a-4992-87db-c724a74d17b7\"\n/>\n\n---\n\n<img
width=\"544\" height=\"622\" alt=\"Screenshot 2026-10-29 at 10 02
20 AM\"\nsrc=\"https://github.com/user-attachments/assets/5452822a-80c1-4c67-a293-daa697569b8c\"\n/>\n\nCo-authored-by:
Elastic Machine
<elasticmachine@users.noreply.github.com>","sha":"105e6ae4a6f7bd18222e7b95f36c2989e60d2f88"}},"sourceBranch":"main","suggestedTargetBranches":["9.6"],"targetPullRequestStates":[{"branch":"9.6","label":"v9.6.0","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v9.7.0","branchLabelMappingKey":"^v9.7.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/301628","number":301628,"mergeCommit":{"message":"[Entity
Analytics] Update EA skill description and content (#301628)\n\n##
Summary\n\nFixes\n[#299068](https://github.com/elastic/kibana/issues/299068)\nand\n[elastic/kibana#299796](https://github.com/elastic/kibana/issues/299796):\nthe
Entity Analytics AI Agent was enabling users to perform
actions\ndirectly in chat — enabling/disabling Entity Analytics,
clearing all\nentity data, and changing risk-scoring settings — that
were originally\ndesigned to only redirect the user to the UI rather
than be performed in\nchat.\n\nWhen those redirects were implemented,
Agent Builder didn't yet have the\ngeneric `discover_apis` /
`describe_api` / `execute_api` tools. On top\nof that, the
`entity-analytics` skill's `description` never mentioned\nthese
management actions at all, which is likely why the agent reached\nfor
the generic API tools instead of the redirect in the first place.\n\nI
don't think it's necessarily incorrect for the agent to perform
these\nactions directly now that it has that capability — but since
we're not\nyet confident how well that performs for our specific
actions, I've for\nnow adjusted the skill content to better guide the
agent to use the\nredirect tool, and opened a separate issue to
investigate whether it's\nworth changing the approach for these actions
going forward\n(https://github.com/elastic/kibana/issues/301631)\n\n##
How to test\n\n1. Start Elasticsearch with EIS enabled (to use Agent
Builder)\n2. In Agent Builder chat, ask: \"Disable Entity Analytics.\" /
\"Clear all\nentity data.\" — the agent should offer a redirect link to
the management\npage.\n3. Ask: \"Change my risk scoring configuration
and trigger a re-score\nnow.\" — the agent should offer a redirect link
to the risk score setting\npage for changing the configuration\n\n<img
width=\"541\" height=\"491\" alt=\"Screenshot 2026-10-29 at 10 02
09 AM\"\nsrc=\"https://github.com/user-attachments/assets/98af3203-c52a-4992-87db-c724a74d17b7\"\n/>\n\n---\n\n<img
width=\"544\" height=\"622\" alt=\"Screenshot 2026-10-29 at 10 02
20 AM\"\nsrc=\"https://github.com/user-attachments/assets/5452822a-80c1-4c67-a293-daa697569b8c\"\n/>\n\nCo-authored-by:
Elastic Machine
<elasticmachine@users.noreply.github.com>","sha":"105e6ae4a6f7bd18222e7b95f36c2989e60d2f88"}}]}]
BACKPORT-->

Co-authored-by: tcalopes <tatiana.lopes@elastic.co>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport:version Backport to applied version labels release_note:fix Team:Entity Analytics Security Entity Analytics Team v9.6.0 v9.7.0

Projects

None yet

4 participants