File Coverage

blib/lib/SignalWire/Agents/Skills/Builtin/WeatherApi.pm

Criterion	Covered	Total	%
statement	23	23	100.0
branch	6	6	100.0
condition	6	6	100.0
subroutine	7	7	100.0
pod	0	3	0.0
total	42	45	93.3

package SignalWire::Agents::Skills::Builtin::WeatherApi;
use strict;
use warnings;
use Moo;
extends 'SignalWire::Agents::Skills::SkillBase';

use SignalWire::Agents::Skills::SkillRegistry;
SignalWire::Agents::Skills::SkillRegistry->register_skill('weather_api', __PACKAGE__);

has '+skill_name'        => (default => sub { 'weather_api' });
has '+skill_description' => (default => sub { 'Get current weather information from WeatherAPI.com' });
has '+supports_multiple_instances' => (default => sub { 0 });

sub setup { 1 }

sub register_tools {
    my ($self) = @_;
    my $tool_name = $self->params->{tool_name} // 'get_weather';
    my $api_key   = $self->params->{api_key}   // '';
    my $unit      = $self->params->{temperature_unit} // 'fahrenheit';

    my $temp_field = $unit eq 'celsius' ? 'temp_c' : 'temp_f';
    my $feels_field = $unit eq 'celsius' ? 'feelslike_c' : 'feelslike_f';
    my $unit_label  = $unit eq 'celsius' ? 'C' : 'F';

    $self->agent->register_swaig_function({
        function    => $tool_name,
        description => 'Get current weather information for any location',
        parameters  => {
            type       => 'object',
            properties => {
                location => { type => 'string', description => 'Location to get weather for' },
            },
            required => ['location'],
        },
        data_map => {
            webhooks => [{
                method => 'GET',
                url    => "https://api.weatherapi.com/v1/current.json?key=${api_key}&q=\${lc:enc:args.location}&aqi=no",
                output => {
                    response => "Temperature: \${current.${temp_field}}${unit_label}, "
                              . "Feels like: \${current.${feels_field}}${unit_label}, "
                              . "Condition: \${current.condition.text}, "
                              . "Humidity: \${current.humidity}%, "
                              . "Wind: \${current.wind_mph} mph",
                },
            }],
        },
    });
}

sub get_parameter_schema {
    return {
        %{ SignalWire::Agents::Skills::SkillBase->get_parameter_schema },
        api_key          => { type => 'string', required => 1, hidden => 1 },
        tool_name        => { type => 'string', default => 'get_weather' },
        temperature_unit => { type => 'string', enum => ['fahrenheit', 'celsius'], default => 'fahrenheit' },
    };
}

1;