<head><style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; }p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style></head><body><style>
.chartjs-size-monitor {
display: none !important; height: 0 !important; overflow: hidden !important;
}
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><pre data-pasted="true"><span style="font-family: Arial,Helvetica,sans-serif;">The AWS DevOps Agent integration allows Halo tickets to trigger AI-powered investigations in AWS, whilst also allowing the DevOps Agent to call Halo MCP tools - for example to retrieve knowledge base articles or search assets.
Follow the steps below to set up a connection with Halo.
<strong><span style="font-size: 11pt;">Create an Agent Space in Halo</span></strong>
1. In Halo, go to <strong>Configuration > Integrations > AWS DevOps Agent</strong> and enable the module by clicking the plus icon.
2. Add a new <strong>Agent Space</strong> and give it a name, such as the name of your Agent Space in AWS.
3. In the MCP section, choose the <strong>Agent to log in as</strong>. The DevOps Agent's tool calls will run with this agent's identity and permissions.
<strong><span style="font-size: 11pt;">Fill in the AWS connection form</span></strong></span>
<span style="font-family: Arial,Helvetica,sans-serif;">
In AWS, go to the Communication section of your Agent Space and add the Halo connector. Here you will find a connection form, which you can fill in using the details provided on the Halo setup screen.</span>
<span style="font-family: Arial,Helvetica,sans-serif;">
<table style="height: 160px; width: 42%;"><colgroup><col style="width: 20.9268%;"><col style="width: 59.9402%;"><col style="width: 19.133%;"></colgroup><thead> <tr><th>Field</th> <th>Value</th> <th>Example</th></tr> </thead> <tbody><tr style="height: 30px;"><td>Halo domain</td> <td>The domain you use to access Halo</td> <td style="text-align: center;">example.haloitsm.com</td></tr> <tr style="height: 30px;"><td>Halo port</td> <td>443, unless your self-hosted Halo uses another port</td> <td style="text-align: center;">443</td></tr> <tr><td>MCP Toolset ID</td> <td>The Agent Space's MCP Toolset ID</td> <td style="text-align: center;">
</td></tr> <tr style="height: 30px;"><td>Client ID</td> <td>The Agent Space's Client ID</td> <td>
</td></tr> <tr><td>Client Secret</td> <td>The Agent Space's Client Secret</td> <td>
</td></tr></tbody></table>
If your Halo is self-hosted and isn't reachable from the internet on port 443, create a <a href="https://docs.aws.amazon.com/devopsagent/latest/userguide/configuring-integrations-and-knowledge-connecting-to-privately-hosted-tools.html" target="_blank" rel="noopener noreferrer">private connection</a> to it, with its port in the port ranges, and select it when you connect.
Once the fields have been completed, save the Agent Space in Halo before submitting the connection form.
<strong><span style="font-size: 12pt;">Choose the tools</span></strong>
By default, the toolset includes functions to search knowledge base articles, search assets and add an internal note to a ticket. Adding a note is a write tool, so DevOps Agent runs it only in a chat, after you approve it, and only when <strong>Agent Actions</strong> is turned on for your Agent Space. An investigation that a ticket opens can't add notes. To change the available functions, select <strong>Edit MCP Toolset </strong>on the Halo Agent Space.
<strong>Let Halo tickets open investigations</strong>
1. On the Halo Agent Space, under <strong>Webhook Setup</strong>, paste the webhook URL and secret that AWS shows after you connect. You can also define the payload that Halo should send to the agent here.
2. Go to <strong>Configuration > Tickets ></strong> <strong>Actions</strong> and add an action with the system use <strong>Run AWS DevOps Agent</strong>, then select your Agent Space.
3. Add the action to the Workflows where it should be used.
When the action is used on a ticket, Halo sends the ticket details to your Agent Space to open an investigation. Each request is logged on the Agent Space's <strong>Request Logs</strong> tab.</span></pre></body>
