<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><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><style>
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><p><strong>In this guide we will cover:</strong></p><p><a href="#overview"><strong>- Overview</strong></a></p><p><a href="#initial-setup"><strong>- Initial Setup</strong></a></p><p><a href="#the-chat-agent-in-action"><strong>- The Chat Bot In Action</strong></a></p><p><a href="#what-can-the-agent-achieve-return"><strong>- What Can The Agent Achieve & Return?</strong></a></p><p><br></p><p><strong>Related Guides:</strong></p><ul><li style="font-weight: bold;"><a href="https://www.usehalo.com/guides/2783" target="_blank" rel="noopener noreferrer"><strong>AI Agents</strong></a></li><li style="font-weight: bold;"><a href="https://www.usehalo.com/guides/2335" target="_blank" rel="noopener noreferrer"><strong>Chat Bot and Chat Profiles</strong></a></li><li style="font-weight: bold;"><a href="https://www.usehalo.com/guides/1841" target="_blank" rel="noopener noreferrer"><strong>Chat</strong></a></li></ul><p><br></p><p><strong><span style="font-size: 14pt;"><a id="overview" class="fr-anchor" title="overview"></a>Overview</span></strong></p><p>When using the ChatBot, Halo's MCP server can be leveraged by AI Agents in order to evaluate your data and carry out actions within your Halo environment. As an example, this can be useful for obtaining quick data on your team and checking in on your profit and loss figures, or quickly checking off action points without having to leave your current page. </p><p><br></p><p>This chat functionality may be pre-configured in your Halo environment if you were deployed in September 2026 or later. If this is the case for you, then you have only some minor initial setup to be able to use this process, and this will be detailed in this guide. As this functionality utilises the <a href="https://www.usehalo.com/guides/2336" target="_blank" rel="noopener noreferrer">Conversational Agent</a> functionality, you do not need to plug in your own AI connection for it to function, you can use the <a href="https://www.usehalo.com/guides/2385" target="_blank" rel="noopener noreferrer">default Halo connection</a> if you wish to do so. </p><p><br></p><p><strong>If you have an earlier deployment of Halo</strong> <strong>and you would like to set up this functionality, please refer to this guide: <a href="https://www.usehalo.com/guides/2876" target="_blank" rel="noopener noreferrer">Halo MCP AI Agent: Chat Setup Guide</a> for a walkthrough of the full setup.</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 11pt;">How does it work?</span></strong></p><p>Within the "HaloAI Agent" chat profile, there is a singular step to execute a Virtual Agent conversation. When this step is triggered, a pre-configured <a href="https://www.usehalo.com/guides/2783" target="_blank" rel="noopener noreferrer">Operations Agent</a> is prompted to get data or suggest actions relevant to the chat user's request. </p><p><br></p><p>In the event that the chat user requests any information regarding Tickets, the Operations Agent will trigger an additional runbook called "AI Run Report". This allows it to efficiently query the database, using a payload chosen by the Operations Agent, and return accurate Ticketing data to the chat user.</p><p><br></p><p><strong><em>Note: When utilising any MCP functionality in Halo, it is advisable to enable the logs for this by navigating to Configuration > AI > Halo MCP Server and turning on the setting "enable MCP request logging". This will aid with any necessary troubleshooting.</em></strong></p><p><br></p><p><br></p><p><span style="font-size: 14pt;"><strong><a id="initial-setup" class="fr-anchor" title="initial-setup"></a>Initial Setup</strong></span></p><p>The "AI Run Report" runbook uses a <a href="https://www.usehalo.com/guides/2660" target="_blank" rel="noopener noreferrer">custom integration</a>, for which you must configure the connection prior to being able to use the functionality. </p><p><br></p><p>To do this, first create the <a href="https://www.usehalo.com/guides/1823" target="_blank" rel="noopener noreferrer">API application</a> by navigating to Configuration > Integrations > HaloPSA API and selecting the "+ New" button in the top right corner. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg2YTUyMDBlLTgzYjAtNGU5NC04N2UwLTc2MWVjMzU2NzM4ZCJ9.wG_pIDPQNGxfvif7dpcWcMzjOq8oFXvFQQcjSugtkFk" class="fr-fic fr-fil fr-dib" width="880" style="width: 882px; height: 481.747px;" height="482"></p><p><strong><span style="font-size: 10pt;">Fig 1. Creating a new API application</span></strong></p><p><br></p><p>When creating the application, select "Halo Automation Identity" as the authentication method; select an Agent with relevant permissions to log in as (an <a href="https://www.usehalo.com/guides/1670" target="_blank" rel="noopener noreferrer">API only Agent</a> can be used here, or <a href="https://www.usehalo.com/guides/1823" target="_blank" rel="noopener noreferrer">automation identity</a>), and then set the permissions to "all:standard". </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU3YTU4MDg0LTg3NjktNGZkNy04MDljLTA1ZWQ0MzVjZTg5MSJ9.ok1foOsRk345eZRwZQRGzlF5w8boCb2kKwlAfWNuoNw" class="fr-fic fr-fil fr-dib" width="988" style="width: 990px; height: 600.22px;" height="600"></p><p><strong><span style="font-size: 10pt;">Fig 2a. The authentication method for the new application should be 'Halo Automation Identity'</span></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFiZmRiMTA3LWQ2N2QtNDgzYS05MTE2LWZjYzE4MmE4YjQ0YiJ9.r7SJmNdm3OyZmejCKzgDVM0Okocd2DdXKQ__Rowx4y4" class="fr-fic fr-fil fr-dib" width="987" style="width: 989px; height: 507.258px;" height="507"></p><p><strong><span style="font-size: 10pt;">Fig 2b. The permissions for the new application should be 'all:standard'</span></strong></p><p><br></p><p>Once the application has been created, navigate to Configuration > Integrations > Custom Integrations > Custom Integrations and locate "HaloPSA". This is the one being used by the 'AI Run Report' runbook.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFlOTNjZWUwLWY0NzItNDdmZi05ZjZmLTE1YTUwODhhYTQwNCJ9.dWrPT3Phqlu8fnATHlv_LFVxMaPY6sg8RSSV5pkOoX0" class="fr-fic fr-fil fr-dib" width="939" style="width: 941px; height: 609.007px;" height="609"></p><p><strong><span style="font-size: 10pt;">Fig 3. Select the HaloPSA custom integration to apply the new API application</span></strong></p><p><br></p><p>Edit the integration and select your new API application in the "Run-as Application" field before saving. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdmNWQ5NjQ2LWM3YTQtNGJiNC05YjIwLTA2ZDU2ZjgxM2ZiMSJ9.Qclh0jFHWu0o6asgVmFsjz-DU1qyvyABnclK187iUvQ" class="fr-fic fr-fil fr-dib" width="915" style="width: 917px; height: 740.36px;" height="740"></p><p><strong><span style="font-size: 10pt;">Fig 4. Select your new API application as the integration's identity</span></strong></p><p><br></p><p>Your ChatBot functionality is now fully configured.</p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;"><a id="the-chat-agent-in-action" class="fr-anchor" title="the-chat-agent-in-action"></a>The Chat Bot In Action</span></strong></p><p>This Agent ChatBot functionality uses the 'HaloAI Agent' chat profile. </p><p><br></p><p>A 'Chat Profile' dictates the flow that the ChatBot follows during its conversation with the User/Agent. Chat profiles are available to be viewed and edited by administrators only, or by those given <a href="https://www.usehalo.com/guides/2426" target="_blank" rel="noopener noreferrer">access control</a>, and can be found in Configuration > Chat > Chat Profiles. </p><p><br></p><p>For more information on chat profiles and how they work, please do refer to the relevant guide: <a href="https://www.usehalo.com/guides/2335" target="_blank" rel="noopener noreferrer" data-pasted="true">Chat Bot and Chat Profiles</a>.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ3NGZkZDEwLTI4ZmUtNGQ3OS1iYTdlLWIxYmY3YzgyMzRkOCJ9.QOGbiM_TYGj1xI3_3V8wH089RYk6l1gYpxS3lEVXEg8" class="fr-fic fr-fil fr-dib" width="918" style="width: 920px; height: 428.738px;" height="429"></p><p><strong><span style="font-size: 10pt;">Fig 5. The HaloAI Agent chat profile for chats via the agent application</span></strong></p><p><br></p><p>The HaloAI Agent chat profile has one step, and flows immediately into the Virtual Agent conversation.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFjNjYwMTI0LWZkYTEtNGZlYS04Yjc1LWU1NjM3ZTgyZTUxZSJ9.ypRF4tvD_1fi5mo9PNwFOenqbCs1HH29BelOp85uNxw" class="fr-fic fr-fil fr-dib" width="573" style="width: 575px; height: 374.004px;" height="374"></p><p><strong><span style="font-size: 10pt;">Fig 6. The HaloAI Agent Chat Profile</span></strong></p><p><br></p><p>Within this step, the Operations Agent is instructed on how to greet the Chat user and what to say if it fails.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjU1Yjk0ODNhLTUzMGQtNGRkNS1iNjJiLWI1MWQ3ZWQ5Yzg3ZCJ9.TOVUIBW0Xivm4Nc7Sy9OJUBRa4TAwNxf-m1xvU4ScF8" class="fr-fic fr-fil fr-dib" width="794" style="width: 796px; height: 455.16px;" height="455"></p><p><strong><span style="font-size: 10pt;">Fig 7. The virtual agent instructions in the HaloAI Agent chat profile</span></strong></p><p><br></p><p>As shown in Figures 8a and 8b respectively, to start a chat with the ChatBot in the Agent application you can either select the circular chat symbol in the lower right corner of your screen, or you can enter the chat area in your navigation menu and select the "+ HaloMCP (Beta)" button in the top right corner. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3MTBlYjM4LWIyZWYtNGNlZC1iMmU5LTM1NWRiMjJiYWI4OSJ9.cQwQGJ6m54hEHGogrZGogunF8MGs6vwBcv5C_NBtn5c" class="fr-fic fr-fil fr-dib" width="833" style="width: 835px; height: 637.146px;" height="637"></p><p><strong><span style="font-size: 10pt;">Fig 8a. Starting a HaloMCP chat via the floating chat icon</span></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNhZmQ0NDkyLTc4MjMtNDc4Zi1iMjYzLTRkZGEzNzBmODVlMyJ9.1QDC1tYVa1LblL7DAFUqj1HPj7XIoOwdDaVEyBzmDG8" class="fr-fic fr-fil fr-dib" width="960" style="width: 962px; height: 604.403px;" height="604"></p><p><strong><span style="font-size: 10pt;">Fig 8b. Starting a HaloMCP chat via the chat area in Halo</span></strong></p><p><br></p><p>As dictated by the chat profile shown in Figure 7, when you first start a chat, you will be greeted by the ChatBot who will ask how it can help. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4NmE0OTc4LTVjZmMtNDFjZS04NDM3LWVhMzZmMTAzNmVmMiJ9.N-EjnZXV9zrH5fLRz8P5OXttblJJ6TAn7dvAGJVpFX4" class="fr-fic fr-fil fr-dib" width="774" style="width: 776px; height: 530.947px;" height="531"></p><p><strong><span style="font-size: 10pt;">Fig 9. The AI Agent will greet you as soon as you begin the chat with the ChatBot</span></strong></p><p><br></p><p>You can either select one of the two buttons available - "Check my tickets" or "Log a new ticket", or you can type a message of your choice. Once you submit your question or request, an Operations Agent is prompted to return relevant data according to the request. </p><p><br></p><p>As an example, in Figure 10 you can see that I have asked for a list of current open tickets on the service desk. The Operations Agent has returned a table of all the relevant Tickets and their information.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg4NmI2ZTY3LTE0NTgtNDBmOS05YWZiLThhMTA5Njc5YzZmZCJ9.SP0kpZq9YpwOUcKA5CM-XnDYhVl-5pYp7_Tto4knhRU" class="fr-fic fr-fil fr-dib" width="725" style="width: 727px; height: 584.176px;" height="584"></p><p><strong><span style="font-size: 10pt;">Fig 10. Querying the MCP endpoint via the agent ChatBot</span></strong></p><p><br></p><p>In Figure 11, I then tell the Agent to add a note to one of the tickets stating that the issue has now been resolved. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImRmNmMxYTFiLTkxMmQtNDQ4ZS04MzMwLWI1MjIyOTk1OGRkNyJ9.QQBvRTQtBEMTVEVsBXJH9euzar7BxLd-DwFfXktb6_E" class="fr-fic fr-fil fr-dib" width="711" style="width: 713px; height: 571.436px;" height="571"></p><p><span style="font-size: 10pt;"><strong>Fig 11. Instructing the AI Agent to add a note to a ticket</strong></span></p><p><br></p><p>The Operations Agent carried out this task for me using the functions it has access to via the MCP server, demonstrating that I can action my tickets without even having to leave the chat or the page that I am on. Customising an Operations Agent's available tools is covered later in this guide.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI5MTY4YmJkLTFjNDUtNDk0NS1hN2Q2LTdkODk0Nzk0NzNhNyJ9.Fxwd9b0tvpA9TLyrmS-LtRd_mu4qJ1kG8nFvdUSpjvk" class="fr-fic fr-fil fr-dib" width="780" style="width: 782px; height: 672.714px;" height="673"></p><p><strong><span style="font-size: 10pt;">Fig 12. A note added to a Ticket by the AI chat agent</span></strong></p><p><br></p><p>You may wish to view or modify the prompt for the AI Agent. This may be to provide it further context on your company or your processes, or to improve accuracy. You can do this by navigating to Configuration > AI > AI Agents, and selecting the 'Operations Agents' button. This will take you to the Operations Agents area in Halo where you can select the "Halo Agent App Default Operations Agent w/ Advanced Ticket Search" that is being used for this chat profile. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJiYjA3MmJkLWY4MzgtNDRjMC1iNGNkLWE1ZGM3MzEwM2UwNiJ9.tp4CS9ToBcytCO-cCnxXTQZpCET1XaCREujJxlV5Rq0" class="fr-fic fr-fil fr-dib" width="735" style="width: 737px; height: 591.246px;" height="591"></p><p><strong><span style="font-size: 10pt;">Fig 13a. Navigating to the Operations Agents area of Configuration</span></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImYyMmZlNDQxLWYxMDctNDk1Ny04NzYzLThmMmM1YmM0NzUwMiJ9.9GnA_RKStcPqVtsrRhOt2sCHzzKg0vp3k1rDIxuzcmM" class="fr-fic fr-fil fr-dib" width="880" style="width: 882px; height: 366.249px;" height="366"></p><p><strong><span style="font-size: 10pt;">Fig 13b. The Operations Agent being used for the HaloAI Agent chat profile</span></strong></p><p><br></p><p>Within the 'Assistant Fields' section of the Agent, you can view and edit the 'instructions' being fed to the AI model in order to customise your Agent's behaviour.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc1NDIwYmVkLTBjMWMtNDYzOS1hOTQwLWQzOWEwNzFmOWZiOCJ9.49TNJL69d3w4PXCPhStGXU1dYPxZkTld47Vz0xqIvn8" class="fr-fic fr-fil fr-dib" width="793" style="width: 795px; height: 485.474px;" height="485"></p><p><strong><span style="font-size: 10pt;">Fig 14. The instructions/prompt for the ChatBot's AI Agent</span></strong></p><p><br></p><p>For more information on setting up or customising Operations Agents, see the guide on <a href="https://www.usehalo.com/guides/2336" target="_blank" rel="noopener noreferrer">Conversational Agents</a> in Halo.</p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;"><a id="what-can-the-agent-achieve-return" class="fr-anchor" title="what-can-the-agent-achieve-return"></a>What Can The Agent Achieve & Return?</span></strong></p><p>The functions available to the Agent, and the data that it is able to return, are partly dependent on the tools made available to the Agent via the MCP server, and partly dependent on the prompt fed through to OpenAI via the Operations Agent's instructions.</p><p><br></p><p>The pre-configured Chat Agent has all system functions enabled (Figure 15).</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjViOGY5ZWIzLTY3YTEtNDM0ZS05YWQxLTNlMTgzNGZjNDFiYiJ9.Qkc9WXgJzjJVORlHm0ONjVkonl2Ux4FYlbRzLv9D-qs" class="fr-fic fr-fil fr-dib" width="690" style="width: 692px; height: 404.794px;" height="405"></p><p><strong><span style="font-size: 10pt;">Fig 15. Enabling all system functions on an Operations Agent</span></strong></p><p><br></p><p data-pasted="true">The functions available to use when this is checked are listed below the setting.</p><p>In the Functions table beneath this checkbox, you can then also create new functions or, if you have deselected "include all system functions", you can choose the functions available to the Agent. Please do refer to the dedicated guide on <a href="https://www.usehalo.com/guides/3015" target="_blank" rel="noopener noreferrer">Conversational Agent Functions</a> for details on functions for Operations Agents.</p><p><br></p><p><strong><em>Note: You do not need to have the MCP endpoint enabled/exposed to be able to use AI Agents. Although they use the Halo MCP server, they have their own unique endpoint and their own set of available tools/functions. </em></strong></p><p><br></p><p>In terms of retrieving ticketing data, the Agent does not use the ticket search functions provided by the system. Instead, it follows a fixed flow set out in its instructions. First, it checks whether the Data Sources report has already been run earlier in the same chat. If it has, the Agent reuses that result. Otherwise, it runs the Data Sources report and selects the most appropriate data source for the request. Open and closed tickets are handled by choosing a data source that is already scoped to that status, rather than by adding a status filter. Using the chosen data source and the user’s request, the Agent then builds a report payload and runs the “AI Run Report” runbook exactly once. If the report fails, the Agent tells the user about the failure rather than retrying or returning an empty result. </p><p>Results are returned as a formatted card showing the report name, a timestamp, and the record count, with up to 50 records displayed. Performing this function rather than the system improves accuracy of the data returned to the chat by exposing the Agent to a greater number of data sources.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA4NWY0ZmM2LWM3YWUtNDkwYi1hNzBmLWU0NTUzZGU1NjY0MCJ9.BcwewXnd9iw97FbY8_45OZH216JdkiUvSsWdTPitSHA" class="fr-fic fr-fil fr-dib" width="791" style="width: 793px; height: 610.772px;" height="611"></p><p><strong><span style="font-size: 10pt;">Fig 16. Instructions to the Operations Agent</span></strong></p><p><br></p><p>As mentioned in the previous section, you can change these instructions if you wish to, including changing the JSON used to construct the report. </p><p><br></p><p><strong><em>Note: If you edit the JSON used to construct the report, keep it wrapped in square brackets as a single-item array. Removing the brackets will cause the report to fail.</em></strong></p></body>