Custom Tool Script Enhancements in NetSuite 2026.1

TL;DR Opening

Starting in NetSuite 2026.1, significant enhancements have been made to Custom Tool Scripts, including execution log support and a new management page. These updates improve script visibility and monitoring, enabling developers to better manage their scripts and their integration with the NetSuite AI Connector Service.

What's New

Custom Tool Script and SDF Object Updates

NetSuite 2026.1 introduces enhancements to custom tool scripts, specifically regarding their execution and management. The following changes have been implemented:

• Execution Log Access: You can view execution logs for custom tool scripts by navigating to Customization > Scripting > Script Execution Logs. This allows for better monitoring and troubleshooting of your scripts.
• Update Requirements: To utilize the logging feature effectively, existing custom tool scripts and their corresponding SuiteCloud Development Framework (SDF) objects must be updated. Key updates include:
  • Add the JSDoc tag @NScriptType CustomTool to specify script type.
  • Declare entry point functions for tool methods as asynchronous.
  • Modify the SDF object definition:
    • Change the object name from tool to toolset.
    • Update the script ID prefix from customtool_ to custtoolset_.
    • Rename the attribute exposeto3rdpartyagents to exposetoaiconnector.

Implementing these updates ensures improved script monitoring, giving developers access to detailed execution logs.

New Custom Tools Page

NetSuite has introduced a new Custom Tools page, providing a centralized location to view and manage available tools in your account. This page is accessible under Customization > Scripting > Custom Tools. The key features include:

• Tool Organization: Tools are organized by toolset, enabling easier navigation through SuiteApps and account customization projects (ACPs).
• Permission Management: You can view individual tools and their required permissions for access in the AI client. However, deletion options vary:
  • ACP Toolsets: Can be deleted directly from the Custom Tools page.
  • SuiteApp Toolsets: Cannot be deleted from this page; instead, users must navigate to the Installed SuiteApps page.

This centralized management capability aims to enhance user experience and efficiency when working with custom tools.

Who This Affects

• Administrators: Responsible for managing scripts and user permissions.
• Developers: Required to update existing scripts to take advantage of the new features.
• Technical Teams: Involved in the integration of custom tools with external AI clients via the NetSuite AI Connector Service.

Key Takeaways

• The introduction of execution logs for custom tool scripts in NetSuite 2026.1 enhances monitoring and troubleshooting capabilities.
• Developers must update existing custom tool scripts to align with the new specifications to benefit from the logging feature.
• The new Custom Tools page centralizes tool management, making it easier to navigate and control access permissions.
• Changes improve integration capabilities with external AI clients, facilitating better data interactions within NetSuite.