06 — Features: Teddy

06 — Features: Teddy#

Tài liệu mô tả tính năng đã ship trong Teddy (plugin hiện tại). Không phải roadmap hay kiến trúc — nếu muốn biết “sắp có gì”, xem 04-roadmap-prompt.md. Nếu muốn biết “code nằm đâu”, xem 02 và docs/modules/.

Phiên bản tài liệu: GA / v1.x
Đối tượng: chủ site, content writer, developer, QA.

1. Teddy là gì?#

Teddy là lớp AI vận hành trên WordPress: hiểu yêu cầu bằng ngôn ngữ tự nhiên, chọn tool an toàn, thực thi (hoặc yêu cầu duyệt), rồi giải thích kết quả.

Teddy không lưu API key của OpenAI/Anthropic trong Settings. Provider đi qua WordPress AI Client + Connectors (cài riêng trên site).

Teddy không chỉ là chat box: có Copilot admin, widget khách, SEO/Writer, Woo tools, RAG, workflow, audit/security, và Extension SDK.

2. Đủ so với tài liệu Vision / Roadmap chưa?#

Tóm lại: đủ cho GA theo roadmap; chưa phủ hết mọi ví dụ trong Vision. Các tính năng “nặng” (RAG, Agent Pipeline, Workflows, SDK) đã có code nhưng tắt mặc định — bật trong Settings / Getting Started.

3. Nhanh theo nhóm người dùng#

Website Owner / Admin#

Content Writer / SEO#

Khách truy cập / Support#

Developer#

4. Catalog tính năng chi tiết#

4.1 Copilot & Chat#

• Admin Copilot (Teddy → Teddy Copilot): hội thoại streaming (SSE), nhớ ngữ cảnh theo memory_length.
• Hai chế độ backend:
  • Legacy (mặc định): Abilities / tool legacy.
  • Agent Pipeline (use_agent_pipeline): Understand → Plan → Tools → Summarize, có audit + explainability (“Why this answer”).
• Public chat: widget / shortcode / block; rate limit theo Settings.

4.2 Tool System#

Chuỗi sống: validate → permission → dry-run (nếu nguy hiểm) → approve → execute → audit.

Domain tools (Agent Pipeline):

Playbooks: docs/playbooks/. MCP + OpenClaw: modules/mcp-bridge/.

Legacy tools (chat không Agent): site statistics, search posts/products/docs/users, categories, related/low-stock/orders…

Hành động nguy hiểm bắt buộc preview + approval_token (không bypass qua REST).

4.3 Knowledge / RAG#

Khi enable_rag:

1. Index Posts, Pages, extra public CPT (rag_indexable_post_types / filter teddy_indexable_post_types), Products, and PDF/CSV uploads (chunk → embedding → lưu MySQL).
2. Cron cursor (teddy_rag_ingest_cursor) batch ~25; phases: content types → products → uploads; filters teddy_indexable_products, teddy_indexable_posts, teddy_indexable_upload_mimes.
3. search / augment đưa context vào prompt; chat trả sources.
4. ACF (get_fields) và Elementor (_elementor_data) được gộp vào text index khi plugin active.
5. Admin: panel Knowledge trên Settings + REST GET/POST .../knowledge/status|reindex|ingest.

Cần connector/embeddings khả dụng (hoặc filter teddy_generate_embeddings).

4.4 Workflow Engine#

Khi enable_workflows:

• Định nghĩa workflow, persist từng bước, resume đúng bước fail (không bỏ bước đã success).
• Mẫu publish_product: validate → mô tả → SEO → apply → ensure image (brief + hook) → translation draft (nếu target_language) → publish → notify (notify_email tùy chọn).
• Queue: Action Scheduler nếu có, không thì WP-Cron.
• UI: Teddy → Workflows + REST /workflows*.

Hooks mở rộng ảnh: teddy_workflow_generate_product_image, teddy_workflow_need_product_image (mặc định Teddy thử AI image qua WP AI Client, fallback PNG placeholder GD).

4.5 SEO, Writer & Classification#

• Panel SEO trong editor; ghi meta qua adapter SEO plugin hoặc fallback core.
• Content Classification: sidebar gợi ý category/tag có sẵn; Apply ghi vào draft qua editor store.
• seo.article.write: Markdown→HTML, meta SEO, FAQ schema (_teddy_faq_schema + wp_head).
• Writer REST: preview / generate / revise / content.

4.5b Comments#

• Moderation (tắt mặc định): bình luận khách được giữ hold, job nền phân tích toxicity/sentiment → approve/hold/spam; metadata _teddy_moderation.
• Suggest Reply: action trên Comments + Dashboard activity; REST trả bản nháp, admin tự gửi.
• REST: POST /teddy/v1/comments/suggest-reply, POST /teddy/v1/classify.

4.6 WooCommerce#

Khi Woo active + enable_woocommerce:

• Tool list / giá / related / low stock / orders.
• Index sản phẩm vào RAG (nếu RAG bật).

4.7 Onboarding#

Trang Getting Started:

• Xác nhận backup.
• Kiểm tra AI Client / connector.
• One-click bật Copilot, RAG, widget, SEO…
• Gợi ý bài SEO đầu tiên.

Sau khi setup xong có thể dismiss (page vẫn đăng ký ẩn để tránh redirect “not allowed”).

4.8 Observability & Security#

Khi use_agent_pipeline:

• Observability: audit tool executions, AI usage ước lượng.
• Security: SecurityAuditService + trang checklist.
• Copilot: Why / How / tools / errors trên UI.

Luôn có: current_user_can, rate limit public, option xóa data khi uninstall.

4.9 Provider & Streaming#

• Preference provider / model / temperature / max_tokens trong Settings.
• Đổi connector/provider không cần deploy code Teddy.
• Streaming bật mặc định (enable_streaming).

4.10 Memory#

• Scope hiện có: Conversation, User (Temporary trong domain).
• Chưa: Global / Website / Project (Vision dài hạn).

4.11 i18n#

• Text domain teddy.
• UI: English + Vietnamese (languages/, Jed JSON cho React).

4.12 Extension SDK#

Khi enable_extension_sdk:

add_action( 'teddy_boot', function () {
    register_tool( new MyTool() );
    // register_workflow, register_prompt, register_resource, register_ai_action
} );

Tool thứ ba vẫn qua đầy đủ vòng đời an toàn — không có đường tắt. Chi tiết: EXTENSION_GUIDE.md.

5. Bảng Feature flags (Settings)#

6. REST API (tóm tắt)#

Namespace: /wp-json/teddy/v1

Auth: cookie + REST nonce (admin). JWT tùy chọn nếu định nghĩa BEAN_AI_JWT_SECRET.

MCP / OpenClaw: stdio bridge tại mcp-server/ — map tools/list → GET /domain-tools, tools/call → POST /tools/{name}/execute. Wizard cho buyer: openclaw/ (teddy-openclaw setup). Xem modules/mcp-bridge/openclaw-onboarding.md.

7. Admin menu map#

Teddy
├── Settings              (luôn)
├── Getting Started       (ẩn menu khi đã dismiss)
├── Teddy Copilot         (enable_admin_copilot)
├── Teddy Writer          (enable_bean_writer)
├── Observability         (use_agent_pipeline)
├── Security              (use_agent_pipeline)
└── Workflows             (enable_workflows)

8. Chưa có / ngoài phạm vi GA#

Các mục sau không nằm trong GA hiện tại (Vision hoặc Enterprise). Lộ trình chi tiết: 08-enterprise-roadmap.md.

• Multisite / Network Admin fleet / agency dashboard trung tâm → E1 / E4
• Vector store ngoài (Pinecone, Qdrant…) → E2
• Re-ranking / hybrid search nâng cao → E2
• Memory Global / Website / Project → E2+
• Tool “Jarvis đầy đủ”: email marketing bulk, WP-CLI shell đầy đủ, tạo promotion mới… → dần theo workflows + SDK
• SSO/SAML, xuất audit sang SIEM → E3
• Duyệt nhiều cấp (nhiều người approve) → E3

Đã ship trong v1.0.5 / v1.1: PDF/CSV upload + ingest, ACF/Elementor enrichment, system.send_email, system.wp_cli (whitelist), media.generate_image, AI image native (WP AI Client) với fallback GD placeholder.

9. Kiểm thử liên quan#

10. Tài liệu liên quan#

Index đầy đủ: README.md trong thư mục docs/.