Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
14 changes: 2 additions & 12 deletions openhands/usage/agent-canvas/prebuilt/github-pr-review.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -63,32 +63,22 @@
4. Open `MCP Servers`.
5. Select `GitHub` from the MCP library.
6. Paste the GitHub token you created earlier.
7. Save the MCP server configuration.

## Add the GitHub Token as a Secret

Some automations also need the token available as a backend secret, especially when the agent runs GitHub commands or accesses private repositories.

1. Open `Settings`.
2. Open `Secrets`.
3. Click `Add a new Secret`.
4. Set the secret name to `GITHUB_TOKEN`.
5. Paste the GitHub token as the secret value.
6. Save the secret.
7. Make sure the secret-creation toggle is on so Agent Canvas creates the token secret automatically when you save the MCP server configuration.
8. Save the MCP server configuration.

## Start the PR Review Workflow

1. Open `Automate` in the left navigation.
2. Find `Start from a proven workflow`.
3. Choose the GitHub PR review workflow.
4. Agent Canvas opens a new conversation with a prefilled setup prompt.

Check warning on line 74 in openhands/usage/agent-canvas/prebuilt/github-pr-review.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/github-pr-review.mdx#L74

Did you really mean 'prefilled'?
5. Send the prompt as-is, or edit it first if you already know what you want.

After you send the prompt, the agent starts a setup conversation. It uses the preconfigured skills and GitHub access to interview you, clarify the review workflow, and create the automation.

Check warning on line 77 in openhands/usage/agent-canvas/prebuilt/github-pr-review.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/github-pr-review.mdx#L77

Did you really mean 'preconfigured'?

## Customize the Review

You do not need to know every detail before sending the prefilled prompt. The agent will ask follow-up questions to clarify:

Check warning on line 81 in openhands/usage/agent-canvas/prebuilt/github-pr-review.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/github-pr-review.mdx#L81

Did you really mean 'prefilled'?

- The repository owner and name
- Which pull requests to review
Expand All @@ -96,7 +86,7 @@
- Whether the agent should inspect CI results before commenting
- Any files, directories, or checks the reviewer should ignore

You can edit the prefilled prompt before sending it if you want to provide any of those details up front.

Check warning on line 89 in openhands/usage/agent-canvas/prebuilt/github-pr-review.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/github-pr-review.mdx#L89

Did you really mean 'prefilled'?

## Verify the Automation

Expand Down
14 changes: 2 additions & 12 deletions openhands/usage/agent-canvas/prebuilt/github-repo-monitor.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -65,32 +65,22 @@
4. Open `MCP Servers`.
5. Select `GitHub` from the MCP library.
6. Paste the GitHub token you created earlier.
7. Save the MCP server configuration.

## Add the GitHub Token as a Secret

Some automations also need the token available as a backend secret, especially when the agent runs GitHub commands or accesses private repositories.

1. Open `Settings`.
2. Open `Secrets`.
3. Click `Add a new Secret`.
4. Set the secret name to `GITHUB_TOKEN`.
5. Paste the GitHub token as the secret value.
6. Save the secret.
7. Make sure the secret-creation toggle is on so Agent Canvas creates the token secret automatically when you save the MCP server configuration.
8. Save the MCP server configuration.

## Start the Repository Monitor Workflow

1. Open `Automate` in the left navigation.
2. Find `Start from a proven workflow`.
3. Choose the GitHub repository monitor workflow.
4. Agent Canvas opens a new conversation with a prefilled setup prompt.

Check warning on line 76 in openhands/usage/agent-canvas/prebuilt/github-repo-monitor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/github-repo-monitor.mdx#L76

Did you really mean 'prefilled'?
5. Send the prompt as-is, or edit it first if you already know what you want.

After you send the prompt, the agent starts a setup conversation. It uses the preconfigured skills and GitHub access to interview you, clarify the monitoring workflow, and create the automation.

Check warning on line 79 in openhands/usage/agent-canvas/prebuilt/github-repo-monitor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/github-repo-monitor.mdx#L79

Did you really mean 'preconfigured'?

## Customize the Monitor

You do not need to know every detail before sending the prefilled prompt. The agent will ask follow-up questions to clarify:

Check warning on line 83 in openhands/usage/agent-canvas/prebuilt/github-repo-monitor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/github-repo-monitor.mdx#L83

Did you really mean 'prefilled'?

- The repository owner and name
- The events or conditions the monitor should watch
Expand All @@ -98,7 +88,7 @@
- What the agent should do when it finds a match
- Where the agent should report results, such as a GitHub comment or Slack channel

You can edit the prefilled prompt before sending it if you want to provide any of those details up front.

Check warning on line 91 in openhands/usage/agent-canvas/prebuilt/github-repo-monitor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/github-repo-monitor.mdx#L91

Did you really mean 'prefilled'?

For example, you can ask the monitor to watch for failed workflow runs, summarize the failure, and open a pull request when the fix is straightforward.

Expand Down
22 changes: 9 additions & 13 deletions openhands/usage/agent-canvas/prebuilt/slack-channel-monitor.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -90,32 +90,22 @@
5. Select `Slack` from the MCP library.
6. Paste the bot token.
7. Enter your Slack workspace ID.
8. Save the MCP server configuration.

## Add the Slack Bot Token as a Secret

Some automations also need the token available as a backend secret.

1. Open `Settings`.
2. Open `Secrets`.
3. Click `Add a new Secret`.
4. Set the secret name to `SLACK_BOT_TOKEN`.
5. Paste the bot token as the secret value.
6. Save the secret.
8. Make sure the secret-creation toggle is on so Agent Canvas creates the bot token secret automatically when you save the MCP server configuration.
9. Save the MCP server configuration.

## Start the Slack Channel Monitor Workflow

1. Open `Automate` in the left navigation.
2. Find `Start from a proven workflow`.
3. Choose the Slack channel monitor workflow.
4. Agent Canvas opens a new conversation with a prefilled setup prompt.

Check warning on line 101 in openhands/usage/agent-canvas/prebuilt/slack-channel-monitor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/slack-channel-monitor.mdx#L101

Did you really mean 'prefilled'?
5. Send the prompt as-is, or edit it first if you already know what you want.

After you send the prompt, the agent starts a setup conversation. It uses the preconfigured skills and Slack access to interview you, clarify the channel monitor, and create the automation.

Check warning on line 104 in openhands/usage/agent-canvas/prebuilt/slack-channel-monitor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/slack-channel-monitor.mdx#L104

Did you really mean 'preconfigured'?

## Customize the Monitor

You do not need to know every detail before sending the prefilled prompt. The agent will ask follow-up questions to clarify:

Check warning on line 108 in openhands/usage/agent-canvas/prebuilt/slack-channel-monitor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/slack-channel-monitor.mdx#L108

Did you really mean 'prefilled'?

- The Slack channel or channels to monitor
- The message pattern, keyword, or mention that should trigger the agent
Expand All @@ -123,9 +113,15 @@
- Whether the agent should reply in Slack
- Any GitHub repository or external service the agent should use


<Info>
If you want the automation to watch for `@your-bot-name`, tell the agent to watch for Slack bot mentions as well as the trigger phrases you set. That way, it can respond when someone mentions the bot directly, not just when a specific keyword appears.
</Info>

You can edit the prefilled prompt before sending it if you want to provide any of those details up front.

Check warning on line 121 in openhands/usage/agent-canvas/prebuilt/slack-channel-monitor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/agent-canvas/prebuilt/slack-channel-monitor.mdx#L121

Did you really mean 'prefilled'?

For example, you can ask the monitor to watch an alerts channel, summarize new incidents, and create a GitHub issue when a message includes a production error.
For example, you can ask the tell the agent to configure the automation to watch an #alerts channel, summarize new incidents, and create a GitHub issue when a message includes a production error.


## Verify the Automation

Expand Down
Loading