API-1019 Error Cannot invoke "Object.toString()" because "content" is null on Azure

Products

Clarity PPM SaaS

Issue/Introduction

Steps To Reproduce
1. Enable Clarity VAIA referenced here

2. Go to Modern > Administration > VAIA > AI Models
Validate a model by right-clicking it and click Validate Model

3. Go to Modern > Administration > VAIA > AI Agents
Create an agent on the project object at the workspace level.

4. Go to Projects workspace and click on VAIA icon/or custom branding.

5. In the chat panel that appears, enter a prompt and submit.

Expected: AI response should occur, loading the chat panel with content .

Actual:
Generic API-1019 Error appears
Responses do not get generated.

APP log shows:
ERROR 2026-04-01 13:13:43,569 [http-nio-8080-exec-1150] ppm.rest (clarity:user:session:PPM_REST_API) (39d42c4b-1e8e-4688-b9a7-bf2a773cd2dd) Exception processing request for resource [generateContents], query string [/private/generateContents]
java.lang.NullPointerException: Cannot invoke "Object.toString()" because "content" is null
               at com.ca.ppm.nmc.integration.genai.GenAIOpenAIRequestHandler.handleConversation(GenAIOpenAIRequestHandler.java:410)
               at com.ca.ppm.nmc.integration.genai.GenAIOpenAIRequestHandler.constructPayload(GenAIOpenAIRequestHandler.java:90)
               at com.ca.ppm.nmc.rest.GenerateContentsResource.generateContents(GenerateContentsResource.java:260)
               at com.ca.ppm.nmc.rest.GenerateContentsResource.create(GenerateContentsResource.java:120)
               at com.ca.ppm.rest.provider.FunctionResourceProvider.createResource(FunctionResourceProvider.java:168)
               at com.ca.ppm.rest.provider.FunctionResourceProvider.createEntity(FunctionResourceProvider.java:140)
               at com.ca.ppm.rest.resource.BaseResourceHandler.createResource(BaseResourceHandler.java:574)
               at com.ca.ppm.rest.resource.BaseResourceHandler.createResource(BaseResourceHandler.java:313)
               at com.ca.ppm.rest.resource.ResourceHandler.postResource(ResourceHandler.java:344)
               at jdk.internal.reflect.GeneratedMethodAccessor311.invoke(Unknown Source)

Environment

16.4.1 with Azure AI

Cause

The reason your URL isn't working is that it's only the base endpoint. To actually process a request, Azure AI services require a structured path appended to that base URL, which usually targets a specific deployment, project, and API version.

Resolution

Depending on whether you are using Azure OpenAI or the newer Azure AI Foundry (formerly Azure AI Studio), the exact format changes. We can create the URL by stitching it together, or there is a way to retrieve it.

If you are using Azure AI Foundry / Cognitive Services

Open the Resource: Go to the Azure Portal, navigate to your openai-foundrydev resource.
Launch the Studio: On the resource Overview page, click the Go to Azure AI Foundry portal (or Azure OpenAI Studio) button.
Navigate to the Deployment: In the left-hand navigation menu of the AI portal, click on Deployments, then click on the specific deployment you intend to use.
Open the Playground: Click the Open in Playground button at the top of the deployment screen to launch the Chat Playground.
Extract the Code: At the top right of the Chat Playground panel, click the View Code button.
Switch to cURL: In the sample code dropdown, change the language selection to curl.
Copy the URL: Look inside the curl command block. You will find the exact, fully constructed endpoint URL right after the text curl.

Examples:

Target Endpoint URL Protocol: https://{your-resource-name}.openai.azure.com/openai/deployments/{your-deployment-name}/chat/completions?api-version={version}
Live Example Target: https://clarity-openai-foundrydev.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/chat/completions?api-version=2024-10-21

Use this URL in the Integration URL - Save, Clear caches and test again

If this still does not work, plaese ensure you follow the set up exactly as described here: VAIA setup with Azure