Skip to content

Update Agent Builder docs with new features #35318

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ambertunnell merged 5 commits into from
Mar 17, 2026
Merged

Update Agent Builder docs with new features #35318

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
e995dd8
Update Agent Builder docs with new features
ambertunnell Mar 16, 2026
750e2a8
Apply suggestion from @iadjivon
ambertunnell Mar 17, 2026
e18c202
Apply suggestion from @iadjivon
ambertunnell Mar 17, 2026
86b9197
Apply suggestion from @iadjivon
ambertunnell Mar 17, 2026
0c20047
Update _index.md
ambertunnell Mar 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion config/_default/menus/main.en.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2670,7 +2670,7 @@ menu:
parent: case_management
identifier: case_management_troubleshooting
weight: 7
- name: Agents
- name: Agent Builder
url: actions/agents/
pre: robot-wui
identifier: agents
Comment on lines 2674 to 2676
Copy link
Contributor

@iadjivon iadjivon Mar 17, 2026

Choose a reason for hiding this comment

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

Should the url also read: actions/agent-builder/ and the identifier be agent-builder

Copy link
Contributor Author

@ambertunnell ambertunnell Mar 17, 2026

Choose a reason for hiding this comment

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

Right now, it's like this in the actual product. The url is agents and the name of the page is Agent Builder. I think it's fine to keep it aligned.

Expand Down
26 changes: 19 additions & 7 deletions content/en/actions/agents/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Agents
title: Agent Builder
description: Build custom AI agents that can access the Action Catalog.
disable_toc: false
further_reading:
Expand All @@ -12,7 +12,7 @@
---

{{< callout url="https://www.datadoghq.com/product-preview/agent-builder/" btn_hidden="false" header="Join the Preview!" >}}
Agents are in Preview. Click <b>Request Access</b> and fill in the Datadog Product Preview Program form.
Agent Builder is in Preview. Click <b>Request Access</b> and fill in the Datadog Product Preview Program form.

Check warning on line 15 in content/en/actions/agents/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.words_case_insensitive 

Use 'Datadog' or 'Datadog service' instead of 'Datadog Product'.
{{< /callout >}}

## Overview
Expand Down Expand Up @@ -59,7 +59,13 @@

## Customize your agent

When configuring your agent, you have the following options for customization.
When configuring your agent, you have the following options for customization.

### Automation

Set up your agent to run automatically with a [schedule][13], or trigger it from a Datadog [monitor][14], [incident][15], or [security signal][16]. These automations use [Workflow Automation][9].

**Note**: If a [monitor][14] triggers the workflow, update the monitor's configuration to trigger the workflow upon alert, warning, or recovery.

### Instructions

Expand Down Expand Up @@ -89,9 +95,9 @@

### Model

By default, new custom agents run on the latest GPT model.
By default, new custom agents run on Claude Sonnet.

To change your agent's model, click **Auto** in the chatbox to open a dropdown menu and choose another model. You can compare these models using [OpenAI's comparison tool][6] and [Anthropic's models comparison][5].
To change your agent's model, click the model name in the chatbox to open a dropdown menu and choose another model. You can compare these models using [OpenAI's comparison tool][6] and [Anthropic's models comparison][5].

### Self Improve

Expand All @@ -105,7 +111,9 @@

### MCP Server

Click the toggle button to enable the [Datadog MCP Server][8]. MCP servers use the Model Context Protocol to provide additional tools and capabilities that the agent can use to interact with external systems.
In the **MCP Servers** section, the [Datadog MCP Server][8] is enabled by default. You can also connect third-party MCP servers. MCP servers use the Model Context Protocol to provide additional tools and capabilities that the agent can use to interact with external systems.

Third-party MCP servers use OAuth for authentication, allowing your agent to integrate with popular tools such as Atlassian, Notion, GitHub, PagerDuty, Asana, and Linear.

## Add an agent action

Expand Down Expand Up @@ -151,4 +159,8 @@
[9]: https://app.datadoghq.com/workflow
[10]: https://app.datadoghq.com/app-builder/apps/list
[11]: /actions/workflows/build/#wait-until-condition
[12]: /actions/workflows/build/#retries
[12]: /actions/workflows/build/#retries
[13]: /actions/workflows/trigger/#scheduled-triggers
[14]: /actions/workflows/trigger/#monitor-triggers
[15]: /actions/workflows/trigger/#incident-triggers
[16]: /actions/workflows/trigger/#security-triggers
Loading