(Java) Automatic JS AI Tool Calling with Supporting JS Sources

See more AI Examples

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

For more information, see https://www.chilkatsoft.com/ai_javascript_tool_function_calling.asp

Chilkat Java Downloads Java Libs for Windows, MacOS, Linux, Alpine Linux Java Libs for Android

import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

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

    // In this example, we'll load the Javascript tool functions and registry from a file.
    CkStringBuilder sbJs = new CkStringBuilder();
    success = sbJs.LoadFile("qa_data/js_tools/toolset_5.js","utf-8");
    if (success == false) {
        System.out.println(sbJs.lastErrorText());
        return;
        }

    CkAi ai = new CkAi();

    // Additional JavaScript code can be loaded into the AI object's internal JS engine
    // by calling RegisterJsTools with evalOnly = true.
    CkStringBuilder sbExtraJs = new CkStringBuilder();
    sbExtraJs.Append("function getOrderTotal({ order_id }) { return 149.95; }");

    // When evalOnly equals true, it tells Chilkat that no toolRegistry will be present.
    // The purpose for doing the eval is to add function definitions to the global namespace.
    // The value passed for allowAllKeyword is meaningless (not used) when evalOnly = true.
    boolean evalOnly = true;
    boolean allowAllKeyword = true;
    ai.RegisterJsTools(sbExtraJs,evalOnly,allowAllKeyword);

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

    // The provider can be "openai", "google", "claude", "grok", "mistral", "custom", etc.
    ai.put_Provider("openai");
    // Use your provider's API key.
    ai.put_ApiKey("MY_API_KEY");
    // Choose a model.
    ai.put_Model("gpt-5-mini");

    // Tool function calling must always occur within a conversation.
    String conversation_name = "convo_4";
    String sysMessage = "You are a helpful business assistant";
    String devMessage = "Respond only with a information generated by a tool.";
    ai.NewConvo(conversation_name,sysMessage,devMessage);

    // Provide inputs
    ai.InputAddText("What is the total for order A123?");

    // 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 = ai.Ask("text");
    if (success == false) {
        System.out.println(ai.lastErrorText());
        return;
        }

    // Get the AI response.
    CkStringBuilder sbResponse = new CkStringBuilder();
    ai.GetOutputTextSb(sbResponse);
    System.out.println(sbResponse.getAsString());
  }
}

// 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 names used here must match the "name" in the toolRegistry below.

Example.get_order_total = function(arg) {
  // Here we are calling another function that is defined in a support (additional) JavaScript source
  // that was loaded in previous call to Ai.RegisterJsTools with evalOnly = true.
  return getOrderTotal(arg);
}

Example.multiply_numbers = function(arg) {
  return arg.a * arg.b;
}

// The inputSchema.type must ALWAYS be "object".
Example.toolRegistry = [
  {
    name: "get_order_total",
    description: "Calculate total cost of an order",
    parameters: {
      properties: {
        order_id: { type: "string", description: "The order ID" },
      }
    }
  },
  {
    name: "multiply_numbers",
    description: "Multiplies two numbers and returns the product.",
    parameters: {
      properties: {
        a: { type: "number", description: "First number" },
        b: { type: "number", description: "Second number" }
      }
    }
  }
];


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