Custom Tool Script Enhancements in NetSuite 2026.1

TL;DR Opening

Starting in NetSuite 2026.1, custom tool scripts receive significant enhancements including execution logging capabilities and the introduction of a new Custom Tools page. These updates streamline the management of tools that can be invoked by AI clients and improve monitoring capabilities.

What's New in Custom Tool Script Enhancements

Custom Tool Script and SDF Object Updates

The custom tool script type and its corresponding SuiteCloud Development Framework (SDF) object have received critical updates. This allows users to view execution logs for custom tool scripts, facilitating better monitoring and troubleshooting. Here's what you need to do to take advantage of these new logging features:

Update Existing Scripts:
- Add the JSDoc tag @NScriptType CustomTool to your scripts.
- Declare entry point functions for tool methods as asynchronous.
SDF Object XML Modifications:
- Change the SDF object name from tool to toolset.
- Update the scriptid prefix from customtool_ to custtoolset_.
- Rename the attribute exposeto3rdpartyagents to exposetoaiconnector.

These changes are essential for enabling execution log support for custom tool scripts. Updating your scripts not only aligns them with the latest specifications but also empowers you with improved monitoring capabilities.

For assistance with the updates, refer to the guide titled How to Update Custom Tool Scripts for Execution Log Support in NetSuite 2026.1 (SuiteAnswers ID: 1024036).

New Custom Tools Page

In NetSuite, custom tool scripts allow you to create tools that can be invoked by external AI clients through the NetSuite AI Connector Service. The newly introduced Custom Tools page provides a centralized location for viewing and managing these tools. The page organizes tools by their toolset, enhancing usability:

Access: Navigate to: Customization > Scripting > Custom Tools.
Toolset Management: You can expand a toolset to see individual tools and the permissions required for AI client access.
Deletion Options: From this page, you can delete account customization project (ACP) toolsets. Note, SuiteApp toolsets must be removed via the SuiteApps page.

The new layout not only simplifies accessibility but also allows for better management of your custom tools.

Who This Affects

Administrators: Oversee custom tool updates and monitoring.
Developers: Implement and update custom tool scripts for AI integrations.
Accountants: Utilize tools that interact with financial data via custom scripts.

Key Takeaways

NetSuite 2026.1 introduces enhanced logging for custom tool scripts.
A new Custom Tools page centralizes the management of tools.
Essential updates to scripts include modifying JSDoc tags and XML definitions.
Execution logs improve monitoring and troubleshooting capabilities for custom tools.

Frequently Asked Questions (4)

What are the specific changes required to enable execution log support for custom tool scripts in NetSuite 2026.1?

To enable execution log support, you need to add the JSDoc tag `@NScriptType CustomTool` to your scripts, declare entry point functions as asynchronous, change the SDF object name from `tool` to `toolset`, update the `scriptid` prefix from `customtool_` to `custtoolset_`, and rename the attribute `exposeto3rdpartyagents` to `exposetoaiconnector`.

Where can I manage my custom tool scripts after updating them in NetSuite 2026.1?

You can manage your custom tool scripts using the new Custom Tools page in NetSuite 2026.1. Navigate to `Customization > Scripting > Custom Tools` to access this centralized location for viewing and managing tools.

Are there any changes to how I delete toolsets in the new Custom Tools page?

Yes, account customization project (ACP) toolsets can be deleted directly from the Custom Tools page. However, SuiteApp toolsets must be removed via the SuiteApps page.

Are there new permissions required for AI client access to tools in NetSuite 2026.1?

Yes, in the new Custom Tools page, you can expand a toolset to view the permissions required for AI client access, allowing for better management of AI client integrations.