Custom tools: let the AI call your own APIs

⏳ Coming soon. This feature is arriving soon in Madyis Hub — here is how it will work. 📍 Where to find it: AI Agents → Custom tools

Custom tools give your agents superpowers: during a conversation, the AI can query your own services (check an order, create a ticket, look up stock…) by calling an API that you define.

How it works

You describe a tool (name, description, HTTP method, URL, authentication, the parameters the AI will fill in, request template in Liquid). The description tells the AI WHEN to use the tool. When a customer asks a matching question, the AI calls the API, gets the response and uses it to reply. Tools are a Pro feature, reserved for administrators.

Step by step

1. Left menu → "AI Agents", then click the "Custom tools" button at the top.
2. Click "New tool".
3. Fill in the name, the identifier, and a clear description (the AI reads it to know when to use it).
4. Choose the HTTP method, the endpoint URL and the authentication.
5. Add the parameters the AI will need to fill in, test with "Test", enable the tool and click "Save".

Good to know

• Take care with the description: it is what tells the AI in which cases to call the tool.
• This feature requires a Pro plan and an administrator account.
• Test the tool before enabling it to check the identifier and the URL.