HaloCRM Guides
AI Report Builder
Available in Halo version 2.136+.
About the AI Report Builder
The report builder uses an AI Assistant utilising the latest GPT-4 model. Trained using a schema of the Halo database, this assistant can query from the following tables and tables associated with them:
- Tickets
- Actions
- Approvals
- Agents
- Users
- Sites
- Customers
- Assets
- Items
- Invoices
- Quotations
- Sales Orders
- Purchase Orders
How to use the AI Report Builder
To generate a report, first select the "AI Report Builder" option from the data source dropdown. This will then display a text field to enter your prompt into.
When writing your prompt make sure to explain exactly what fields you want included in your query and what tables you're querying. If referencing any user-defined values, make sure you define what they mean. For example, if asking for change requests awaiting approval, you need to specify that "Change Request" is the name of a ticket type and "Awaiting Approval" is a ticket status.
If trying to query custom fields, make sure to use the CF name of the custom field in your prompt.
Similarly, if querying asset fields, make sure to include AF before the name of the asset field in your prompt
Once you are happy with the prompt you have entered, click the "Generate Report" button. This will send the prompt off to the AI assistant.
Generating the report can take anywhere from 20 seconds to a couple of minutes. Make sure to remain on the page and not refresh it until the report query has been generated.
Once the response is received from the AI assistant, a message will be displayed if it succeeded in generating the query and if the query runs successfully on the database.
As this is cutting-edge functionality, there are limitations to what the AI can query. If the query returned is not 100% correct, the message displayed should help you resolve any issues with it. We are continuously improving this functionality to improve the complexity of the queries that can be generated and to reduce the number of issues with the queries returned.
Example Prompts
Below is a list of prompts you can use to get started with the AI Report Builder, giving you a good foundation to build out a more complex query.
- Write a query to return the summary and ID of all incident tickets opened this week. 'Incident' is the name of a ticket type.
- Write a query to return the asset number, site, and asset type name of all active assets.
This list will be expanded over time, so make sure to check back in the future.
Popular Guides
- Asset Import - CSV/XLS/Spreadsheet Method
- Call Management in Halo
- Creating a New Application for API Connections
- Creating Agents and Editing Agent Details
- Departments, Teams and Roles
- Halo Integrator
- Importing Data
- Multiple New Portals with different branding for one customer [Hosted]
- NHServer Deprecation User Guide
- Organisation Basics
- Organising Teams of Agents
- Step-by-Step Configuration Walk Through
- Suppliers