Zig Requires Chilkat v11.4.0+
Zig
Demonstrates Manual Tool Function Calls
See more AI Examples
Demonstrates how to do manual tool function calling using Chilkat. This is where your application manually checks for function calls in the AI's response, makes the function calls, and returns the function call results to the AI.Chilkat Zig Downloads
const std = @import("std");
const chilkat = @import("chilkat");
pub fn main(init: std.process.Init) !void {
const alloc = init.arena.allocator();
// Create the following JSON to define tool functions available for the AI to use.
// Note: You'll use the following JSON format regardless of the AI provider, whether
// it be ChatGPT, Gemini, Claude, Grok, etc. Chilkat automatically converts to the required
// format needed for a given AI provider.
// In this example, the application is providing two functions the AI may choose to call.
// {
// "tools": [
// {
// "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_compatibility",
// "description": "Returns compatibility analysis between two zodiac signs, including a score and explanation.",
// "parameters": {
// "properties": {
// "sign1": {
// "type": "string",
// "description": "The first zodiac sign (e.g., Aries, Taurus, Gemini)."
// },
// "sign2": {
// "type": "string",
// "description": "The second zodiac sign (e.g., Aries, Taurus, Gemini)."
// },
// "relationship_type": {
// "type": "string",
// "description": "Type of compatibility to evaluate. (e.g., romantic, friendship, professional, general)"
// },
// "detail_level": {
// "type": "string",
// "description": "Level of detail in the response. (e.g., short, medium, detailed)"
// }
// }
// }
// }
// ]
// }
const json_tools = try chilkat.JsonObject.init();
defer json_tools.deinit();
var tool_idx: i32 = 0;
json_tools.setI(tool_idx);
json_tools.updateString("tools[i].name", "get_horoscope") catch {};
json_tools.updateString("tools[i].description", "Get today's horoscope for an astrological sign.") catch {};
json_tools.updateString("tools[i].parameters.properties.sign.type", "string") catch {};
json_tools.updateString("tools[i].parameters.properties.sign.description", "An astrological sign like Taurus or Aquarius") catch {};
tool_idx = tool_idx + 1;
json_tools.setI(tool_idx);
json_tools.updateString("tools[i].name", "get_compatibility") catch {};
json_tools.updateString("tools[i].description", "Returns compatibility analysis between two zodiac signs, including a score and explanation.") catch {};
json_tools.updateString("tools[i].parameters.properties.sign1.type", "string") catch {};
json_tools.updateString("tools[i].parameters.properties.sign1.description", "The first zodiac sign (e.g., Aries, Taurus, Gemini).") catch {};
json_tools.updateString("tools[i].parameters.properties.sign2.type", "string") catch {};
json_tools.updateString("tools[i].parameters.properties.sign2.description", "The second zodiac sign (e.g., Aries, Taurus, Gemini).") catch {};
json_tools.updateString("tools[i].parameters.properties.relationship_type.type", "string") catch {};
json_tools.updateString("tools[i].parameters.properties.relationship_type.description", "Type of compatibility to evaluate. (e.g., romantic, friendship, professional, general)") catch {};
json_tools.updateString("tools[i].parameters.properties.detail_level.type", "string") catch {};
json_tools.updateString("tools[i].parameters.properties.detail_level.description", "Level of detail in the response. (e.g., short, medium, detailed)") catch {};
// More tools can be added as desired..
json_tools.setEmitCompact(false);
std.debug.print("{s}\n", .{try json_tools.emit(alloc)});
const ai = try chilkat.Ai.init();
defer ai.deinit();
// Register the tools that will be made available to the AI.
ai.registerManualTools(json_tools) 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 = "convo_astrology";
const sys_message = "You are a helpful astrologer";
const dev_message = "Respond only with a horoscope generated by a tool. Use the tool output as the final answer.";
ai.newConvo(conversation_name, sys_message, dev_message) catch {};
// Provide inputs
ai.inputAddText("What is my horoscope? I am an Aquarius.") catch {};
// Send inputs, tool functions, etc. and ask for a "text" response.
ai.ask("text") catch {
std.debug.print("{s}\n", .{try ai.getLastErrorText(alloc)});
return;
};
// Did the AI respond with requests for tool function calls?
if (ai.getHasFunctionCalls()) {
const json_fn = try chilkat.JsonObject.init();
defer json_fn.deinit();
json_fn.setEmitCompact(false);
ai.getFunctionCalls(json_fn) catch {};
std.debug.print("{s}\n", .{try json_fn.emit(alloc)});
// Note: Chilkat will convert responses from all AI providers to this format:
// {
// "function_call": [
// {
// "name": "get_horoscope",
// "call_id": "call_RYmeysYQFocFc7Z2ofkv61dW",
// "arguments": "{\"sign\":\"Aquarius\"}",
// "args": {
// "sign": "Aquarius"
// }
// }
// ]
// }
const num_fn_calls = json_fn.sizeOfArray("function_call");
var fn_idx: i32 = 0;
while (fn_idx < num_fn_calls) {
json_fn.setI(fn_idx);
const sb_fn_name = try chilkat.StringBuilder.init();
defer sb_fn_name.deinit();
json_fn.stringOfSb("function_call[i].name", sb_fn_name) catch {};
const call_id = try json_fn.stringOf(alloc, "function_call[i].call_id");
if (sb_fn_name.contentsEqual("get_horoscope", true)) {
// The get_horoscope function (as defined above) has one argument named "sign".
const zodiac_sign = try json_fn.stringOf(alloc, "function_call[i].args.sign");
std.debug.print("zodiac_sign = {s}\n", .{zodiac_sign});
// Insert application code here to call your app's get_horoscope function, passing the zodiac_sign to it..
// For this example, we'll pretend the app's get_horoscope function returned the following:
const application_fn_call_result = "Aquarius: Next Tuesday you will befriend a baby otter.";
// Provide the tool call result as an input for the followup Ask.
ai.inputAddFnResult(call_id, application_fn_call_result) catch {};
}
// Your application would add code to check for and handle each possible function call.
fn_idx = fn_idx + 1;
}
// After making the requested tool function calls, send the results back to the AI.
ai.ask("text") catch {
std.debug.print("{s}\n", .{try ai.getLastErrorText(alloc)});
return;
};
}
// Get the final 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)});
}