Custom Tool Script Enhancements for AI Integration in NetSuite

Starting in NetSuite, significant enhancements have been made to custom tool scripts, which are critical for integrating AI capabilities into your NetSuite environment. These updates focus on improving script monitoring and management, specifically through enhanced execution logging and a new tools management interface.

What Are Custom Tool Scripts?

Custom tool scripts in NetSuite allow developers to design specific functionalities that can be triggered by external AI clients utilizing the NetSuite AI Connector Service. This integration enables access to data, execution of actions, and other SuiteScript-supported operations using natural language prompts.

Key Enhancements to Custom Tool Scripts

Custom Tool Script and SDF Object Updates

The following updates have been implemented for custom tool scripts and their corresponding SuiteCloud Development Framework (SDF) objects, allowing better execution logs and easier management:

• Enhanced Logging: You can now view execution logs for custom tool scripts by navigating to Customization > Scripting > Script Execution Logs.

• Update Requirements:

  • For Custom Tool Scripts:
    • Include the JSDoc tag @NScriptType CustomTool.
    • Declare entry point functions for tool methods as asynchronous.
  • For SDF Object XML Definitions:
    • Change tool to toolset in object names.
    • Update the scriptid prefix from customtool_ to custtoolset_.
    • Rename the attribute exposeto3rdpartyagents to exposetoaiconnector.

These updates enhance the monitoring and troubleshooting capabilities of your scripts. For detailed guidance on these changes, consult the appropriate resources in the SuiteAnswers platform.

New Custom Tools Page

A newly introduced Custom Tools page centralizes the management of tools within NetSuite, allowing users to view and manage their custom tool scripts easily.

• Accessing the Custom Tools Page: Navigate to Customization > Scripting > Custom Tools.
• Features of the Custom Tools Page:
  • Displays tools from SuiteApps and account customization projects (ACPs) organized by toolset.
  • Allows expansion of toolsets to view individual tools and required permissions for AI client access.
  • Supports management actions, including deletion of ACP toolsets directly, while SuiteApp toolsets require a different uninstall process.

Such a centralized system streamlines the management of various custom tools, making it easier for developers and administrators to maintain their custom integrations.

Who This Affects

The enhancements primarily impact:

• Administrators responsible for managing custom scripts.
• Developers implementing tool scripts for AI integrations.
• Users utilizing custom tools via the AI Connector Service.

Key Takeaways

• Custom tool scripts now feature enhanced execution logs for better monitoring.
• A new Custom Tools page centralized the management of tools within NetSuite.
• Developers must update their scripts for compatibility with new requirements.

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