smart_agent 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e36441cd494df0719fcfe3ecff04976392e091372706e04e65949c6d17f32e95
-  data.tar.gz: dabe51abbd3e8cb0b8184f042b32361a0a50fe9cbc4f7b86e8fa93b88ee222aa
+  metadata.gz: f34059e0f8389ab46e42221507a17545c3e5baf0ae63c5d7273018168f608d30
+  data.tar.gz: cf815b9c79556577b56328ef992dfa5f522871c4c805b8d7d1e8c24d24a45947
 SHA512:
-  metadata.gz: '09335af182cc6402c814098f1de24dbf62e5ef5187fb6297c3f4b2b301e04d8b37e1da242b0d7bb0ea55d42722ca90c7ce451fbdd7d7832ff84dd1f1f6643751'
-  data.tar.gz: 910c95df53d2564bc1f842c56925866d8ac255365c9329e7113450dbb9fffd9d8221d51c3c72e3342c4bbfec0b33bf79642eeb736457b188c76f4025cf96c71a
+  metadata.gz: 0a5ee8bc0ac6af2c198ba15d855b5fcdf181fb27cce922e7f0f649018e3aaa8ed3836723fa4cd2b41d3b1afa2806b679980a5e64a3fdecc33cddd596287ad861
+  data.tar.gz: 9da300c1c13c8c0828d92ccd2ae7caa3bb228be51439bab7dc6ab4211f22686d76f91a4c11fab56bd67d62b412dd375fb6ab294e4805b8fffd62105d95a25670

data/README.md

@@ -1,76 +1,89 @@
-# Smart Agent Framework
+# SmartAgent Framework
 
-[![Ruby Version](https://img.shields.io/badge/Ruby-3.2%2B-red)](https://www.ruby-lang.org)
-[![Gem Version](https://img.shields.io/gem/v/smart_agent)](https://rubygems.org/gems/smart_agent)
-[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+SmartAgent is an intelligent agent framework developed in Ruby, supporting tool calling and natural language interaction.
 
-An intelligent agent framework built on [smart_prompt](https://github.com/zhuangbiaowei/smart_prompt), featuring DSL definition, function calling and MCP protocol integration.
+## Features
 
-## Key Features
+- Supports defining smart agents (SmartAgent) and tools (Tool)
+- Built-in utility tools:
+  - Weather query (get_weather)
+  - Math calculations (get_sum)
+  - Code generation and execution (get_code)
+- Integrated with OpenDigger MCP service
+- Supports natural language interaction in both English and Chinese
+- Extensible tool system
 
-- **Declarative DSL** - Define agents and workflows using concise Ruby syntax
-- **Function Calling** - Seamless integration with LLM capabilities
-- **MCP Protocol** - Built-in Model Context Protocol support
-- **Task Orchestration** - Coordinate multiple agents for complex tasks
-- **Extensible Architecture** - Support custom functions and protocol handlers
+## Installation
+
+Ensure you have Ruby (>= 2.7) and Bundler installed:
+
+```bash
+gem install bundler
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+Or install the gem directly:
+
+```bash
+gem install smart_agent
+```
+
+## Usage Examples
 
-## Quick Start
+### Basic Usage
 
 ```ruby
 require 'smart_agent'
 
-SmartAgent.define :weather_bot do
-  result = call_worker(:weather, params, with_tools: true)
-  if result.call_tools? 
-    weather_result = call_tools(result)
-    return call_worker(:weather_summary, params, weather_result, with_tools: false)
-  else
-    return result
-  end
-end
+agent = SmartAgent.build_agent(:smart_bot, tools: [:get_code])
 
-SmartAgent::Tool.define :get_weather do |location, date|
-  param_define :location, "City or More Specific Address", :str
-  param_define :date, "Specific Date or Today or Tomorrow", :date
-  # Call the Weather API
-end
+# Weather query
+puts agent.please("What's the weather in Shanghai tomorrow?")
 
-engine = SmartPrompt::Engine.new("./config/llm_config.yml")
-SmartAgent.engine = engine
-agent = SmartAgent.create(:weather_bot, [:get_weather])
+# Math calculation
+puts agent.please("Calculate the sum of 130 and 51")
 
-puts agent.please("Get tomorrow's weather forecast in Shanghai")
+# Code generation and execution
+puts agent.please("Calculate the area of a triangle with base 132 and height 7.6 using a Ruby function")
 ```
 
-## Installation
+### Custom Tools
 
-Add to your Gemfile:
 ```ruby
-gem 'smart_agent'
+SmartAgent::Tool.define :my_tool do
+  param_define :param1, "Parameter description", :string
+  param_define :param2, "Another parameter", :integer
+  
+  if input_params
+    # Tool logic
+    "Processing result"
+  end
+end
 ```
 
-Then execute:
-```bash
-bundle install
-```
+## MCP Integration
 
-Or install directly:
-```bash
-gem install smart_agent
-```
+Supports getting GitHub project metrics via OpenDigger MCP service:
 
-## Documentation
+```ruby
+
+SmartAgent::MCPClient.define :opendigger do
+  type :stdio
+  command "node ~/open-digger-mcp-server/dist/index.js"
+end
 
-Full documentation available at: [docs.smartagent.dev](https://docs.smartagent.dev)
+puts agent.please("Query OpenRank metrics changes for Vue project on GitHub")
+```
 
 ## Contributing
 
-1. Fork the repository
-2. Create feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit changes (`git commit -m 'Add some amazing feature'`)
-4. Push branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+Issues and pull requests are welcome.
 
 ## License
 
-Released under the MIT License. See [LICENSE](LICENSE) for details.
+MIT License. See LICENSE file for details.

data/lib/smart_agent/agent.rb

@@ -87,10 +87,10 @@ module SmartAgent
       if @agent.on_event && with_tools == false
         SmartAgent.prompt_engine.call_worker_by_stream(name, params) do |chunk, _bytesize|
           if chunk.dig("choices", 0, "delta", "reasoning_content")
-            @agent.processor(:reasoning).call(chunk)
+            @agent.processor(:reasoning).call(chunk) if @agent.processor(:reasoning)
           end
           if chunk.dig("choices", 0, "delta", "content")
-            @agent.processor(:content).call(chunk)
+            @agent.processor(:content).call(chunk) if @agent.processor(:content)
           end
         end
       else
@@ -101,23 +101,23 @@ module SmartAgent
     end
 
     def call_tools(result)
-      @agent.processor(:tool).call({ :status => :start })
+      @agent.processor(:tool).call({ :status => :start }) if @agent.processor(:tool)
       SmartAgent.logger.info("call tools: " + result.to_s)
       results = []
       result.call_tools.each do |tool|
         tool_name = tool["function"]["name"].to_sym
         params = JSON.parse(tool["function"]["arguments"])
         if Tool.find_tool(tool_name)
-          @agent.processor(:tool).call({ :content => "ToolName is `#{tool_name}`" })
+          @agent.processor(:tool).call({ :content => "ToolName is `#{tool_name}`" }) if @agent.processor(:tool)
           results << Tool.new(tool_name).call(params)
         end
         if server_name = MCPClient.find_server_by_tool_name(tool_name)
-          @agent.processor(:tool).call({ :content => "MCP Server is `#{server_name}`, ToolName is `#{tool_name}`" })
+          @agent.processor(:tool).call({ :content => "MCP Server is `#{server_name}`, ToolName is `#{tool_name}`" }) if @agent.processor(:tool)
           results << MCPClient.new(server_name).call(tool_name, params)
         end
-        @agent.processor(:tool).call({ :content => " ... done\n" })
+        @agent.processor(:tool).call({ :content => " ... done\n" }) if @agent.processor(:tool)
       end
-      @agent.processor(:tool).call({ :status => :end })
+      @agent.processor(:tool).call({ :status => :end }) if @agent.processor(:tool)
       return results
     end
 

data/lib/smart_agent/tool.rb

@@ -63,5 +63,9 @@ module SmartAgent
     def param_define(name, description, type)
       params[name] = { description: description, type: type }
     end
+
+    def call_worker(name, params)
+      SmartAgent.prompt_engine.call_worker(name, params)
+    end
   end
 end

data/lib/smart_agent/version.rb

@@ -1,3 +1,3 @@
 module SmartAgent
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: smart_agent
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Your Name
 bindir: bin
 cert_chain: []
-date: 2025-03-28 00:00:00.000000000 Z
+date: 2025-03-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: smart_prompt