Tool Calling

final timeTool = Tool(
  name: 'get_time',
  description: 'Get current time in a location',
  inputSchema: Schema.fromMap({
    'type': 'object',
    'properties': {
      'location': {'type': 'string'},
    },
    'required': ['location'],
  }),
  onCall: (args) async {
    // NOTE: insert actual timezone magic here
    return {
      'time': '3:42 PM',
      'location': args['location'],
    };
  },
);

final agent = Agent('openai', tools: [timeTool]);
final result = await agent.send("What time is it in New York?");
print(result.output); // "It's currently 3:42 PM in New York"

final currentTimeTool = Tool(
  name: 'get_current_time',
  description: 'Get the current date and time',
  onCall: (_) => DateTime.now().toIso8601String(),
);

final agent = Agent('openai', tools: [currentTimeTool]);
final result = await agent.send("What time is it?");

final agent = Agent('anthropic', tools: [
  weatherTool,
  temperatureConverterTool,
  currentDateTimeTool,
]);

// Single request, multiple tool calls
final result = await agent.send(
  "What's the weather in Paris? Convert to Fahrenheit and tell me the time."
);
// Agent calls all three tools automatically

await for (final chunk in agent.sendStream(
  "Weather in NYC and Boston?",
)) {
  stdout.write(chunk.output); // Streams response as tools execute
}

final tool = Tool(
  name: 'divide',
  description: 'Divide numbers',
  inputSchema: Schema.fromMap({
    'type': 'object',
    'properties': {
      'a': {'type': 'number'},
      'b': {'type': 'number'},
    },
    'required': ['a', 'b'],
  }),
  onCall: (args) async {
    if (args['b'] == 0) throw 'Cannot divide by zero';
    return {'result': args['a'] / args['b']};
  },
);

@JsonSerializable(createJsonSchema: true)
class WeatherInput {
  WeatherInput({required this.city});

  /// The city to get weather for
  final String city;

  factory WeatherInput.fromJson(Map<String, dynamic> json) =>
      _$WeatherInputFromJson(json);

  static const schemaMap = _$WeatherInputJsonSchema;
}

// Use the generated schema
final weatherTool = Tool(
  name: 'get_weather',
  description: 'Get weather for a city',
  inputSchema: Schema.fromMap(WeatherInput.schemaMap),
  onCall: (args) async {
    final input = WeatherInput.fromJson(args);
    return {'temp': 72, 'city': input.city};
  },
);