Tool calling from Rails models

Direct answer

Safe tool design

• Pass explicit IDs from trusted context
• Authorize the acting user or workspace
• Return structured errors the agent can recover from
• Prefer read tools before write tools
• Require approvals for irreversible writes

Code shape

class OrdersTool < RailsAgents::Tool
  description "Look up an order by number for the current account"

  def call(order_number:)
    order = Current.account.orders.find_by!(number: order_number)
    { status: order.status, total: order.total_cents }
  end
end

Frequently asked questions