support for multiple tool calls

CHANGELOG.md

@@ -21,3 +21,6 @@
 
 ## [0.4.3] - 2024-11-11
 - adds support for `Predicate` module
+
+## [0.4.4] - 2024-11-11
+- adds support for multiple tool calls in a single response

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    raix (0.4.3)
+    raix (0.4.4)
       activesupport (>= 6.0)
       open_router (~> 0.2)
       ruby-openai (~> 7.0)

README.md

@@ -101,6 +101,30 @@ RSpec.describe WhatIsTheWeather do
 end
 ```
 
+#### Multiple Tool Calls
+
+Some AI models (like GPT-4) can make multiple tool calls in a single response. When this happens, Raix will automatically handle all the function calls sequentially and return an array of their results. Here's an example:
+
+```ruby
+class MultipleToolExample
+  include Raix::ChatCompletion
+  include Raix::FunctionDispatch
+
+  function :first_tool do |arguments|
+    "Result from first tool"
+  end
+
+  function :second_tool do |arguments|
+    "Result from second tool"
+  end
+end
+
+example = MultipleToolExample.new
+example.transcript << { user: "Please use both tools" }
+results = example.chat_completion(openai: "gpt-4o")
+# => ["Result from first tool", "Result from second tool"]
+```
+
 #### Manually Stopping a Loop
 
 To loop AI components that don't interact with end users, at least one function block should invoke `stop_looping!` whenever you're ready to stop processing.

lib/raix/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Raix
-  VERSION = "0.4.3"
+  VERSION = "0.4.4"
 end