Cekat AI Tools
The Cekat AI Tool Trigger node allows you to connect external tools and functions to your CekatAI AI Agent. When the AI agent decides to use a tool during a conversation, this trigger fires in n8n, letting you execute custom logic and return results back to the AI.
Node Configuration
| Property | Value |
|---|---|
| Node Type | n8n-nodes-base.cekatAiToolTrigger |
| Type Version | 2 |
| Credential | CekatOpenApi |
How It Works
1
AI Decides
During a conversation, the AI agent determines it needs to call an external tool (e.g., look up an order, check inventory, calculate shipping).
2
Trigger Fires
The Cekat AI Tool Trigger fires in your n8n workflow, passing the tool name and input parameters.
3
You Execute
Your n8n workflow executes the custom logic — API calls, database lookups, calculations, etc.
4
Result Returns
The result is returned to the AI agent, which uses it to continue the conversation with the customer.
Setup
Add Node
Search for Cekat AI Tool Trigger in the n8n node panel and add it as the starting node of your workflow.
Connect Credential
Select or create a CekatOpenApi credential with your CekatAI API key.
Design Your Workflow
Add nodes after the trigger to handle the tool call — perform lookups, call APIs, process data, etc.
Return Result
The final node output will be returned to the AI agent as the tool result.
n8n Node JSON
{
"parameters": {},
"type": "n8n-nodes-base.cekatAiToolTrigger",
"typeVersion": 2,
"name": "Cekat AI Tool Trigger",
"webhookId": "your-webhook-id",
"credentials": {
"CekatOpenApi": {
"id": "YOUR_CREDENTIAL_ID",
"name": "CekatAI account"
}
}
}
Output
When triggered, the node provides the following data:
{
"tool_name": "check_order_status",
"parameters": {
"order_number": "2292"
},
"conversation_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"contact": {
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Customer Name",
"phone_number": "+6281234567890"
}
}
| Field | Type | Description |
|---|---|---|
tool_name | string | The name of the tool the AI agent wants to call |
parameters | object | The input parameters for the tool, extracted from the conversation |
conversation_id | string | The conversation ID where the tool was invoked |
contact | object | The customer's contact information |
Supported Tool Types
AI Tools can perform a wide range of actions:
| Category | Examples |
|---|---|
| Order Management | Check order status, create orders, update order status |
| CRM Operations | Look up contacts, update customer data, search deals |
| External APIs | Query shipping providers, payment gateways, inventory systems |
| Calculations | Shipping cost, discount pricing, tax calculations |
| Data Retrieval | Product catalog lookup, knowledge base search, FAQ answers |
Example Workflows
Check Order Status
- Cekat AI Tool Trigger fires with
tool_name: "check_order_status"andparameters: { "order_number": "2292" } - Get Order node looks up the order using the order number
- Result is returned to the AI agent, which informs the customer
Calculate Shipping
- Cekat AI Tool Trigger fires with
tool_name: "calculate_shipping"andparameters: { "destination": "Jakarta", "weight": "2kg" } - HTTP Request node calls your shipping API
- Result is returned to the AI agent with the shipping cost
Configuration in CekatAI Dashboard
Before using AI Tools in n8n, you need to register them in your CekatAI dashboard:
- Navigate to AI Agent > Integration > AI Tools
- Click Add Tool and define the tool name, description, and expected parameters
- The AI agent will automatically learn when and how to use the tool based on the description
Write clear, detailed tool descriptions in the CekatAI dashboard. The better the description, the more accurately the AI agent will decide when to use the tool and what parameters to pass.