SignalWire AI Agents Ruby SDK

A Ruby framework for building, deploying, and managing AI agents as microservices that interact with the SignalWire platform.

• Agent Framework — Build AI agents with structured prompts, tools, and skills
• SWML Generation — Automatic SWML document creation for the SignalWire AI platform
• SWAIG Functions — Define tools the AI can call during conversations
• DataMap Tools — Server-side API integrations without webhook infrastructure
• Contexts & Steps — Structured multi-step conversation workflows
• Skills System — Modular, reusable capabilities (datetime, math, web search, etc.)
• Prefab Agents — Ready-to-use agent patterns (surveys, reception, FAQ, etc.)
• Multi-Agent Hosting — Run multiple agents on a single server
• RELAY Client — Real-time WebSocket-based call control and messaging
• REST Client — Full SignalWire REST API access with typed resources
• Rack Compatible — Run standalone or mount in Rails, Sinatra, or any Rack app

require 'signalwire_agents'

agent = SignalWireAgents::AgentBase.new(name: 'my-agent')

agent.set_prompt_text("You are a helpful assistant.")

agent.define_tool(
  name: 'get_time',
  description: 'Get the current time',
  parameters: {}
) do |args, raw_data|
  SignalWireAgents::FunctionResult.new("The current time is #{Time.now}")
end

agent.run

gem install signalwire_agents

Or in your Gemfile:

gem 'signalwire_agents'

# config/routes.rb (Rails)
mount MyAgent.rack_app => '/agent'

# config.ru (Rack)
run MyAgent.rack_app

See the docs/ directory for comprehensive guides.

Copyright (c) SignalWire. All rights reserved.