Mastering Custom Tools Management in NetSuite: Best Practices and Insights
Learn how to efficiently manage and deploy custom tools in NetSuite to enhance your AI integrations.
In the dynamic environment of NetSuite, custom tools play a pivotal role in extending the platform's capabilities. These tools are integral to interacting with external AI clients through the NetSuite AI Connector Service, allowing developers to tailor functionalities that can capture data, trigger specific actions, or tap into a breadth of SuiteScript-supported operations — all driven by natural language prompts from AI clients.
Navigating the Custom Tools Interface
NetSuite offers a comprehensive Custom Tools page, which serves as a centralized hub for viewing and managing these critical tools. To access this page, navigate to Customization > Scripting > Custom Tools. Here, you will find tools originating from SuiteApps and Account Customization Projects (ACPs), meticulously organized by toolsets.
Note: Only users granted SuiteScript (Edit or Full) permissions have access to these functionalities, ensuring that management remains in capable hands.
Managing Toolsets
The toolsets provide a consolidated view, where each set groups related tools as defined by the SuiteCloud Development Framework (SDF). Expanding a toolset allows you to inspect the individual tools within, along with the permissions necessary for them to operate effectively with AI clients.
Deleting Toolsets
To maintain a streamlined environment, toolsets associated with ACPs can be deleted directly from the Custom Tools page by clicking the delete icon, effectively removing all tools within. However, if a toolset belongs to a SuiteApp, it cannot be directly removed here. Instead, you must navigate to the Installed SuiteApps page.
To uninstall a SuiteApp toolset:
- Go to Customization > SuiteCloud Development > Installed SuiteApp List.
- Click 'Uninstall' next to the SuiteApp you wish to remove.
Important: Note that ACP components cannot be uninstalled once deployed. Unwanted parts must be manually deleted to maintain system integrity.
Developing and Deploying Custom Tools
The development and deployment of custom tools rely heavily upon the SDF, where each tool is encapsulated within a JSON Schema. This ensures compatibility and ease of integration within the broader SuiteApp projects or ACPs.
When creating custom tools, it’s crucial to adhere to established best practices to avoid pitfalls. Notably, certain modules—such as N/http, N/https, and N/sftp—are not supported in custom tool scripts, necessitating alternative approaches for similar functionalities.
Key Takeaways
- Centralized Management: The Custom Tools page offers an organized view of toolsets, facilitating efficient management.
- Permissions: Only authorized users can edit or delete toolsets, ensuring security and compliance.
- Uninstallation: SuiteApp toolsets must be removed from the Installed SuiteApps page, whereas ACP toolsets can be deleted directly.
- Development Framework: All custom tools must be defined using SDF with JSON Schema for proper deployment.
- Module Limitations: Be aware of unsupported modules when scripting custom tools.
By leveraging these insights, NetSuite developers and administrators can effectively harness the power of custom tools to seamlessly integrate AI functionalities into their ERP processes.