Custom Tool Script Enhancements for NetSuite SuiteCloud

NetSuite introduces enhancements to custom tool scripts for improved functionality and AI integration.

·2 min read·6 views·View Oracle Docs

TL;DR Opening

NetSuite has rolled out enhancements to custom tool scripts, enabling better monitoring and integration through improved logging capabilities and a centralized management page. These changes are critical for developers looking to leverage AI functionalities effectively.

What’s New in Custom Tool Scripts?

With the latest updates, custom tool scripts in NetSuite have been enhanced significantly, focusing on better execution log management and providing a new interface for managing tools.

Custom Tool Script and SDF Object Updates

Two main areas have seen advancements:

  • Script Execution Logs: Developers can now access execution logs for custom tool scripts through the Script Execution Logs page found at Customization > Scripting > Script Execution Logs. This feature allows for improved monitoring and troubleshooting of script executions.

  • Required Updates for Scripts:
    For custom tool scripts:

    • Implement the JSDoc tag @NScriptType CustomTool to help identify the script type.
    • Declare entry point functions for tool methods 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 exposeto3rdpartyagents to exposetoaiconnector.

Applying these updates enhances your ability to monitor script activities effectively. For detailed guidance, refer to how to Update Custom Tool Scripts for Execution Log Support.

New Custom Tools Page

The introduction of a new Custom Tools page centralizes the management of your custom tools. This page:

  • Displays custom tools across SuiteApps and account customization projects (ACPs), organized by toolset.
  • Allows for expanded views of individual tools including permission settings and provides options to delete ACP toolsets directly.
  • To access this page, navigate to Customization > Scripting > Custom Tools.
    Custom Tools page that shows the tools available in a NetSuite account.

Best Practices Moving Forward

To ensure that your custom tool scripts are up to date and functioning correctly with the new enhancements, consider the following best practices:

  • Regularly review execution logs to diagnose and address issues swiftly.
  • Test modifications in a sandbox environment before deployment.
  • Stay informed on further updates or best practices through NetSuite’s resources.

Who This Affects

These enhancements primarily impact:

  • Developers designing custom tools.
  • Administrators managing custom script deployments.
  • Business Analysts utilizing AI integration to enhance operational efficiency.

Key Takeaways

  • Improved logging capabilities enhance monitoring of custom tool scripts.
  • A new centralized Custom Tools page simplifies tool management and oversight.
  • Updated requirements for customizing tool scripts ensure alignment with best practices.

Source: This article is based on Oracle's official NetSuite documentation.

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.

Weekly Update History (1)

SuiteScriptupdated

Updated New NetSuite AI Connector Service to add a link to the MCP-Sample-Tools project in the SuiteCloud Project Repository on Oracle Samples GitHub.

View Oracle Docs
Source: Custom Tool Script Enhancements Oracle NetSuite Help Center. This article was generated from official Oracle documentation and enriched with additional context and best practices.

Was this article helpful?

More in SuiteScript

View all SuiteScript articles →