Custom Tool Script Enhancements in NetSuite 2026.1

Starting in NetSuite 2026.1, significant enhancements have been made to Custom Tool Scripts, which are essential for integrating external AI clients via the NetSuite AI Connector Service. These changes improve visibility and management of custom tools, facilitating better monitoring and troubleshooting through execution logs.

What's New

Custom Tool Script and SDF Object Updates

The updates focus on enabling execution log support for Custom Tool Scripts. Users can now access execution logs via the Script Execution Logs page at Customization > Scripting > Script Execution Logs. To utilize this feature effectively, developers need to:

• Update existing custom tool scripts: Include the JSDoc tag @NScriptType CustomTool.
• Declare entry point functions for tool methods as asynchronous.
• Revise the SDF object XML definitions:
  • Rename the SDF object from tool to toolset.
  • Change the script ID prefix from customtool_ to custtoolset_.
  • Rename the attribute exposeto3rdpartyagents to exposetoaiconnector.

Applying these updates is crucial for improved script monitoring and troubleshooting. Developers can refer to the guide on "How to Update Custom Tool Scripts for Execution Log Support in NetSuite 2026.1" for more information.

New Custom Tools Page

In addition to the script updates, the new Custom Tools page provides a centralized hub for viewing and managing available tools in the NetSuite account. This page, accessible via Customization > Scripting > Custom Tools, allows developers and administrators to:

• Organize tools by toolsets (the defining SDF object) used for custom tool scripts.
• View permissions for individual tools required for AI client access.
• Delete Account Customization Projects (ACPs) toolsets directly, while SuiteApp toolsets must be removed via the Installed SuiteApps page.

Real-World Context and Best Practices

Custom Tool Scripts are a powerful feature that enables the integration of AI capabilities into NetSuite, allowing natural language processing for various tasks such as data retrieval and triggering actions. As a best practice, ensure that your custom tools are thoroughly tested and adequately documented to facilitate ease of use and understanding, especially for those who will interact with these tools via AI clients.

Important Limitations

Note that the N/http, N/https, and N/sftp modules are not supported in custom tool scripts, which might impact how you design tools that rely on these services.

Who This Affects

• Developers: Responsible for creating and updating custom tool scripts.
• Administrators: Overseeing custom tools management and access permissions.
• IT Teams: Integrating AI clients with custom tools in NetSuite.

Key Takeaways

• New execution log capabilities enhance monitoring and troubleshooting for custom tool scripts.
• The Custom Tools page centralizes management of tools across SuiteApps and account customizations.
• Developers must update existing scripts and SDF objects to leverage these new features effectively.