Frontend tools

​

Register a tool handler

Gleap.RegisterAgentTool("send-money", async parameters =>
{
    var amount = parameters["amount"];
    var contact = parameters["contact"];

    // Run your own logic here.
    await BankingService.InitiateTransferAsync(amount, contact);

    // Return a string or any JSON-serializable object — the AI waits for this response.
    return "The transfer was initiated. The user must confirm it in the banking app.";
});

• The handler receives the parameters configured in the dashboard, filled with the values the AI collected. Values arrive as plain CLR types (string, long, double, bool, nested IReadOnlyDictionary/IReadOnlyList, or null).
• Return a string, or any JSON-serializable object (objects are serialized to JSON). The result is sent back to the AI, which uses it to reply.
• Async handlers are fully supported — the handler returns Task<object?>, and the AI waits for it. For a synchronous handler, return Task.FromResult<object?>(result).
• Exceptions thrown by the handler are caught and reported to the AI automatically.
• If no handler is registered for a tool, the AI is informed so it can respond accordingly.

​

Execution modes

• Auto — the handler runs immediately when the AI calls the tool.
• Ask before final execution — the AI adds a confirmation button to its reply; the handler only runs after the user confirms.

​

Migrating from SetAiTools