Configuring OCI Credentials for SuiteScript Integration

For organizations looking to leverage advanced AI functionalities in NetSuite, configuring Oracle Cloud Infrastructure (OCI) credentials is essential. Setting up these credentials allows your company to utilize services such as OCI Generative AI and OCI Document Understanding, enhancing features like Text Enhance and Prompt Studio within SuiteScript.

Why Configure OCI Credentials?

Configuring OCI credentials enables access to Oracle Cloud services beyond the free monthly usage. By establishing an Oracle Cloud account and configuring the required credentials, your company can manage expenses associated with additional OCI services.

Prerequisites

Before you begin, ensure that you have:

• An active Oracle Cloud account. If you do not have an account, refer to Oracle documentation on how to Get an Oracle Cloud Account.
• Access to the following services:
  • OCI Generative AI: Follow the documentation for getting access, setting the right policies, and managing your usage.
  • OCI Document Understanding: This is essential if you intend to use the N/documentCapture module in your SuiteScript.

Testing Your OCI Configuration

To ensure that your OCI configuration parameters are set up correctly, follow these testing steps within your SuiteScript:

1. Add Monitoring Method: Incorporate the getRemainingFreeUsage method right before and after using methods like generateText or evaluatePrompt to verify your free usage.
2. Validate Configuration Values: Ensure that your OCI parameters contain correct values, especially the API Secret IDs and fingerprint settings.
3. Run Your Script: If configured correctly, your script should execute smoothly, returning the expected usage count. A SuiteScript error indicates a misconfiguration.

Troubleshooting Common Issues

If an error arises:

• Verify that the OCI configuration parameters match those of your Oracle Cloud account.
• Check that the API Secret IDs are accurate and correspond to the IDs used on the API Secrets page.
• Make sure the OCI fingerprint and private key secrets were generated properly.
• Confirm that the checkbox to use OCI Credentials in SuiteScript settings is enabled if not using the ociConfig parameters object.

By following these guidelines, you can effectively configure OCI credentials to enhance your organization's NetSuite environment with advanced AI capabilities.

Key Takeaways:

• OCI credentials are essential for utilizing advanced AI features in SuiteScript.
• Ensure proper setup and verification of API credentials to avoid errors.
• Testing your configuration effectively helps maintain smooth operations.

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