---
title: "React Native SDK: Frontend tools"
description: "Connect AI agent frontend tools to your application with the Gleap React Native SDK. Follow the integration code examples."
url: https://docs.gleap.ai/en/articles/503-react-native-sdk-frontend-tools
collection: "React Native"
updated: 2026-11-01
language: en
---

# React Native SDK: Frontend tools

Connect AI agent frontend tools to your application with the Gleap React Native SDK. Follow the integration code examples.

Frontend tools let your AI agent execute actions directly inside your app — initiating a transfer, resetting a password, cancelling an order, etc.

Define the tool under AI agents → your agent → Settings → Tools → Add tool → Frontend tool. Its name, description, parameters and execution mode live there. Your app registers the matching runtime handler. See the linked help guide for the current setup. [Frontend tools setup guide](https://help.gleap.ai/en/articles/251-let-an-agent-run-actions-inside-your-app)

## Register a tool handler

Register the handler for a dashboard-defined Frontend tool. Use the tool's runtime name shown in the tool editor.

```js
Gleap.registerAgentTool('send-money', async ({ amount, contact }) => {
  // Run your own logic here.

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

**Handler contract**

-   The handler receives the parameters configured in the dashboard, filled with the values the AI collected.
    
-   Return a string or a JSON-serializable object (objects are stringified). The result is sent back to the AI, which uses it to reply.
    
-   Async handlers are fully supported — the AI waits for the returned promise.
    
-   Thrown errors 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

Set per tool in the dashboard:

-   `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`

`Gleap.setAiTools(tools)` has been removed. Tools defined via `setAiTools` could only return a static response to the AI — Frontend tools execute real code and return live results. Define your tools on the AI agent in the dashboard and register their handlers via `Gleap.registerAgentTool(name, handler)` instead. The `toolExecution` listener remains available.

## Related

- [React Native SDK setup](https://docs.gleap.ai/en/articles/499-react-native-sdk-setup.md)
- [React Native SDK: User identity](https://docs.gleap.ai/en/articles/500-react-native-sdk-user-identity.md)
- [React Native SDK: Track events](https://docs.gleap.ai/en/articles/501-react-native-sdk-track-events.md)
- [React Native SDK: Track pages](https://docs.gleap.ai/en/articles/502-react-native-sdk-track-pages.md)
- [React Native SDK: Forms](https://docs.gleap.ai/en/articles/504-react-native-sdk-forms.md)