Skip to main content

Add an item to a list tool

Configure an AI Agent to create one record in a selected data list, then verify its field values and the execution result.

Use Add an item to a list to let an AI Agent create records in a selected data list. For example, a service desk agent can create a request using the subject and priority supplied by a user.


Accessing the Tools Page

Open the AI Agent and select Tools in the top navigation. You can add, edit, enable, disable, or remove tools from this page.


Adding the “Add an item to a list” Tool

  1. Select Add a tool → Add an item to a list.

  2. Choose the application, then choose the destination list under Data source.

  3. Select Add to create the tool or Add and configure to open its settings.

Add an item to a list card in the AI Agent tool picker.


General Settings

Under Details, check the tool name, description, type, application, and data source. Set Credentials to use to End user credentials for the caller’s access or Specific user for the selected user’s access. The identity must be able to create records in the selected list. AI Agent settings


Inputs – Fields Used When Creating a New Item

The Inputs list starts empty. Select + Add input to choose which fields the agent can fill. To look up records without creating one, use the query tool. Configure Query Items

Select inputs

The picker shows each field’s Input name, internal ID, and Input type. Select the fields needed for creation and choose OK. For a service desk request, let the agent extract Subject from the conversation. If all requests created through the agent have the same source, set a custom value for Source.

Inputs table configuration

Each selected input appears as a row with:

Column

Description

Input name

Name of the field the agent will fill

Input type

Data type inherited from the list

Fill using

AI-generated value or Custom value

Value

Shown only when using Custom value

Notes:

  • Required list fields should be included.

  • Only fields added here can be populated by the agent.

  • Fields can be removed anytime using the delete icon.

Note:

To learn more about the Dynamically fill with AI and Custom value options, please refer to the following article: Usage and Differences Between “Dynamically fill with AI” and “Custom value” in AI Agent Tool Inputs


Completion

Under After running, choose Waiting for response when the agent needs to confirm the creation result. Use the non-waiting option when the agent can continue without the result.


Outputs available to the agent and other tools

Defines which outputs from this tool will be available for use by the agent or other tools after an item is created.

Default outputs include:

Output

Output type

Description

Message

Text

Describes the execution result (success or error).

Status Code

Number

Indicates success or failure numerically.

Managing outputs

Select Customize to change an output mapping. Remove unused outputs and select Add output if you need to restore one. If the configuration also shows Data, inspect its value in a test run before using it in a later step.


Summary

  1. In a test list, submit a request with a unique subject and a valid priority. Check that the list contains one new record with the expected subject, priority, and source.

  2. Try a request with a required value missing. Check whether the agent asks for it before calling the tool or reports an error if creation fails.

  3. If you use End user credentials, check the result with a user who can create records and one who can only read the list.

Did this answer your question?