[Workflows] Author workflows with natural language - #7629
Open
natasha-moore-elastic wants to merge 4 commits into
Open
[Workflows] Author workflows with natural language#7629natasha-moore-elastic wants to merge 4 commits into
natasha-moore-elastic wants to merge 4 commits into
Conversation
… language Add a how-to page for creating and editing workflows from a plain-language description, and cross-link it from the YAML editor, setup, authoring techniques, AI-augmented workflows, and Agent Builder pages. Resolves elastic/docs-content-internal#1452 Co-authored-by: Cursor <cursoragent@cursor.com>
Contributor
Elastic Docs AI PR menuCheck the box to run an AI review for this pull request.
Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team. |
Contributor
Elastic Docs Style Checker (Vale)Summary: 2 suggestions found 💡 Suggestions (2): Optional style improvements. Apply when helpful.
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. |
Contributor
nastasha-solomon
approved these changes
Jul 30, 2026
nastasha-solomon
left a comment
nastasha-solomon
left a comment
Member
There was a problem hiding this comment.
thanks for writing this!
| There are three ways to use {{agent-builder}} and workflows together: | ||
|
|
||
| * **Create workflows from Agent Chat** {applies_to}`stack: ga 9.5+` {applies_to}`serverless: ga`: Describe the automation you want in natural language, refine the generated draft, then open **Preview** and select **Save** to create it. Refer to [Create skills and workflows in chat](chat.md#create-skills-and-workflows-directly-from-chat). | ||
| * **Create workflows from Agent Chat** {applies_to}`stack: ga 9.5+` {applies_to}`serverless: ga`: Describe the automation you want in natural language, refine the generated draft, then open **Preview** and select **Save** to create it. Refer to [Create skills and workflows in chat](chat.md#create-skills-and-workflows-directly-from-chat). For natural language authoring inside the **Workflows** app, refer to [Author workflows with natural language](/explore-analyze/workflows/authoring-techniques/use-natural-language.md). |
Member
There was a problem hiding this comment.
I noticed the "Author workflows with natural language" page already mentions the option to create workflows from AB chat, so I'm wondering if it's necessary to include that detail here. Removing it would allow the docs to emphasize the path from the workflow editor, which is the easier, more integrated, and likely better path overall. @tinnytintin10 or @Kiryous your thoughts on this are ofc welcome.
Suggested change
| * **Create workflows from Agent Chat** {applies_to}`stack: ga 9.5+` {applies_to}`serverless: ga`: Describe the automation you want in natural language, refine the generated draft, then open **Preview** and select **Save** to create it. Refer to [Create skills and workflows in chat](chat.md#create-skills-and-workflows-directly-from-chat). For natural language authoring inside the **Workflows** app, refer to [Author workflows with natural language](/explore-analyze/workflows/authoring-techniques/use-natural-language.md). | |
| * **Create workflows from Agent Chat**: Create and edit workflows by describing what you want [in plain language](/explore-analyze/workflows/authoring-techniques/use-natural-language.md). {{kib}} generates and updates the workflow YAML for you, so you can quickly build without memorizing step types or Liquid syntax. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a how-to page for creating and editing workflows in plain language.
Also cross-links the new page from the YAML editor, setup, authoring techniques index, AI-augmented workflows, and Agent Builder pages, and drops an outdated screenshot from the manage workflows page.
Resolves elastic/docs-content-internal#1452
Made with Cursor