(Actions) custom agent builder #32283

OliviaShoup · 2025-10-20T20:00:15Z

What does this PR do? What is the motivation?

This PR creates a new section for custom workflow agents.

Merge readiness:

Ready for merge

github-actions · 2025-10-20T20:04:15Z

Preview links (active after the `build_preview` check completes)

New or renamed files

https://docs-staging.datadoghq.com/olivia.shoup/docs-12345-custom-agent-builder/actions/agents/

ambertunnell · 2025-10-22T02:45:05Z

content/en/actions/agents/_index.md

+
+{{< partial name="whats-next/whats-next.html" >}}
+
+<br>Do you have questions or feedback? Join the **#workflow-custom-agents** channel on the [Datadog Community Slack][4].


This is referencing an internal channel at Datadog and the Community Slack link doesn't work. Let's remove this entire line.

ambertunnell · 2025-10-22T02:45:15Z

content/en/actions/agents/build.md

+
+{{< partial name="whats-next/whats-next.html" >}}
+
+<br>Do you have questions or feedback? Join the **#workflow-custom-agents** channel on the [Datadog Community Slack][8].


This is referencing an internal channel at Datadog and the Community Slack link doesn't work. Let's remove this entire line.

ambertunnell · 2025-10-22T02:48:19Z

content/en/actions/agents/build.md

+
+### MCP Servers
+
+Click the toggle button to enable MCP (Model Context Protocol). MCP servers provide additional tools and capabilities that the agent can use to interact with external systems.


The only MCP available right now is the Datadog MCP. We should link to the docs that explain further what's available via the Datadog MCP: https://docs.datadoghq.com/bits_ai/mcp_server

ambertunnell · 2025-10-22T02:50:10Z

content/en/actions/agents/_index.md

@@ -0,0 +1,38 @@
+---
+title: Agents


The page doesn't include enough content to justify it's existence. Let's combine the two pages and add the "Build an agent" content to this page.

We also need to add a section that explains that you can invoke an agent via a Workflow step.

ambertunnell · 2025-10-22T02:51:02Z

content/en/actions/agents/build.md

+
+Click the toggle button to enable MCP (Model Context Protocol). MCP servers provide additional tools and capabilities that the agent can use to interact with external systems.
+
+### Feature Lab


Let's remove this section for now. That was a temporary thing.

ambertunnell · 2025-10-22T02:54:32Z

static/images/actions/agents/agent-dashboard.png

I've never seen Datadog obfuscate names in screenshots. It makes the screenshot look unprofessional. Any content in the demo account should be fine to show to customers, including Datadog employee names.

config/_default/menus/main.en.yaml

….com:DataDog/documentation into olivia.shoup/docs-12345-custom-agent-builder

joepeeples

Added some edit suggestions to consider. Let me know when you're ready for a quick re-review!

joepeeples · 2025-10-28T13:18:03Z

content/en/actions/agents/_index.md

+  text: "What are AI agents and how do they work?"
+---
+
+{{< callout url="https://app.datadoghq.com/actions/agents" btn_hidden="false" header="Join the Preview!" >}}


This link goes to the app, not the Preview signup form, and even the app link 404's for some orgs (like my dogfooding org). I also don't see an Agents form at https://www.datadoghq.com/product-preview. You might need to hold off merging this PR until a form is available to link to.

We now have a live form here for orgs that don't have access: https://app.datadoghq.com/actions/agents

content/en/actions/agents/_index.md

Co-authored-by: Joe Peeples <[email protected]>

….com:DataDog/documentation into olivia.shoup/docs-12345-custom-agent-builder

joepeeples

Approved with a couple small non-blocking comments, thanks!

content/en/actions/agents/_index.md

joepeeples · 2025-11-11T14:57:01Z

content/en/actions/agents/_index.md

+
+You can build custom AI agents to act on your observability data and third-party integrations. Agents can use any action from the [Action Catalog][7] to investigate problems, start remediation, or manage resources.
+
+When building an agent, choose a template to get started. Templates come with pre-filled instructions and relevant tools. Templates are named after their main role, like Security Analyst, Log Analyzer, Incident Responder, or DevOps Assistant. 


Should these be called "blueprints" instead of "templates," for consistency with the screenshot and "Build an agent from a blueprint" section?

content/en/actions/agents/_index.md

Co-authored-by: Joe Peeples <[email protected]>

* Create heading and index page for Agents * Create the page Build Agents * Update intro text for Build Agents * Reorder side nav to match UI * Add intro text for blueprints * Add text for creating an agent * Add text for customizing the agent * Update Slack channel to ai-agents * Add text for main Agents page * Merge two pages for Agents into one * Replace screenshot * Cut mention of Slack channel * Add link to MCP docs * Create section for adding agents to workflows/apps * Cut Feature Lab section * fix (?) broken links - remove from Further Reading - revise to relative in-page header links - remove URL slug from list of references at bottom * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update preview link & screenshots * Update agent configuration for new UI * Fix a typo * Cut step * Change sign-up link * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Update content/en/actions/agents/_index.md Co-authored-by: Joe Peeples <[email protected]> * Replace "template" with "blueprint" --------- Co-authored-by: Joe Peeples <[email protected]>

OliviaShoup added 9 commits October 16, 2025 15:19

Create heading and index page for Agents

2160647

Create the page Build Agents

d0aa2c6

Update intro text for Build Agents

6b936d3

Reorder side nav to match UI

a5d4fe6

Add intro text for blueprints

21e98ef

Add text for creating an agent

603d954

Add text for customizing the agent

f603b8e

Update Slack channel to ai-agents

0491bb2

Add text for main Agents page

87bacf2

OliviaShoup self-assigned this Oct 20, 2025

OliviaShoup added the Do Not Merge Just do not merge this PR :) label Oct 20, 2025

OliviaShoup requested a review from a team as a code owner October 20, 2025 20:00

github-actions bot added Architecture Everything related to the Doc backend Images Images are added/removed with this PR labels Oct 20, 2025

OliviaShoup changed the title ~~workflow custom agent builder~~ (Actions) workflow custom agent builder Oct 20, 2025

ambertunnell requested changes Oct 22, 2025

View reviewed changes

OliviaShoup added 7 commits October 22, 2025 13:58

Merge branch 'master' into olivia.shoup/docs-12345-custom-agent-builder

7f95717

Merge two pages for Agents into one

9234563

Replace screenshot

1ed9d18

Cut mention of Slack channel

9a9cf71

Add link to MCP docs

29291d3

Create section for adding agents to workflows/apps

933dfd5

Cut Feature Lab section

6b47d6a

OliviaShoup requested a review from ambertunnell October 23, 2025 16:52

OliviaShoup added under_review Sent to someone outside of the docs team for review. and removed Architecture Everything related to the Doc backend Do Not Merge Just do not merge this PR :) Images Images are added/removed with this PR labels Oct 23, 2025

OliviaShoup changed the title ~~(Actions) workflow custom agent builder~~ (Actions) custom agent builder Oct 23, 2025

Merge branch 'olivia.shoup/docs-12345-custom-agent-builder' of github…

ebfe86e

….com:DataDog/documentation into olivia.shoup/docs-12345-custom-agent-builder

joepeeples reviewed Oct 28, 2025

View reviewed changes

OliviaShoup and others added 19 commits October 28, 2025 15:02

Update content/en/actions/agents/_index.md

beefd84

Co-authored-by: Joe Peeples <[email protected]>

Update content/en/actions/agents/_index.md

62f11d8

Co-authored-by: Joe Peeples <[email protected]>

Update content/en/actions/agents/_index.md

370c099

Co-authored-by: Joe Peeples <[email protected]>

Update content/en/actions/agents/_index.md

18066b7

Co-authored-by: Joe Peeples <[email protected]>

Update content/en/actions/agents/_index.md

9affb72

Co-authored-by: Joe Peeples <[email protected]>

Update content/en/actions/agents/_index.md

6437d1d

Co-authored-by: Joe Peeples <[email protected]>

Update content/en/actions/agents/_index.md

1df0779

Co-authored-by: Joe Peeples <[email protected]>

Update content/en/actions/agents/_index.md

996dc44

Co-authored-by: Joe Peeples <[email protected]>

Update content/en/actions/agents/_index.md

4907780

Co-authored-by: Joe Peeples <[email protected]>

Update content/en/actions/agents/_index.md

217fae7

Co-authored-by: Joe Peeples <[email protected]>

Update content/en/actions/agents/_index.md

f7b180f

Co-authored-by: Joe Peeples <[email protected]>

Update preview link & screenshots

84e5a24

Merge branch 'olivia.shoup/docs-12345-custom-agent-builder' of github…

ae296a9

….com:DataDog/documentation into olivia.shoup/docs-12345-custom-agent-builder

Merge branch 'master' into olivia.shoup/docs-12345-custom-agent-builder

30298c4

Update agent configuration for new UI

930c493

Fix a typo

3cc1963

Cut step

5d038a3

Change sign-up link

7883a7f

Merge branch 'master' into olivia.shoup/docs-12345-custom-agent-builder

b0bcddb

joepeeples approved these changes Nov 11, 2025

View reviewed changes

OliviaShoup and others added 3 commits November 11, 2025 10:02

Update content/en/actions/agents/_index.md

dceab2a

Co-authored-by: Joe Peeples <[email protected]>

Update content/en/actions/agents/_index.md

7c522d2

Co-authored-by: Joe Peeples <[email protected]>

Replace "template" with "blueprint"

7f87ceb

ambertunnell approved these changes Nov 11, 2025

View reviewed changes

Merge branch 'master' into olivia.shoup/docs-12345-custom-agent-builder

950a627

OliviaShoup merged commit 3fea54c into master Nov 11, 2025
3 of 4 checks passed

OliviaShoup deleted the olivia.shoup/docs-12345-custom-agent-builder branch November 11, 2025 16:10


		{{< partial name="whats-next/whats-next.html" >}}

		<br>Do you have questions or feedback? Join the #workflow-custom-agents channel on the [Datadog Community Slack][4].


		### MCP Servers

		Click the toggle button to enable MCP (Model Context Protocol). MCP servers provide additional tools and capabilities that the agent can use to interact with external systems.


		Click the toggle button to enable MCP (Model Context Protocol). MCP servers provide additional tools and capabilities that the agent can use to interact with external systems.

		### Feature Lab


		You can build custom AI agents to act on your observability data and third-party integrations. Agents can use any action from the [Action Catalog][7] to investigate problems, start remediation, or manage resources.

		When building an agent, choose a template to get started. Templates come with pre-filled instructions and relevant tools. Templates are named after their main role, like Security Analyst, Log Analyzer, Incident Responder, or DevOps Assistant.

(Actions) custom agent builder #32283

(Actions) custom agent builder #32283

Conversation

OliviaShoup commented Oct 20, 2025

What does this PR do? What is the motivation?

Uh oh!

github-actions bot commented Oct 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Preview links (active after the build_preview check completes)

New or renamed files

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

joepeeples left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

joepeeples left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

github-actions bot commented Oct 20, 2025 •

edited

Loading

Preview links (active after the `build_preview` check completes)