Trình Kết Nối OpenAI
Kết nối OpenAI với Brevo qua Tajo để tạo nội dung email AI, phân tích phản hồi khách hàng, cá nhân hóa thông điệp marketing và tự động phân loại liên hệ.
Tổng Quan
| Thuộc Tính | Giá Trị |
|---|---|
| Nền Tảng | OpenAI |
| Danh Mục | Tùy Chỉnh |
| Độ Phức Tạp Thiết Lập | Dễ |
| Tích Hợp Chính Thức | Không |
| Dữ Liệu Đồng Bộ | Completions, Embeddings, Phân Tích |
| Loại API | REST API |
| URL API | https://api.openai.com/v1 |
Tính Năng
- Tạo nội dung email - Tạo tiêu đề, nội dung email cá nhân hóa với GPT
- Phân tích cảm xúc - Phân tích phản hồi khách hàng và phân loại tự động
- Phân đoạn thông minh - Sử dụng embeddings để tìm liên hệ tương tự
- Dịch nội dung - Dịch chiến dịch marketing sang nhiều ngôn ngữ
- Tóm tắt - Tóm tắt cuộc trò chuyện dài để làm phong phú hồ sơ liên hệ
- Phân loại - Tự động gắn tag liên hệ dựa trên nội dung hành vi
Yêu Cầu
Trước khi bắt đầu, hãy đảm bảo bạn có:
- Tài khoản OpenAI với credit hoạt động
- OpenAI API key
- Tài khoản Brevo với quyền truy cập API
- Tài khoản Tajo
Xác Thực
curl "https://api.openai.com/v1/chat/completions" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role": "user", "content": "Hello!"}] }'Tạo API keys tại https://platform.openai.com/api-keys.
Bảo Mật API Key
OpenAI API keys cấp quyền truy cập đầy đủ vào tài khoản và billing. Không bao giờ commit keys vào source code. Sử dụng biến môi trường và rotate định kỳ.
Cấu Hình
Thiết Lập Cơ Bản
connectors: openai: enabled: true api_key: "${OPENAI_API_KEY}" default_model: "gpt-4o-mini" max_tokens: 500 temperature: 0.7
# Tính năng bật features: content_generation: true sentiment_analysis: true embeddings: falseÁnh Xạ Tác Vụ
tasks: email_subject_generation: model: "gpt-4o-mini" system_prompt: "Tạo dòng tiêu đề email marketing hấp dẫn" max_tokens: 100
sentiment_analysis: model: "gpt-4o-mini" system_prompt: "Phân tích cảm xúc và trả về: positive, negative, hoặc neutral" max_tokens: 50API Endpoints
| Phương Thức | Endpoint | Mô Tả |
|---|---|---|
POST | /v1/chat/completions | Tạo chat completion |
POST | /v1/embeddings | Tạo text embeddings |
POST | /v1/images/generations | Tạo hình ảnh (DALL-E) |
GET | /v1/models | Liệt kê các models có sẵn |
Ví Dụ Code
Khởi Tạo Trình Kết Nối
import { TajoClient } from '@tajo/sdk';
const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY});
await tajo.connectors.connect('openai', { apiKey: process.env.OPENAI_API_KEY});Tạo Nội Dung Email Cá Nhân Hóa
// Tạo dòng tiêu đề email cá nhân hóaconst emailContent = await tajo.connectors.generate('openai', { task: 'email_subject', context: { contactName: 'Nguyễn Văn A', productCategory: 'SaaS', recentActivity: 'viewed pricing page', language: 'vi' }});Phân Tích Cảm Xúc Phản Hồi
// Phân tích cảm xúc phản hồi khách hàngconst sentiment = await tajo.connectors.analyze('openai', { task: 'sentiment', text: 'Sản phẩm rất tốt nhưng hỗ trợ phản hồi chậm'});
// Cập nhật thuộc tính liên hệ Brevoawait tajo.brevo.updateContact({ attributes: { SENTIMENT: sentiment.result }});Giới Hạn Tốc Độ
| Model | Tokens/Phút | Yêu Cầu/Phút |
|---|---|---|
| gpt-4o | 30.000 | 500 |
| gpt-4o-mini | 200.000 | 500 |
| text-embedding-3-small | 1.000.000 | 3.000 |
Khắc Phục Sự Cố
| Sự Cố | Nguyên Nhân | Giải Pháp |
|---|---|---|
| 401 Unauthorized | API key không hợp lệ | Xác minh key trong OpenAI dashboard |
| 429 Too Many Requests | Vượt giới hạn tốc độ | Triển khai exponential backoff |
| Kết quả không chính xác | Prompt kém | Cải thiện system prompt với hướng dẫn rõ ràng |
| Phản hồi bị cắt | max_tokens quá thấp | Tăng giới hạn max_tokens |