(Unicode C++) Azure AI Foundry Query

This is the simplest example of using Chilkat with Azure AI Foundry.

Note: This example requires Chilkat v11.3.0 or greater.

Chilkat C/C++ Library Downloads
MS Visual C/C++ C++ Builder Linux C/C++ Alpine Linux C/C++	MacOS C/C++ iOS C/C++ Android C/C++ MinGW C/C++

#include <CkAiW.h>
#include <CkJsonObjectW.h>
#include <CkStringBuilderW.h>

void ChilkatSample(void)
    {
    bool success = false;

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkAiW ai;

    // Before running the code, ensure the following prerequisites for App Registration in Microsoft Entra ID for Azure AI Foundry:
    // 1. Register an app for Azure AI Foundry.
    // 2. Assign an IAM Role to the resource to enable OAuth2 Client-Credentials for calling Azure AI Foundry.

    // For Azure AI Foundry we use "custom".
    ai.put_Provider(L"custom");

    // The base URL format for the Chat Completions API when using the cognitiveservices.azure.com domain is:
    // https://{resource-name}.cognitiveservices.azure.com/openai/deployments/{deployment-id}/chat/completions?api-version={api-version}

    // The string "{deployment}" in the base URL is dynamically replaced with the selected AI model each time a request is sent.
    // In this case, the chosen model (below) is "gpt-4o".  After substitution the base URL becomes: 
    // https://chilkat.cognitiveservices.azure.com/openai/deployments/gpt-4o/chat/completions?api-version=2025-01-01-preview

    // In this example, our resource name is "chilkat", and the api-version is "2025-01-01-preview"
    ai.put_BaseUrl(L"https://chilkat.cognitiveservices.azure.com/openai/deployments/{deployment}/chat/completions?api-version=2025-01-01-preview");
    ai.put_ApiSpec(L"ChatCompletions");

    // Use your provider's API key.
    ai.put_ApiKey(L"MY_API_KEY");

    // Set Azure Foundry specific params.
    CkJsonObjectW azureParams;

    // The tenant ID is a GUID such as 17280f2d-f709-4a7b-af1d-9928190e13cf
    azureParams.UpdateString(L"azure.tenantId",L"TENANT_ID");

    // The client ID is a GUID such as 4abd4bf6-5260-4795-90f6-1e91ce4f582c
    azureParams.UpdateString(L"azure.clientId",L"CLIENT_ID");

    // Such as UZc8Q~YBrRIgfe_zbAOwWV.8ikuHa3JJF7LvCdt.  (this is not a GUID)
    azureParams.UpdateString(L"azure.clientSecret",L"CLIENT_SECRET");

    // The subscription ID is a GUID such as 4abd4bf6-5260-4795-90f6-1e91ce4f582c
    azureParams.UpdateString(L"azure.subscription",L"SUBSCRIPTION_ID");

    // Such as eastus
    azureParams.UpdateString(L"azure.location",L"LOCATION");

    // With the Azure-specific provider params specified,
    // Chilkat will internally fetch the OAuth2 access token using client credentials as needed.
    ai.SetProviderParams(azureParams);

    // Choose a model.
    ai.put_Model(L"gpt-4o");

    // Add a text input.
    ai.InputAddText(L"Say Hello.");

    // Ask the AI for text output.
    success = ai.Ask(L"text");
    if (success == false) {
        wprintf(L"%s\n",ai.lastErrorText());
        return;
    }

    // Get the text response.
    CkStringBuilderW sbResponse;
    ai.GetOutputTextSb(sbResponse);
    wprintf(L"%s\n",sbResponse.getAsString());

    // Sample output:
    // Hello! How can I assist you today?

    // -------------------------------------------------------------
    // The response is in markdown format.
    // Also see Markdown to HTML Conversion Examples.
    // -------------------------------------------------------------
    }