Objective-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. Objective-C

#import <CkoStringBuilder.h>
#import <CkoAi.h>
#import <NSString.h>

BOOL success = NO;

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

//  Load JavaScript containing the tool functions.
CkoStringBuilder *sbJs = [[CkoStringBuilder alloc] init];
success = [sbJs LoadFile: @"qa_data/js_tools/toolset_6.js" charset: @"utf-8"];
if (success == NO) {
    NSLog(@"%@",sbJs.LastErrorText);
    return;
}

CkoAi *ai = [[CkoAi alloc] init];

//  Register the tools that will be made available to the AI.
BOOL evalOnly = NO;
BOOL allowAllKeyword = YES;
[ai RegisterJsTools: sbJs evalOnly: evalOnly allowAllKeyword: allowAllKeyword];

//  The provider can be "openai", "google", "claude", "grok", "mistral", "custom", etc.
ai.Provider = @"openai";
//  Use your provider's API key.
ai.ApiKey = @"MY_API_KEY";
//  Choose a model.
ai.Model = @"gpt-5.6-luna";

//  Tool function calling must always occur within a conversation.
NSString *conversation_name = @"example_convo";
NSString *sysMessage = @"You are a helpful assistant";
NSString *devMessage = @"Respond with markdown";
[ai NewConvo: conversation_name sysMsg: sysMessage devMsg: devMessage];

//  Provide inputs
[ai InputAddText: @"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 = [ai Ask: @"text"];
if (success == NO) {
    NSLog(@"%@",ai.LastErrorText);
    return;
}

//  Get the AI response.
CkoStringBuilder *sbResponse = [[CkoStringBuilder alloc] init];
[ai GetOutputTextSb: sbResponse];
NSLog(@"%@",[sbResponse GetAsString]);

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