Evaluate calculation

⬅ Go back to Agent Home Page

 This tool is currently in Alpha and has been released for early access and feedback
 It may include incomplete features, limited functionality, or be subject to change. Alpha tools are intended for evaluation and validation  purposes only and should only be be used in non-production environments.

The Evaluate calculation tool allows a ReadiAI Agent to run a custom calculation using the ReadiNow Calculation Language. This tool is useful for performing dynamic logic, querying small sets of records, or generating computed results during a conversation. Parameters can be added to make the calculation flexible based on user input or context.

Adding the tool to an Agent

To add the Evaluate calculation tool to a ReadiAI Agent: Open the Agent Builder. From the left-hand menu, go to the Tools section. Click Add Tool. Select and click Evaluate Calculation from the list of available tool types. The Configure 'Evaluate Calculation' Tool dialog will appear.

Configuring the tool

Follow these steps to complete the configuration:>

1. Enter a Name
   • Provide a meaningful name for the calculation. This should clearly describe what the calculation does.
   • Example: Get all Projects for a given Department
2. Enter a Description
   • Optionally describe the purpose or logic of the calculation. This can help others understand its intent and usage.
3. Add Parameters (Optional)
   • Parameters allow you to make the calculation dynamic based on inputs provided by the agent.
   • For each parameter:
     • Enter a Parameter Name.
     • Choose a Data Type (e.g. String, Number, Boolean, etc.)
     • Optionally provide a description to explain how the parameter will be used.
       • Click Add to include the parameter.
       • Example: 
         • Parameter Name: Department
         • Type: Record
         • Description: The department for which projects are assigned to
         • The agent will automatically detect and pre-populate parameters when running the tool.
4. Enter the Calculation
   • Use the Calculation input area to write your expression using ReadiNow’s Calculation Language.
   • You can reference parameters you’ve defined by name within the formula.
   • Example: all([Project]) where department = {Department} 
5. Specify Returned Fields (Optional)
   • If your calculation returns a list of records, you can specify which fields to return.
   • Enter the Field Name and click Add for each field the agent should receive.
6. Specify Returned Fields (Optional)
   • If your calculation returns a list of records, you can specify which fields to return.
   • Enter the Field Name and click Add for each field the agent should receive.
7. Click Save to complete the configuration
   • This helps the agent understand what data to include in its response.