Tự động hóa việc tạo tài liệu bằng AI trong Ruby on Rails

Trong các dự án phần mềm hiện đại, việc tự động hóa các tác vụ lặp đi lặp lại là rất quan trọng để tăng tốc độ phát triển và giảm thiểu sai sót do con người. Một ví dụ tuyệt vời là tạo tài liệu — dù đó là tài liệu yêu cầu sản phẩm (PRD), đề xuất dự án hay bài thuyết trình.

Gần đây, tôi đã làm việc trên một hệ thống sử dụng AI để tạo ra nội dung có cấu trúc từ các cuộc hội thoại, sau đó xuất tài liệu dưới nhiều định dạng như Word (.odt), PowerPoint (.pptx), Markdown (.md) và nhiều định dạng khác. Kiến trúc hệ thống tận dụng AI hội thoại để tạo nội dung có cấu trúc, và hoàn toàn có thể tích hợp với Ruby on Rails. Dưới đây là cách bạn có thể xây dựng hệ thống như vậy.

Cách hoạt động: Kiến trúc hệ thống

User Input (Q&A + files) ↓
Conversational AI (OpenAI) ↓
Structured JSON PRD (document sections) ↓
Output Generators: ├─ DOCX (Word templates) ├─ PPTX (PowerPoint templates) ├─ Markdown (MD templates) ├─ YAML (configuration/data serialization) ├─ ODT (OpenDocument Text) ├─ PDF (final polished document) └─ TXT (plain text export) ↓
Export & Delivery (files to users)

Luồng này đảm bảo việc tách biệt rõ ràng giữa quá trình tạo nội dung và hiển thị định dạng, giúp hệ thống có thể mở rộng và dễ bảo trì.

Ruby on Rails: Ví dụ triển khai

1. AI hội thoại

Sử dụng gem ruby-openai để tương tác với API của OpenAI:

require 'openai' class AiPrdService def initialize(user_prompt) @client = OpenAI::Client.new(access_token: ENV['OPENAI_API_KEY']) @user_prompt = user_prompt end def generate_prd_json response = @client.chat( parameters: { model: "gpt-4o-mini", messages: [ { role: "system", content: "You are an AI assistant that generates structured PRDs." }, { role: "user", content: @user_prompt } ], temperature: 0.7 } ) # Extract JSON from response (assuming AI outputs JSON) prd_content = JSON.parse(response.dig("choices", 0, "message", "content")) prd_content rescue JSON::ParserError => e Rails.logger.error "Failed to parse AI response: #{e.message}" nil end
end

2. Tạo DOCX bằng template

Sử dụng gem caracal để tạo tài liệu Word:

require 'caracal' class DocxGenerator def initialize(prd_json) @prd_json = prd_json end def generate_docx(output_path) Caracal::Document.save(output_path) do |docx| docx.h1 @prd_json['title'] @prd_json['sections'].each do |section| docx.h2 section['heading'] docx.p section['content'] end end end
end

3. Tạo Markdown (MD)

Sử dụng ERB để render mẫu:

class MarkdownGenerator TEMPLATE = <<~MD # <%= @prd_json['title'] %> <% @prd_json['sections'].each do |section| %> ## <%= section['heading'] %> <%= section['content'] %> <% end %> MD def initialize(prd_json) @prd_json = prd_json end def generate_markdown ERB.new(TEMPLATE).result(binding) end
end

4. Xuất YAML cho cấu hình hoặc chia sẻ dữ liệu

require 'yaml' class YamlGenerator def initialize(prd_json) @prd_json = prd_json end def generate_yaml(output_path) File.write(output_path, @prd_json.to_yaml) end
end

5. Tạo ODT (OpenDocument Text)

Sử dụng gem odf-report:

require 'odf-report' class OdtGenerator def initialize(prd_json) @prd_json = prd_json end def generate_odt(output_path) report = ODFReport::Report.new("template.odt") do |r| r.add_field("TITLE", @prd_json['title']) @prd_json['sections'].each_with_index do |section, index| r.add_field("HEADING#{index+1}", section['heading']) r.add_field("CONTENT#{index+1}", section['content']) end end report.generate(output_path) end
end

6. Tạo PDF

Sử dụng gem prawn (hoặc wicked_pdf cho HTML sang PDF):

require 'prawn' class PdfGenerator def initialize(prd_json) @prd_json = prd_json end def generate_pdf(output_path) Prawn::Document.generate(output_path) do |pdf| pdf.text @prd_json['title'], size: 24, style: :bold @prd_json['sections'].each do |section| pdf.move_down 10 pdf.text section['heading'], size: 18, style: :bold pdf.text section['content'], size: 12 end end end
end

7. Xuất văn bản thuần túy (TXT)

class TxtGenerator def initialize(prd_json) @prd_json = prd_json end def generate_txt(output_path) content = [] content << @prd_json['title'] @prd_json['sections'].each do |section| content << "\n#{section['heading']}\n" content << "#{section['content']}\n" end File.write(output_path, content.join("\n")) end
end

Tại sao xây dựng hệ thống này bằng Rails?

• Dễ bảo trì: Kiến trúc MVC và pattern service object của Rails giúp tách biệt rõ trách nhiệm.
• Dễ mở rộng: Thêm định dạng mới như PDF, ODT chỉ cần vài bước.
• Tích hợp tốt: Có thể sử dụng ActiveJob và xử lý nền để tạo tài liệu không đồng bộ.
• Hệ sinh thái phong phú: Có nhiều gem hỗ trợ tạo mẫu tài liệu và HTTP client.

Tổng kết

Bằng cách kết hợp các mô hình hội thoại mạnh mẽ của OpenAI với kiến trúc linh hoạt của Ruby on Rails, bạn có thể xây dựng các pipeline mạnh mẽ để tự động chuyển đổi hội thoại của người dùng thành tài liệu có cấu trúc rõ ràng — tiết kiệm thời gian và giảm thiểu công việc thủ công.