Zig Requires Chilkat v11.4.0+

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. Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

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

    // Load JavaScript containing the tool functions.
    const sb_js = try chilkat.StringBuilder.init();
    defer sb_js.deinit();
    sb_js.loadFile("qa_data/js_tools/toolset_6.js", "utf-8") catch {
        std.debug.print("{s}\n", .{try sb_js.getLastErrorText(alloc)});
        return;
    };

    const ai = try chilkat.Ai.init();
    defer ai.deinit();

    // Register the tools that will be made available to the AI.
    const eval_only = false;
    const allow_all_keyword = true;
    ai.registerJsTools(sb_js, eval_only, allow_all_keyword) catch {};

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

    // Tool function calling must always occur within a conversation.
    const conversation_name = "example_convo";
    const sys_message = "You are a helpful assistant";
    const dev_message = "Respond with markdown";
    ai.newConvo(conversation_name, sys_message, dev_message) catch {};

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

    // 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.
    ai.ask("text") catch {
        std.debug.print("{s}\n", .{try ai.getLastErrorText(alloc)});
        return;
    };

    // Get the AI response.
    const sb_response = try chilkat.StringBuilder.init();
    defer sb_response.deinit();
    ai.getOutputTextSb(sb_response) catch {};
    std.debug.print("{s}\n", .{try sb_response.getAsString(alloc)});
}

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";