Unicode C

AI Ask with Multiple Tool Function Callbacks

See more AI Examples

This example demonstrates asking a two-part question that should cause the AI to respond with two tool call requests. Unicode C

#include <C_CkStringBuilderW.h>
#include <C_CkAiW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkStringBuilderW sbJs;
    HCkAiW ai;
    BOOL evalOnly;
    BOOL allowAllKeyword;
    const wchar_t *conversation_name;
    const wchar_t *sysMessage;
    const wchar_t *devMessage;
    HCkStringBuilderW sbResponse;

    success = FALSE;

    //  ----------------------------------------------------------------------------------
    //  The Javascript file loaded here is shown at the bottom of this page.
    //  -----------------------------------------------------------------------------------

    //  Load JavaScript containing the tool functions.
    sbJs = CkStringBuilderW_Create();
    success = CkStringBuilderW_LoadFile(sbJs,L"qa_data/js_tools/toolset_6.js",L"utf-8");
    if (success == FALSE) {
        wprintf(L"%s\n",CkStringBuilderW_lastErrorText(sbJs));
        CkStringBuilderW_Dispose(sbJs);
        return;
    }

    ai = CkAiW_Create();

    //  Register the tools that will be made available to the AI.
    evalOnly = FALSE;
    allowAllKeyword = TRUE;
    CkAiW_RegisterJsTools(ai,sbJs,evalOnly,allowAllKeyword);

    //  The provider can be "openai", "google", "claude", "grok", "mistral", "custom", etc.
    CkAiW_putProvider(ai,L"openai");
    //  Use your provider's API key.
    CkAiW_putApiKey(ai,L"MY_API_KEY");
    //  Choose a model.
    CkAiW_putModel(ai,L"gpt-5.6-luna");

    //  Tool function calling must always occur within a conversation.
    conversation_name = L"example_convo";
    sysMessage = L"You are a helpful assistant";
    devMessage = L"Respond with markdown";
    CkAiW_NewConvo(ai,conversation_name,sysMessage,devMessage);

    //  Provide inputs
    CkAiW_InputAddText(ai,L"What is my horoscope? I am an Aquarius.  Also, what's the weather in Chicago?");

    //  Send inputs, tool functions, etc. and ask for a "text" response.
    //  If the AI responds with tool calls, Chilkat automatically handles them by calling your JavaScript
    //  tool functions as directed by the AI, and sending results back to the AI until the final
    //  response is received.
    success = CkAiW_Ask(ai,L"text");
    if (success == FALSE) {
        wprintf(L"%s\n",CkAiW_lastErrorText(ai));
        CkStringBuilderW_Dispose(sbJs);
        CkAiW_Dispose(ai);
        return;
    }

    //  Get the AI response.
    sbResponse = CkStringBuilderW_Create();
    CkAiW_GetOutputTextSb(ai,sbResponse);
    wprintf(L"%s\n",CkStringBuilderW_getAsString(sbResponse));


    CkStringBuilderW_Dispose(sbJs);
    CkAiW_Dispose(ai);
    CkStringBuilderW_Dispose(sbResponse);

    }

JavaScript

// The namespace for the AI tool functions in this JavaScript source file.
Example = {};

// Tool functions must have only one argument, which should be an object.

// The function name used here must match the "name" in the toolRegistry below.
Example.get_weather = function(arg) {
  return {
	  "temperature": 45,
	  "unit": "F",
	  "conditions": "Cloudy"
	};
}

Example.get_horoscope = function(arg) {
  return  `${arg.sign} : Next Tuesday you will befriend a baby otter.`;
}



// The inputSchema.type must ALWAYS be "object".
Example.toolRegistry = [
  {
    name: "get_horoscope",
    description: "Get today's horoscope for an astrological sign.",
    parameters: {
      properties: {
        sign: { type: "string", description: "An astrological sign like Taurus or Aquarius" }
      }
    }
  },
  {
    name: "get_weather",
    description: "Gets the weather at a location.",
    parameters: {
      properties: {
        location: { type: "string", description: "Location such as a city name." },
      }
    }
  }
];


Example.toolPermissions = [
	  {
	    name: "all",
	    perm: "sandbox",
	  }
	  		
	];
	
	
// Return the name of this toolset
// This tells Chilkat the namespace of this toolset.
"Example";