Custom Tool Script Enhancements for NetSuite 2026.1

The enhancements to custom tool scripts introduced in NetSuite 2026.1 significantly improve monitoring and management capabilities. These upgrades include the ability to view execution logs directly and provide a new centralized interface for managing custom tools.

Who This Affects

• Developers: Those building and maintaining custom tool scripts.
• Administrators: Users responsible for managing and monitoring custom tools and their configurations.

Main Changes

Custom Tool Script and SDF Object Updates

The first substantial change in NetSuite 2026.1 pertains to the updates for the custom tool script type and its associated SuiteCloud Development Framework (SDF) object. These updates allow users to access execution logs via the Script Execution Logs page by navigating to:

Customization > Scripting > Script Execution Logs

To effectively utilize these new logging features, you must:

• For custom tool scripts:

  • Add the JSDoc tag @NScriptType CustomTool.
  • Declare entry point functions as asynchronous.

• For SDF object XML definition files:

  • Change the SDF object name from tool to toolset.
  • Update the scriptid prefix from customtool_ to custtoolset_.
  • Rename the attribute from exposeto3rdpartyagents to exposetoaiconnector.

These modifications enhance your ability to monitor and troubleshoot scripts effectively. For detailed instructions on updating your scripts, consult the guide on updating custom tool scripts for execution log support available in SuiteAnswers.

New Custom Tools Page

In addition to the updates above, a new Custom Tools page has been introduced, allowing users to manage custom tools efficiently. From this page, you can:

• View the tools available in your NetSuite account.
• Organize tools by toolset, making it easier to navigate between different functionalities.
• Manage access permissions required for AI clients to utilize specific tools.
• Delete account customization project (ACP) toolsets directly; however, SuiteApp toolsets require uninstallation through the installed SuiteApps page.

To access the Custom Tools page, go to:

Customization > Scripting > Custom Tools

AI Integration Capabilities

The custom tool scripts enable external AI clients to invoke specific actions through the NetSuite AI Connector Service. By utilizing these scripts, you can perform operations—like retrieving data or executing SuiteScript-supported tasks—via natural language prompts. This integration allows for a more interactive and responsive experience when using AI technologies with NetSuite.

Be Aware: The use of the N/http, N/https, and N/sftp modules is not supported in custom tool scripts. This is crucial for developers to note when planning and coding functionality.

Key Takeaways

• NetSuite 2026.1 has improved logging and management for custom tool scripts.
• New tools page simplifies the management of the various custom tools.
• Updated structure for SDF objects enhances organization and access control.
• Custom tool scripts enable effective integration with external AI clients.