1. SuiteCloud Platform
  2. SuiteCloud Developer Assistant
  3. SuiteCloud Developer Assistant
  4. FAQ: SuiteCloud Developer Assistant

FAQ: SuiteCloud Developer Assistant

See the following questions and answers for more information about using SuiteCloud Developer Assistant.

How do I interact with SuiteCloud Developer Assistant in VS Code?

To interact with SuiteCloud Developer Assistant in Visual Studio Code (VS Code), open VS Code and the Cline extension in the sidebar. Next, enter your natural language prompts or code requests in the chat box. The assistant generates code, XML objects, explanations, documentation, or debugging suggestions as requested.

Can I set up SuiteCloud Developer Assistant for a non-SDF project?

No. SuiteCloud Developer Assistant currently requires a SuiteCloud Development Framework (SDF) project.

How do I provide feedback on SuiteCloud Developer Assistant?

Use the Share your feedback link in the SuiteCloud Developer Assistant panel. Your input helps improve and refine the tool.

What is the API key used for in SuiteCloud Developer Assistant?

The API key is a secret credential used by local clients to authenticate to SuiteCloud Proxy. Keep it confidential and do not include it in prompts, logs, screenshots, source control, or shared configuration files. Rotating the key invalidates the previous key for every configured client.

For SuiteCloud CLI clients, run suitecloud proxy:generatekey to generate a replacement key. Update every connected client after rotating the key.

How can I regenerate the API key?

If you need to regenerate the API key for any reason, follow these steps:

  1. In the SuiteCloud Developer panel, click Stop to stop SuiteCloud Proxy.

  2. Click the refresh icon to rotate the API key.

    Note:

    Rotating the API key invalidates the existing key, so update all connected clients with the new key.

  3. Click Start to start SuiteCloud Proxy again.

  4. Read the disclaimer in the popup window and click Start Proxy.

For more information, see Setting Up SuiteCloud Developer Assistant Using Cline in SuiteCloud Extension for VS Code.

I get an 'Unauthorized: Missing or invalid API key' error. What should I do?

First, verify that SuiteCloud Proxy is running. Confirm that Cline's Base URL and port match the values displayed by SuiteCloud Proxy, and confirm that Cline is using the current API key. If the key is no longer valid, rotate it and click Configure to apply the updated settings. If automatic configuration fails, enter the Base URL, API key, and model ID manually. Restart the extensions or VS Code only if the configuration remains stale.

For more information, see Setting Up SuiteCloud Developer Assistant Using Cline in SuiteCloud Extension for VS Code.

How can I configure Cline to use the full 1,000,000-token context window?

SuiteCloud Developer Assistant uses Cline as the interface to interact with large language models capable of supporting a 1,000,000-token context window. However, Cline defaults to a 128,000-token (128k) context window for OpenAI-compatible providers. This can significantly limit the assistant's capabilities and may cause context truncation or compaction issues. You can manually configure Cline to use the full 1,000,000-token context window for better results. To do this, follow these steps:

  1. In VS Code, open the activity bar and click the Cline extension.

  2. At the top of the Cline panel, click the gear icon to open the provider and model configuration.

  3. In the Model Configuration section, locate the Model Context Window or Context Window Size setting.

  4. Change the value from 128000 (128k) to 1000000 (1M).

  5. Click Done to save the changes.

Model and provider configuration showing the Model Configuration section and the Context Window Size option.

For more information, see Cline Optimal Settings.

Why do I see 'Proxy: stopped' in the provider status bar?

Click the provider status bar to open the SuiteCloud Developer Assistant panel. Make sure your auth ID resolves correctly and the required port isn't blocked or unavailable.

Open the SuiteCloud Developer panel and click Start. If the proxy does not start, inspect SuiteCloud Proxy logs and verify the auth ID, local port, network connection, and account prerequisites.

I see 'Port [port] is already being used'. What should I do?

Change the value in the Local port field of the SuiteCloud Developer Assistant panel (for example, to 8182), and try again.

To check which ports are already in use, you can run the following commands in your terminal or command prompt. This step can help you identify an available port, especially if you have trouble finding one that's free:

Windows:

              Get-NetTCPConnection -State Listen | Select-Object -ExpandProperty LocalPort

macOS and Linux:

              lsof -nP -iTCP -sTCP:LISTEN | awk '{print $9}' | sed 's/.*://'

I get an 'Account unreachable' error. What should I do?

Check the following:

  • VPN connection is active (if it's required)

  • Host and port are correct

  • The firewall is not blocking the connection

  • SuiteCloud Proxy is running

I get a 'PROXY ERROR'. What should I do?

If you're on a VPN and encounter proxy errors, your proxy configuration may require updating. Sometimes, a new or different proxy server must be used when connected to the VPN.

Check the following:

  • Refresh your http_proxy environment variable to ensure it points to the correct proxy for your VPN. For example, http://proxy.example.com:8080. Obtain the correct proxy URL from your organization's network administrator.

  • If permitted by your organization, compare behavior inside and outside the VPN to determine whether the VPN or proxy configuration is involved.

  • If Cline works with other providers but not SuiteCloud, double-check your configuration specifically for SuiteCloud.

I get an 'ERR_INVALID_URL' error. What should I do?

Restart VS Code. If the Configure button is visible in the Cline extension, click it to apply the base URL along with the other Cline settings.

If the error persists, expand API Provider Configuration, copy the configuration details, and enter them manually in Cline.

For more information, see Setting Up SuiteCloud Developer Assistant Using Cline in SuiteCloud Extension for VS Code.

Related Topics

General Notices