Skills

1
import { AgentBase, DateTimeSkill, WebSearchSkill } from '@signalwire/sdk';
2
3
const agent = new AgentBase({ name: 'my-agent', route: '/' });
4
5
agent.setPromptText('You are a helpful assistant.');
6
7
// No-config skill
8
await agent.addSkill(new DateTimeSkill());
9
10
// Skill with parameters
11
await agent.addSkill(new WebSearchSkill({
12
  num_results: 5,
13
  safe_search: 'high',
14
}));
15
16
agent.run();

1
import { WebSearchSkill } from '@signalwire/sdk';
2
3
// Direct configuration
4
const skill = new WebSearchSkill({ num_results: 5, safe_search: 'high' });
5
6
// Environment variable fallback (api_key falls back to GOOGLE_SEARCH_API_KEY,
7
// search_engine_id falls back to GOOGLE_SEARCH_CX)
8
process.env.GOOGLE_SEARCH_API_KEY = 'YOUR_KEY';
9
process.env.GOOGLE_SEARCH_CX = 'YOUR_ENGINE_ID';
10
const skillWithEnv = new WebSearchSkill({ num_results: 5 });

1
import { AgentBase, DateTimeSkill } from '@signalwire/sdk';
2
3
const agent = new AgentBase({ name: 'assistant', route: '/assistant' });
4
agent.setPromptText('You are a helpful assistant.');
5
6
await agent.addSkill(new DateTimeSkill({
7
  swaig_fields: {
8
    fillers: { 'en-US': ['Let me check the time...', 'One moment...'] },
9
    secure: false,
10
  },
11
}));
12
13
agent.run();

1
import { AgentBase, DataSphereSkill } from '@signalwire/sdk';
2
3
const agent = new AgentBase({ name: 'assistant', route: '/assistant' });
4
agent.setPromptText('You are a helpful assistant.');
5
6
await agent.addSkill(new DataSphereSkill({
7
  tool_name: 'search_products',
8
  document_id: 'doc_products',
9
  count: 3,
10
}));
11
await agent.addSkill(new DataSphereSkill({
12
  tool_name: 'search_policies',
13
  document_id: 'doc_policies',
14
  count: 5,
15
}));
16
17
agent.run();

1
import { SkillBase, FunctionResult } from '@signalwire/sdk';
2
import type {
3
  SkillToolDefinition,
4
  SkillPromptSection,
5
  ParameterSchemaEntry,
6
} from '@signalwire/sdk';
7
8
export class StockPriceSkill extends SkillBase {
9
  // Identity is declared with static class constants.
10
  static override SKILL_NAME = 'stock_price';
11
  static override SKILL_DESCRIPTION = 'Look up current stock prices.';
12
  static override SKILL_VERSION = '1.0.0';
13
  static override REQUIRED_ENV_VARS = ['STOCK_API_KEY'] as const;
14
15
  static override getParameterSchema(): Record<string, ParameterSchemaEntry> {
16
    return {
17
      ...super.getParameterSchema(),
18
      api_key: {
19
        type: 'string',
20
        description: 'Stock API key.',
21
        hidden: true,
22
        env_var: 'STOCK_API_KEY',
23
        required: true,
24
      },
25
    };
26
  }
27
28
  override getTools(): SkillToolDefinition[] {
29
    return [
30
      {
31
        name: 'get_stock_price',
32
        description: 'Get the current price of a stock by ticker symbol.',
33
        parameters: {
34
          symbol: {
35
            type: 'string',
36
            description: 'Stock ticker symbol (e.g., "AAPL", "GOOG").',
37
          },
38
        },
39
        required: ['symbol'],
40
        handler: async (args: Record<string, unknown>) => {
41
          const symbol = args.symbol as string;
42
          // Your implementation here
43
          return new FunctionResult(
44
            'The current price of ' + symbol + ' is $150.00.',
45
          );
46
        },
47
      },
48
    ];
49
  }
50
51
  protected override _getPromptSections(): SkillPromptSection[] {
52
    return [
53
      {
54
        title: 'Stock Prices',
55
        body: 'You can look up current stock prices.',
56
        bullets: [
57
          'Use the get_stock_price tool when the user asks about a stock price.',
58
          'Provide the stock ticker symbol (e.g., AAPL for Apple).',
59
        ],
60
      },
61
    ];
62
  }
63
}

1
import { SkillRegistry } from '@signalwire/sdk';
2
import { StockPriceSkill } from './stock-price-skill.js';
3
4
const registry = SkillRegistry.getInstance();
5
registry.register(StockPriceSkill); // pass the class; name comes from SKILL_NAME

1
import { AgentBase } from '@signalwire/sdk';
2
import { StockPriceSkill } from './stock-price-skill.js';
3
4
const agent = new AgentBase({ name: 'finance-bot', route: '/' });
5
agent.setPromptText('You are a financial assistant.');
6
7
await agent.addSkill(new StockPriceSkill());
8
9
agent.run();