(Tcl) 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 Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

set success 0

# ----------------------------------------------------------------------------------
# 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.
set sbJs [new_CkStringBuilder]

set success [CkStringBuilder_LoadFile $sbJs "qa_data/js_tools/toolset_5.js" "utf-8"]
if {$success == 0} then {
    puts [CkStringBuilder_lastErrorText $sbJs]
    delete_CkStringBuilder $sbJs
    exit
}

set ai [new_CkAi]

# Additional JavaScript code can be loaded into the AI object's internal JS engine
# by calling RegisterJsTools with evalOnly = 1.
set sbExtraJs [new_CkStringBuilder]

CkStringBuilder_Append $sbExtraJs "function getOrderTotal({ order_id }) { return 149.95; }"

# When evalOnly equals 1, 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 = 1.
set evalOnly 1
set allowAllKeyword 1
CkAi_RegisterJsTools $ai $sbExtraJs $evalOnly $allowAllKeyword

# Register the tools that will be made available to the AI.
set evalOnly 0
CkAi_RegisterJsTools $ai $sbJs $evalOnly $allowAllKeyword

# The provider can be "openai", "google", "claude", "grok", "mistral", "custom", etc.
CkAi_put_Provider $ai "openai"
# Use your provider's API key.
CkAi_put_ApiKey $ai "MY_API_KEY"
# Choose a model.
CkAi_put_Model $ai "gpt-5-mini"

# Tool function calling must always occur within a conversation.
set conversation_name "convo_4"
set sysMessage "You are a helpful business assistant"
set devMessage "Respond only with a information generated by a tool."
CkAi_NewConvo $ai $conversation_name $sysMessage $devMessage

# Provide inputs
CkAi_InputAddText $ai "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.
set success [CkAi_Ask $ai "text"]
if {$success == 0} then {
    puts [CkAi_lastErrorText $ai]
    delete_CkStringBuilder $sbJs
    delete_CkAi $ai
    delete_CkStringBuilder $sbExtraJs
    exit
}

# Get the AI response.
set sbResponse [new_CkStringBuilder]

CkAi_GetOutputTextSb $ai $sbResponse
puts [CkStringBuilder_getAsString $sbResponse]

delete_CkStringBuilder $sbJs
delete_CkAi $ai
delete_CkStringBuilder $sbExtraJs
delete_CkStringBuilder $sbResponse

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