smart_prompt 0.4.4 → 0.5.1

data/examples/anthropic_example.rb

@@ -0,0 +1,232 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "./lib/smart_prompt"
+
+# Example: Using Anthropic Claude with SmartPrompt
+# This example demonstrates various features of the AnthropicAdapter
+
+# Initialize the engine with Anthropic configuration
+engine = SmartPrompt::Engine.new("config/anthropic_config.yml")
+
+puts "=" * 60
+puts "Anthropic Claude Examples with SmartPrompt"
+puts "=" * 60
+
+=begin
+# Example 1: Basic Chat
+puts "\n1. Basic Chat Example"
+puts "-" * 60
+
+SmartPrompt.define_worker :basic_chat do
+  use "deepseek_anthropic"
+  model "deepseek-chat"
+  sys_msg("You are a helpful AI assistant.")
+  prompt(params[:message])
+  send_msg
+end
+
+response = engine.call_worker(:basic_chat, {
+  message: "What is the capital of France?",
+})
+puts "User: What is the capital of France?"
+puts "DeepSeek: #{response}"
+
+# Example 2: Multi-turn Conversation
+puts "\n2. Multi-turn Conversation Example"
+puts "-" * 60
+
+SmartPrompt.define_worker :conversation do
+  use "deepseek_anthropic"
+  model "deepseek-chat"
+  sys_msg("You are a knowledgeable history teacher.")
+  prompt(params[:message], with_history: true)
+  send_msg
+end
+
+response1 = engine.call_worker(:conversation, {  
+  message: "Who was the first president of the United States?",
+  with_history: true,
+})
+puts "User: Who was the first president of the United States?"
+puts "Claude: #{response1}"
+
+response2 = engine.call_worker(:conversation, {
+  message: "What were his major accomplishments?",
+  with_history: true,
+})
+puts "\nUser: What were his major accomplishments?"
+puts "Claude: #{response2}"
+
+# Example 3: Code Generation
+puts "\n3. Code Generation Example"
+puts "-" * 60
+
+SmartPrompt.define_worker :code_generator do
+  use "deepseek_anthropic"
+  model "deepseek-chat"
+  sys_msg("You are an expert programmer. Generate clean, well-documented code.")
+  prompt("Write a Ruby function that #{params[:task]}")
+  send_msg
+end
+
+code = engine.call_worker(:code_generator, {
+  task: "calculates the factorial of a number using recursion",
+})
+puts "Task: Write a Ruby function that calculates the factorial of a number using recursion"
+puts "Generated Code:\n#{code}"
+
+# Example 4: Streaming Response
+puts "\n4. Streaming Response Example"
+puts "-" * 60
+
+SmartPrompt.define_worker :streaming_chat do
+  use "deepseek_anthropic"
+  model "deepseek-chat"
+  sys_msg("You are a storyteller.")
+  prompt(params[:message])
+  send_msg
+end
+
+print "User: Tell me a short story about a brave knight.\n"
+print "Claude (streaming): "
+
+engine.call_worker_by_stream(:streaming_chat, {
+  message: "Tell me a short story about a brave knight.",
+}) do |chunk, bytesize|
+  # Handle Anthropic streaming format
+  if chunk.is_a?(Hash)
+    if chunk["type"] == "content_block_delta"
+      text = chunk.dig("delta", "text")
+      print text if text
+    end
+  end
+end
+
+puts "\n"
+=end
+
+# Example 7: Tool Calling (Function Calling)
+puts "\n7. Tool Calling Example"
+puts "-" * 60
+
+# Define tools
+weather_tools = [
+  {
+    type: "function",
+    function: {
+      name: "get_weather",
+      description: "Get the current weather for a location",
+      parameters: {
+        type: "object",
+        properties: {
+          location: {
+            type: "string",
+            description: "The city and state, e.g. San Francisco, CA",
+          },
+          unit: {
+            type: "string",
+            enum: ["celsius", "fahrenheit"],
+            description: "The temperature unit",
+          },
+        },
+        required: ["location"],
+      },
+    },
+  },
+]
+
+SmartPrompt.define_worker :weather_assistant do
+  use "deepseek_anthropic"
+  model "deepseek-chat"
+  sys_msg("You are a helpful weather assistant. Use the get_weather tool when users ask about weather.")
+  prompt(params[:message])
+  send_msg
+end
+
+response = engine.call_worker(:weather_assistant, {
+  message: "What's the weather like in Tokyo?",
+  tools: weather_tools,
+})
+puts "User: What's the weather like in Tokyo?"
+puts "Claude: #{response}"
+
+=begin
+
+# Example 8: Image Analysis (Multimodal)
+puts "\n8. Image Analysis Example (Multimodal)"
+puts "-" * 60
+
+SmartPrompt.define_worker :image_analyzer do
+  use "claude"
+  sys_msg("You are an expert at analyzing images and describing what you see.")
+  prompt(params[:message])
+  send_msg
+end
+
+# Using a public image URL
+image_url = "https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/1200px-Cat03.jpg"
+
+response = engine.call_worker(:image_analyzer, {
+  message: [
+    { type: "text", text: "What do you see in this image? Describe it in detail." },
+    { type: "image_url", image_url: image_url }
+  ]
+})
+puts "User: [Sends image of a cat]"
+puts "Claude: #{response}"
+
+# Example 9: Different Models Comparison
+puts "\n9. Different Models Comparison"
+puts "-" * 60
+
+question = "Explain quantum entanglement in simple terms."
+
+# Using Claude 3.5 Sonnet
+SmartPrompt.define_worker :sonnet_chat do
+  use "claude"
+  model "claude-3-5-sonnet-20241022"
+  prompt(params[:message])
+  send_msg
+end
+
+sonnet_response = engine.call_worker(:sonnet_chat, { message: question })
+puts "Question: #{question}"
+puts "\nClaude 3.5 Sonnet Response:"
+puts sonnet_response[0..200] + "..."
+
+# Using Claude 3.5 Haiku (faster)
+SmartPrompt.define_worker :haiku_chat do
+  use "claude_haiku"
+  model "claude-3-5-haiku-20241022"
+  prompt(params[:message])
+  send_msg
+end
+
+haiku_response = engine.call_worker(:haiku_chat, { message: question })
+puts "\nClaude 3.5 Haiku Response:"
+puts haiku_response[0..200] + "..."
+
+# Example 10: Error Handling
+puts "\n10. Error Handling Example"
+puts "-" * 60
+
+begin
+  # Try to use a non-existent model
+  SmartPrompt.define_worker :error_test do
+    use "claude"
+    model "non-existent-model"
+    prompt(params[:message])
+    send_msg
+  end
+
+  engine.call_worker(:error_test, { message: "Hello" })
+rescue SmartPrompt::LLMAPIError => e
+  puts "Caught API Error: #{e.message}"
+  puts "Error handling works correctly!"
+end
+
+puts "\n" + "=" * 60
+puts "All examples completed!"
+puts "=" * 60
+=end

data/examples/anthropic_multimodal.rb

@@ -0,0 +1,212 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require './lib/smart_prompt'
+require 'base64'
+
+# Example: Multimodal (Text + Image) with Anthropic Claude
+# This example demonstrates how to use Claude's vision capabilities
+
+puts "=" * 60
+puts "Anthropic Claude - Multimodal (Vision) Example"
+puts "=" * 60
+
+# Initialize the engine with Anthropic configuration
+engine = SmartPrompt::Engine.new('config/anthropic_config.yml')
+
+# Example 1: Analyze Image from URL
+puts "\n1. Analyze Image from URL"
+puts "-" * 60
+
+SmartPrompt.define_worker :image_analyzer do
+  use "claude"
+  sys_msg("You are an expert at analyzing images and describing what you see in detail.")
+  prompt(params[:message])
+  send_msg
+end
+
+# Using a public image URL
+image_url = "https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/400px-Cat03.jpg"
+
+response = engine.call_worker(:image_analyzer, {
+  message: [
+    { type: "text", text: "What do you see in this image? Describe it in detail." },
+    { type: "image_url", image_url: image_url }
+  ]
+})
+puts "User: [Sends image URL: #{image_url}]"
+puts "User: What do you see in this image? Describe it in detail."
+puts "\nClaude: #{response}\n"
+
+# Example 2: Analyze Local Image using Base64
+puts "\n2. Analyze Local Image (Base64 Encoding)"
+puts "-" * 60
+
+# Check if local image exists
+local_image_path = "./product_images/smartphone_1.png"
+
+if File.exist?(local_image_path)
+  # Read and encode image to base64
+  image_data = File.binread(local_image_path)
+  base64_image = Base64.strict_encode64(image_data)
+  
+  # Determine media type
+  media_type = case File.extname(local_image_path).downcase
+               when '.jpg', '.jpeg' then 'image/jpeg'
+               when '.png' then 'image/png'
+               when '.gif' then 'image/gif'
+               when '.webp' then 'image/webp'
+               else 'image/jpeg'
+               end
+  
+  data_url = "data:#{media_type};base64,#{base64_image}"
+  
+  response = engine.call_worker(:image_analyzer, {
+    message: [
+      { type: "text", text: "Describe this product image. What features can you identify?" },
+      { type: "image_url", image_url: data_url }
+    ]
+  })
+  puts "User: [Sends local image: #{local_image_path}]"
+  puts "User: Describe this product image. What features can you identify?"
+  puts "\nClaude: #{response}\n"
+else
+  puts "Local image not found at #{local_image_path}"
+  puts "Skipping base64 example.\n"
+end
+
+# Example 3: Multiple Images Analysis
+puts "\n3. Compare Multiple Images"
+puts "-" * 60
+
+SmartPrompt.define_worker :image_comparator do
+  use "claude"
+  sys_msg("You are an expert at comparing and contrasting images.")
+  prompt(params[:message])
+  send_msg
+end
+
+image1_url = "https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/400px-Cat03.jpg"
+image2_url = "https://upload.wikimedia.org/wikipedia/commons/thumb/4/4d/Cat_November_2010-1a.jpg/400px-Cat_November_2010-1a.jpg"
+
+response = engine.call_worker(:image_comparator, {
+  message: [
+    { type: "text", text: "Compare these two images. What are the similarities and differences?" },
+    { type: "image_url", image_url: image1_url },
+    { type: "image_url", image_url: image2_url }
+  ]
+})
+puts "User: [Sends two cat images]"
+puts "User: Compare these two images. What are the similarities and differences?"
+puts "\nClaude: #{response}\n"
+
+# Example 4: Image + Text Context
+puts "\n4. Image Analysis with Additional Context"
+puts "-" * 60
+
+SmartPrompt.define_worker :contextual_analyzer do
+  use "claude"
+  sys_msg("You are a product analyst helping with e-commerce listings.")
+  prompt(params[:message])
+  send_msg
+end
+
+product_image = "https://upload.wikimedia.org/wikipedia/commons/thumb/c/c4/Smartphone.jpg/400px-Smartphone.jpg"
+
+response = engine.call_worker(:contextual_analyzer, {
+  message: [
+    { type: "text", text: "This is a product image for our online store. Please:" },
+    { type: "text", text: "1. Describe the product" },
+    { type: "text", text: "2. Suggest a catchy product title" },
+    { type: "text", text: "3. Write a brief product description (2-3 sentences)" },
+    { type: "text", text: "4. List 3-5 key features" },
+    { type: "image_url", image_url: product_image }
+  ]
+})
+puts "User: [Sends product image with detailed instructions]"
+puts "\nClaude: #{response}\n"
+
+# Example 5: OCR and Text Extraction
+puts "\n5. Text Extraction from Image (OCR)"
+puts "-" * 60
+
+SmartPrompt.define_worker :ocr_extractor do
+  use "claude"
+  sys_msg("You are an expert at reading and extracting text from images.")
+  prompt(params[:message])
+  send_msg
+end
+
+# Using an image with text (e.g., a sign or document)
+text_image_url = "https://upload.wikimedia.org/wikipedia/commons/thumb/8/87/PDF_file_icon.svg/400px-PDF_file_icon.svg.png"
+
+response = engine.call_worker(:ocr_extractor, {
+  message: [
+    { type: "text", text: "Extract and transcribe any text you see in this image." },
+    { type: "image_url", image_url: text_image_url }
+  ]
+})
+puts "User: [Sends image with text]"
+puts "User: Extract and transcribe any text you see in this image."
+puts "\nClaude: #{response}\n"
+
+# Example 6: Image Classification
+puts "\n6. Image Classification and Categorization"
+puts "-" * 60
+
+SmartPrompt.define_worker :image_classifier do
+  use "claude"
+  sys_msg("You are an expert at categorizing and classifying images.")
+  prompt(params[:message])
+  send_msg
+end
+
+classify_image = "https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/400px-Cat03.jpg"
+
+response = engine.call_worker(:image_classifier, {
+  message: [
+    { type: "text", text: "Classify this image into categories. Provide:\n1. Main category\n2. Sub-categories\n3. Tags/keywords\n4. Suitable use cases" },
+    { type: "image_url", image_url: classify_image }
+  ]
+})
+puts "User: [Sends image for classification]"
+puts "\nClaude: #{response}\n"
+
+# Example 7: Image-based Question Answering
+puts "\n7. Question Answering about Image Content"
+puts "-" * 60
+
+SmartPrompt.define_worker :image_qa do
+  use "claude"
+  sys_msg("You are helpful at answering questions about images.")
+  prompt(params[:message])
+  send_msg
+end
+
+qa_image = "https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/400px-Cat03.jpg"
+
+questions = [
+  "What color is the animal?",
+  "What is the animal doing?",
+  "What is the setting or environment?"
+]
+
+questions.each_with_index do |question, index|
+  response = engine.call_worker(:image_qa, {
+    message: [
+      { type: "image_url", image_url: qa_image },
+      { type: "text", text: question }
+    ]
+  })
+  puts "Q#{index + 1}: #{question}"
+  puts "A#{index + 1}: #{response}\n"
+end
+
+puts "\n" + "=" * 60
+puts "Multimodal examples completed!"
+puts "=" * 60
+puts "\nNote: Claude's vision capabilities work best with:"
+puts "- Clear, well-lit images"
+puts "- Images in JPEG, PNG, GIF, or WebP format"
+puts "- Images up to 5MB in size"
+puts "- Both URLs and base64-encoded images"