Custom Tool Script Enhancements in NetSuite

TL;DR Opening

Starting in the Weekly Update on February 16, 2026, NetSuite introduces enhancements to custom tool scripts, including execution log support and a centralized management page for better organization and oversight of tools. These updates streamline debugging and optimization of custom tools used with the NetSuite AI Connector Service.

What's New

Custom Tool Script and SDF Object Updates

The custom tool script type and its corresponding SuiteCloud Development Framework (SDF) object have undergone significant updates. Notably, you can now access execution logs for custom tool scripts via the Script Execution Logs page located at Customization > Scripting > Script Execution Logs.

To leverage this new logging feature, existing and new custom tool scripts must be updated. Here’s what you need to do:

For Custom Tool Scripts:
- Add the JSDoc tag @NScriptType CustomTool.
- Declare entry point functions for tool methods as asynchronous.
For SDF Object XML Definitions:
- Change the SDF object name from tool to toolset.
- Update the script ID prefix from customtool_ to custtoolset_.
- Rename the attribute exposeto3rdpartyagents to exposetoaiconnector.

These changes enhance script monitoring and troubleshooting, enabling developers to better manage their custom tools. For detailed guidance, refer to How to Update Custom Tool Scripts for Execution Log Support in NetSuite 2026.1 (SuiteAnswers ID: 1024036).

New Custom Tools Page

In addition to script and SDF updates, NetSuite now features a new Custom Tools page. This page centralizes the viewing and management of custom tools available in your account. Here, you can find tools from SuiteApps and account customization projects (ACPs), organized by toolset, which refers to the new SDF object structure.

To access the Custom Tools page, navigate to Customization > Scripting > Custom Tools.

Expanding a toolset reveals individual tools and associated permissions required for access via the AI client.
You can delete ACP toolsets directly, but SuiteApp toolsets cannot be deleted from this page—use the link to the Installed SuiteApps page for uninstallation.

The new page enhances user experience by simplifying access and visibility into custom tool functionalities.

Who This Affects

The updates benefit the following roles:

Developers: Improved monitoring and error handling for custom tools.
Administrators: Easier management of custom tools and permissions.
Business Analysts: Streamlined tools for better AI integration and reporting.

Key Takeaways

Custom tool scripts now support execution logs for enhanced troubleshooting.
The new Custom Tools page centralizes tool management for better visibility.
Updates include changes to SDF object structure, enhancing compatibility with the NetSuite AI Connector Service.
Developers must update existing tools to utilize the new features effectively.

Frequently Asked Questions (4)

How can I enable the new execution log support for custom tool scripts?

To enable the new execution log support, you need to update custom tool scripts by adding the JSDoc tag `@NScriptType CustomTool` and declaring entry point functions for tool methods as asynchronous.

What changes are required for SDF object XML definitions to work with the updated custom tool scripts?

You need to change the SDF object name from `tool` to `toolset`, update the script ID prefix from `customtool_` to `custtoolset_`, and rename the attribute `exposeto3rdpartyagents` to `exposetoaiconnector`.

What permissions are necessary to view and manage tools on the new Custom Tools page?

The Custom Tools page shows the permissions required for accessing the tools via the AI client. Specific permissions are tied to individual tools, organized under toolsets on the page.

Can existing custom tools take advantage of the new script execution logs feature?

Yes, but existing custom tools must be updated as per the new guidelines, such as updating the JSDoc tag and function declarations, to access the script execution logs.