crmne / ruby_llm

Problem: 开发AI应用时需要同时支持多个AI服务商（如OpenAI、Claude、Gemini），但每个服务商的API接口和响应格式都不同，导致代码复杂且难以维护。

Solution: 使用RubyLLM的统一接口，只需一套代码即可调用所有支持的AI模型，通过简单的配置切换服务商。

Example: 你的Rails应用需要根据用户订阅级别提供不同的AI模型（付费用户用GPT-4，免费用户用本地Ollama），只需修改配置即可，无需重写业务逻辑。

Problem: 想在Rails应用中快速添加AI聊天功能，但需要处理复杂的API集成、会话管理和界面开发。

Solution: 使用RubyLLM的Rails集成功能，通过`acts_as_chat`和内置的聊天界面，几分钟就能搭建完整的AI聊天系统。

Example: 运行`rails generate rubyllm:install`后，访问`/chats`即可获得现成的聊天界面，支持与多种AI模型对话。

Problem: 需要处理多种类型的AI任务（文本聊天、图像分析、语音转写、文档提取），但不同任务需要调用不同的API和客户端。

Solution: 使用RubyLLM的统一方法（`chat`、`transcribe`、`paint`、`embed`等）处理所有AI任务，接口一致且简单。

Example: 一个客服系统需要同时处理用户文字提问、上传的图片分析和语音留言转写，使用RubyLLM可以用相似的代码风格处理所有这些任务。

Problem: 需要让AI模型能够调用外部工具或执行特定任务（如查询数据库、调用API），但实现起来复杂且容易出错。

Solution: 使用RubyLLM的工具和代理功能，让AI模型能够安全地调用你定义的Ruby方法，构建智能代理系统。

Example: 创建一个旅行规划代理，AI可以调用你的`search_flights`、`book_hotel`等Ruby方法，自动为用户规划行程。