SuiteScript 2.1 Custom Tool Scripts for AI Integration

TL;DR Opening

Custom tool scripts in SuiteScript 2.1 enable developers to integrate external AI clients with NetSuite through the NetSuite AI Connector Service. Starting in NetSuite 2026.1, these scripts now allow AI systems to retrieve data, trigger actions, and execute various SuiteScript-supported operations based on natural language prompts. By using custom tools, your AI client can provide more accurate responses to prompts and perform specific actions for you in NetSuite. You deploy custom tools to your NetSuite account through the SuiteCloud Development Framework (SDF), either as a SuiteApp project or an account customization project (ACP).

What Are Custom Tool Scripts?

Custom tool scripts serve as a bridge for AI applications to interact with NetSuite's backend. By deploying these scripts, users can enhance how AI clients process requests and retrieve information, leading to more relevant and accurate responses. These scripts can retrieve data, trigger actions, or perform most SuiteScript-supported operations, all from natural language prompts in your AI client. They are implemented through the SuiteCloud Development Framework (SDF), providing flexibility in tool deployment as either SuiteApp projects or Account Customization Projects (ACPs).

How to Define Custom Tools

Each custom tool is defined using a structured JSON format that includes:

• Name: The unique identifier for the tool.
• Description: A brief overview of what the tool does.
• Input Parameters: Specifications on what data the tool requires for operation.

With this information, AI clients can determine when to engage the tool and what parameters to supply.

Toolset SDF Object

Within SDF, tools are defined and grouped using a toolset SDF object that configures the visibility and access permissions for each tool within the AI client. If a user has all required permissions, the tool is visible in the AI client; however, what the tool can access and do in NetSuite is still limited by the user's NetSuite role and permissions.

Limitations

It's important to note that certain SuiteScript modules are not supported in custom tool scripts. These exclusions include:

• N/http
• N/https
• N/llm
• N/sftp

These limitations can impact the functionalities you may want to implement, so they should be considered during development.

Getting Started

To assist users in developing their custom tools, NetSuite offers sample implementations within the SuiteCloud Project Repository. This can serve as a foundation for building personalized tools tailored to specific AI integration needs. You can find sample tool implementations in the MCP-Sample-Tools directory of the SuiteCloud Project Repository on Oracle Samples GitHub.

Related Topics

Developers may explore the following resources for additional guidance:

• Custom Tool Script Requirements: Understand the foundational requirements for creating your own scripts.
• Custom Tool JSON Schema: Detailed structure and examples of the JSON schema used for tools.
• Best Practices for Custom Tool Scripts: Strategies for optimizing your tools and ensuring they operate effectively.
• Managing Custom Tools in NetSuite: Tips on overseeing and adjusting custom tools within the platform.

Who This Affects

• Developers: Building custom tools for AI integration.
• Administrators: Managing tool permissions and deployment.
• AI Engineers: Designing AI systems that leverage custom tools.

Key Takeaways

• Custom tool scripts enable AI integrations with NetSuite through natural language prompts.
• Tools are defined using a JSON schema and require clear parameters for operation.
• Access and visibility are controlled by user permissions within NetSuite.
• Certain SuiteScript modules are not supported in custom tools, which confines their functionality.
• Sample implementations are available to aid developers in creating their own custom tools.