Configure API Tool in Agent Copilot
Updated
API Tool enables Agent Copilot to interact with external systems by sending input data and receiving structured responses. This allows the Agent Copilot to fetch real‑time information, automate actions, and deliver personalized responses during customer conversations.
Steps to Configure API Tool
Follow the steps below to configure the Update Properties Tool in Agent Copilot:
1. Access the API Tool
Navigate to Agent Copilot from the Sprinklr Launchpad.
Select the Agent Copilot you want to configure.
Expand the Define Tasks and Tools section and open Tools.
Click + Add Tool and select API Tool from the list.
2. Configure Overview
Name: Enter a descriptive name for the API Tool. This helps identify the tool when configuring or troubleshooting.
Description: Provide a brief description of the tool’s purpose or functionality. For example: “Fetch customer details from CRM.”
3. Configure Setup Function
This section includes settings required to configure your API tool. It ensures proper integration with the selected API.
API: Choose the External API that you want to use from the dropdown.
Note: Ensure that you have configured the External API through Extensions Library.
API Endpoint: Choose the endpoint you want the API Tool to call .
4. Configure Setup Input
Configure the input settings for the selected API. These define what data is sent in the API request.
Input Variables
Define variables that will hold the values sent to the API.
API Input: Specify the input to send to the API for each input parameter.
Select Value: Choose the source of the input value
Inputs from LLM
The Agent Copilot extracts the value dynamically from the conversation context using the language model.
API Input: Specify the input that Agent Copilot extracts from the conversation.
Mandatory: Indicate whether the input parameter is required:
Yes: The API call will fail if this input is missing.
No: The API call can proceed without this input.
5. Configure Setup Output
Configure how the API response is handled and mapped for use by the Agent Copilot.
Output Variable: Enter the variable name that will store the API response.
Error Variable: Define a variable to capture error messages or codes if the API call fails.
Adapt response before sending (Toggle): Enable this option if you want to transform or adapt the API response before using it in the conversation.
Adapt Response: Write Groovy code to parse, update, or format API responses and store the result in an Adapted Response Variable for later use. The modified output is what gets published. Groovy code should be written inside ${}.
Adapted Result Variable: Enter the variable name that will store the adapted response.
Click the Save button in the bottom right corner to add the API tool to your Agent Copilot.
The API Tool makes it easy for your Agent Copilot to connect with other applications and share information. With this feature, you can:
Get real-time data from systems like CRM or ERP so your team always has the latest information.
Update order details or customer records during a conversation, saving time and reducing manual work.
Check inputs before moving forward to make sure the information is correct and avoid mistakes.
These capabilities help simplify processes, improve customer service, and make everyday tasks faster and more accurate.