uPresenter
Trang chủ English Bắt đầu tạo

3.6: Dùng uPresenter từ Claude hoặc Codex

Nếu bạn đã quen làm việc với Claude hoặc Codex, bạn không cần sao chép văn bản qua lại giữa khung trò chuyện và uPresenter. Plugin uPresenter cho phép trợ lý xây dựng và chỉnh sửa bài thuyết trình ngay trong tài khoản uPresenter của bạn: bạn mô tả bài học trong khung trò chuyện, và các trang chiếu xuất hiện trong trình soạn thảo bạn đang mở.

Mục này hướng dẫn bạn cách cài đặt plugin, đăng nhập một lần, bắt đầu phiên làm việc đầu tiên, cập nhật plugin và gỡ quyền truy cập khi bạn không còn cần đến.

1. Hiểu plugin là gì

Plugin là một tiện ích bổ sung nhỏ cho trợ lý AI của bạn. Nó làm hai việc:

Plugin khác với các lựa chọn AI khác mà bạn đã biết:

Lựa chọn Nơi bạn trò chuyện Sử dụng gì
Tác nhân AI (Mục 3.3) Bên trong trình soạn thảo uPresenter Tín dụng uPresenter
Kết nối AI (Mục 3.3) Trong Codex, Claude Code hoặc Gemini CLI, liên kết với một bài thuyết trình Tài khoản AI của riêng bạn
Plugin uPresenter (mục này) Trong Claude hoặc Codex, làm việc trên toàn bộ tài khoản của bạn Tài khoản AI của riêng bạn

Hãy chọn plugin khi bạn muốn bắt đầu từ Claude hoặc Codex, muốn trợ lý tự chọn mẫu và xây dựng cả bài học, và muốn giữ cuộc trò chuyện trong công cụ bạn đang dùng.

Bạn cần chuẩn bị gì

2. Cài đặt plugin trong Claude

Cách cài đặt phụ thuộc vào ứng dụng Claude bạn dùng.

Claude Code

Claude Code là phiên bản Claude chạy trong terminal. Hãy chạy lần lượt hai lệnh sau:

claude plugin marketplace add uLearnBox/upresenter-plugin
claude plugin install upresenter@upresenter

Sau đó, trong Claude Code, gõ /mcp, chọn upresenter và chọn Authenticate. Trình duyệt sẽ mở trang đăng nhập uPresenter; hãy tiếp tục với Mục 4.

Nếu bạn chỉ muốn kết nối mà không cần kiến thức xây dựng bài học, hộp thoại Kết nối AI trong trình soạn thảo cũng cung cấp một lệnh Claude Code cho cùng máy chủ đó.

Claude Code không tự cập nhật plugin này trừ khi bạn cho phép. Hãy bật cập nhật tự động ngay sau khi cài đặt, như mô tả ở Mục 8.

Claude Desktop và Claude trên web

  1. Mở Settings của Claude và chọn Plugins trong nhóm Customize.
  2. Thêm plugin uPresenter. Khi uPresenter đã có trong danh mục Plugins, hãy tìm nó ở đó và chọn Install. Trước khi có, hãy thêm tệp plugin do uPresenter cung cấp (tệp nén .zip hoặc .plugin) bằng tùy chọn thêm plugin từ tệp.
  3. Mở trang plugin uPresenter. Nếu trang báo bạn chưa kết nối, hãy chọn Connect. Trình duyệt sẽ mở trang đăng nhập uPresenter; hãy tiếp tục với Mục 4.

Nếu bạn không thể thêm plugin, bạn vẫn có thể kết nối Claude mà không có các kỹ năng xây dựng bài học bổ sung: trong trình soạn thảo, chọn AI, rồi Kết nối AI, chọn Claude và làm theo các bước hiển thị ở đó (các bước này dùng Customize, Connectors và Add custom connector).

Giao diện của Claude thỉnh thoảng thay đổi. Nếu một nhãn ở đây khác với những gì bạn thấy, hãy tìm các từ tương tự (Plugins, Install, Connect) trên màn hình gần đó.

3. Cài đặt plugin trong Codex

Codex hoạt động trong terminal, ứng dụng Codex trên máy tính hoặc tiện ích mở rộng cho IDE. Chúng dùng chung một cấu hình, nên bạn chỉ cần cài đặt một lần. Trong terminal, hãy chạy:

codex plugin marketplace add uLearnBox/upresenter-plugin
codex plugin add upresenter@upresenter
codex mcp login upresenter

Lệnh cuối cùng mở trình duyệt để bạn đăng nhập uPresenter; hãy tiếp tục với Mục 4. Nếu bạn dùng ứng dụng Codex hoặc IDE, hãy khởi động lại và mở một luồng (thread) mới để nó nhận plugin. Để nhận các phiên bản plugin mới hơn, xem Mục 8.

Bạn có thể nhận thấy Codex hiển thị danh sách khả năng uPresenter ngắn hơn so với Claude. Điều này là có chủ ý, vì Codex hoạt động tốt nhất với danh sách ngắn hơn. Khi trợ lý cần một khả năng không có trong danh sách ngắn, nó sẽ tự tra cứu (bằng các hàm hỗ trợ searchTools, describeTool và callTool) và chạy giúp bạn. Bạn không cần thiết lập hay chọn gì cả.

4. Kết nối tài khoản uPresenter

Khi bạn đăng nhập, trình duyệt mở một trang uPresenter có tiêu đề Kết nối Claude với uPresenter? (tên trong tiêu đề là ứng dụng đã yêu cầu quyền truy cập, chẳng hạn Claude hoặc Codex). Nếu bạn chưa đăng nhập uPresenter, bạn sẽ được yêu cầu đăng nhập trước rồi được đưa trở lại trang này.

Hãy đọc trang này trước khi tiếp tục:

Bạn cũng có thể thấy một thông báo màu vàng:

Thông báo này là bước kiểm tra an toàn, không phải lỗi. Nếu bạn không phải là người bắt đầu kết nối, hãy chọn Hủy.

Chọn Cho phép để hoàn tất, hoặc Hủy để từ chối. Sau đó trang sẽ đưa bạn quay lại trợ lý. Nếu bạn chờ quá lâu, bạn có thể thấy Yêu cầu này đã hết hạn; hãy quay lại trợ lý và bắt đầu kết nối lại.

5. Quản lý hoặc gỡ quyền truy cập

Bạn vẫn giữ quyền kiểm soát sau khi kết nối. Để xem lại các ứng dụng có thể truy cập tài khoản của bạn:

  1. Mở Cài đặt từ thanh điều hướng chính.
  2. Chọn thẻ Ứng dụng đã kết nối. Thẻ này bị ẩn trong góc nhìn người học của bảng điều khiển.
  3. Tìm ứng dụng trong danh sách. Mỗi thẻ hiển thị tên ứng dụng, một huy hiệu Có thể chỉnh sửa hoặc Chỉ xem, nơi ứng dụng được đưa về, thời điểm kết nối và thời điểm sử dụng gần nhất.
  4. Để kết thúc kết nối, chọn Gỡ quyền truy cập.
  5. Một hộp thoại xác nhận có tiêu đề Gỡ kèm tên ứng dụng (ví dụ Gỡ Claude?) xuất hiện. Hộp thoại giải thích rằng ứng dụng sẽ mất quyền truy cập ngay lập tức và bạn có thể kết nối lại bất cứ lúc nào. Chọn Gỡ quyền truy cập để xác nhận, hoặc Hủy để giữ lại.

Hãy gỡ quyền truy cập bất cứ khi nào bạn ngừng dùng một công cụ, cho người khác mượn máy tính hoặc lỡ kết nối nhầm một ứng dụng. Hộp thoại Kết nối AI trong trình soạn thảo cũng có nút Quản lý ứng dụng đã kết nối mở ra cùng thẻ này.

6. Chạy phiên làm việc đầu tiên

Hãy bắt đầu một cuộc trò chuyện mới trong Claude hoặc Codex sau khi đã kết nối. Một cuộc trò chuyện đã mở từ trước khi bạn cài plugin có thể không biết đến plugin.

Giữ một tab trình soạn thảo luôn mở

Trợ lý thay đổi trang chiếu trong bài thuyết trình bạn đang mở trong trình soạn thảo uPresenter, vì vậy tab đó cần được giữ mở. Hãy coi tab này như một màn hình dùng chung: trợ lý làm việc trên đó và bạn theo dõi từng thay đổi xuất hiện. Nếu bạn đóng tab, trợ lý không thể truy cập các trang chiếu nữa và sẽ yêu cầu bạn mở lại trình soạn thảo.

Yêu cầu một bài thuyết trình mới

Hãy mô tả điều bạn muốn bằng ngôn ngữ tự nhiên, ví dụ:

Tạo một bài học 10 trang chiếu về quang hợp cho học sinh lớp 6, giọng điệu thân thiện, có một bài kiểm tra ngắn ở cuối.

Trợ lý có thể hỏi trước bạn thích thiết kế nào. Nó hiển thị một vài mẫu phù hợp với chủ đề của bạn, cùng với Design from scratch. Hãy chọn một lựa chọn; lựa chọn đầu tiên thường là lựa chọn được đề xuất.

Tiếp theo, trợ lý đưa cho bạn một liên kết để tạo bài thuyết trình mới. Hãy mở liên kết trong trình duyệt và giữ tab đó luôn mở. Sau đó trợ lý sẽ nhận ra trình soạn thảo và bắt đầu xây dựng: chèn các trang chiếu từ mẫu, thay văn bản mẫu bằng nội dung của bạn và kiểm tra kết quả.

Yêu cầu thay đổi một bài thuyết trình có sẵn

Để làm việc trên một bài học bạn đã có, hãy mở nó trong trình soạn thảo và giữ tab luôn mở. Bạn cũng có thể nhờ trợ lý liệt kê các bài thuyết trình của mình; nó sẽ đưa cho bạn liên kết đến bài bạn muốn để bạn mở.

Những yêu cầu hiệu quả

Viết lời nhắc tốt hơn

Hãy nêu càng nhiều thông tin sau càng tốt:

Kiểm tra kết quả

Trợ lý tự xem lại các trang chiếu sau khi xây dựng và sửa những lỗi rõ ràng, nhưng bạn vẫn là tác giả. Hãy mở bài thuyết trình, đi qua từng trang chiếu và kiểm tra dữ kiện, câu chữ, hình ảnh, đáp án bài kiểm tra và cài đặt trình phát. Dùng Hoàn tác trong trình soạn thảo cho thay đổi bạn không muốn, hoặc nhờ trợ lý hoàn tác. Với các thay đổi lớn hơn, lịch sử phiên bản cho phép bạn quay lại trạng thái trước đó.

7. Biết những gì plugin không làm được

Plugin dùng để xây dựng và chỉnh sửa nội dung. Hãy tự thực hiện những việc sau trong uPresenter:

Công việc Nơi thực hiện
Xuất sang PDF, hình ảnh, HTML5, SCORM hoặc xAPI; cài đặt xuất bản và chia sẻ Phần XV: Xuất nội dung và Phần XIV: Chia sẻ, xuất bản và hồ sơ công khai
Báo cáo Phần XVI: Báo cáo và phân tích
Lớp học và giao bài Phần XVII: Lớp học và quản lý người học
Tài khoản, thanh toán và tín dụng Phần XIX: Tài khoản, gói đăng ký, tín dụng, dung lượng lưu trữ và quyền riêng tư
Lịch sử phiên bản, ghi chú của người trình bày, văn bản thay thế cho hình ảnh và phụ đề video Trình soạn thảo uPresenter
Tạo hình ảnh mới bằng AI Các công cụ hình ảnh AI riêng của trình soạn thảo (Mục 3.3)

Trợ lý cũng chỉ làm việc trên bài thuyết trình đang mở trong trình soạn thảo. Nó không đọc các trang web hay tệp khác của bạn và không thể đăng nhập thay bạn.

Nếu bạn yêu cầu điều nó không làm được, một trợ lý hoạt động đúng sẽ cho bạn biết và hướng bạn đến trình soạn thảo. Nếu nó từng nói đã xuất một tệp hoặc thay đổi một cài đặt bên ngoài trình soạn thảo, hãy kiểm tra trong uPresenter trước khi tin vào điều đó.

8. Luôn cập nhật plugin

uPresenter phát hành các phiên bản plugin mới khi trình soạn thảo có thêm tính năng: bố cục mẫu mới, loại câu hỏi mới, khả năng xây dựng trò chơi tốt hơn và các bản sửa lỗi. Plugin được cập nhật sẽ biết cách dùng những tính năng này; plugin cũ có thể nói rằng nó không làm được một việc mà trình soạn thảo đã hỗ trợ. Việc cập nhật chỉ thay đổi plugin. Các bài thuyết trình và thông tin đăng nhập của bạn vẫn giữ nguyên, nên bạn không cần kết nối lại tài khoản.

Claude Code

Cách dễ nhất là để Claude Code tự cập nhật plugin cho bạn. Hãy bật tính năng này một lần:

  1. Trong Claude Code, gõ /plugin.
  2. Mở thẻ Marketplaces và chọn upresenter.
  3. Chọn Enable auto-update.

Từ đó trở đi, Claude Code sẽ kiểm tra phiên bản mới ngay sau khi bạn bắt đầu một phiên và tải xuống ở chế độ nền. Khi đã cập nhật plugin, nó sẽ thông báo cho bạn. Phiên bản mới được dùng từ lần tiếp theo bạn khởi động Claude Code, hoặc ngay lập tức nếu bạn gõ /reload-plugins.

Cập nhật tự động bị tắt với các plugin không đến từ marketplace của chính Anthropic, vì vậy cài đặt ở trên là cách duy nhất để nhận cập nhật tự động. Nếu bạn muốn tự cập nhật thủ công, hãy chạy lệnh sau mỗi khi uPresenter thông báo có phiên bản mới:

claude plugin update upresenter@upresenter

Sau đó gõ /reload-plugins trong phiên đang chạy, hoặc khởi động lại Claude Code. Để xem phiên bản bạn đang dùng, gõ /plugin và mở thẻ Installed.

Claude Desktop và Claude trên web

Khi bạn cài uPresenter từ danh mục Plugins của Claude, các phiên bản mới sẽ đến qua danh mục đó. Khi bạn thêm plugin từ tệp, Claude không thể cập nhật giúp bạn: hãy tải tệp .zip hoặc .plugin mới hơn từ trang phát hành plugin uPresenter và thêm lại trong Settings > Plugins.

Codex

Trong terminal, hãy chạy:

codex plugin marketplace upgrade upresenter

Nếu bạn dùng ứng dụng Codex hoặc IDE, hãy khởi động lại và mở một luồng mới sau đó để nó tải phiên bản mới.

Khi nào nên cập nhật

Hãy cập nhật khi uPresenter thông báo có phiên bản plugin mới, và bất cứ khi nào trợ lý có vẻ không biết đến một tính năng bạn thấy trong trình soạn thảo. Bắt đầu một cuộc trò chuyện mới sau khi cập nhật: cuộc trò chuyện đã mở trước đó vẫn tiếp tục dùng phiên bản lúc nó bắt đầu.

Khắc phục sự cố

Điều xảy ra Cách xử lý
Trợ lý nói không có công cụ uPresenter nào sau khi bạn đã đăng nhập Bắt đầu một cuộc trò chuyện mới (hoặc một luồng Codex mới). Các cuộc trò chuyện đã mở trước khi cài plugin sẽ không nhận plugin. Trong Claude Code, kiểm tra /mcp hiển thị upresenter ở trạng thái đã kết nối.
Trợ lý nói không có bài thuyết trình nào đang mở Mở bài thuyết trình, hoặc liên kết trợ lý đã đưa, trong trình soạn thảo uPresenter và giữ tab luôn mở. Sau đó nhờ trợ lý thử lại.
Trang đăng nhập không mở ra Kiểm tra trình duyệt cho phép cửa sổ bật lên hoặc tab mới, rồi lặp lại bước đăng nhập: /mcp và Authenticate trong Claude Code, codex mcp login upresenter trong Codex, hoặc Connect trên trang plugin trong Claude.
Trang đồng ý hiển thị Yêu cầu này đã hết hạn Quay lại trợ lý và bắt đầu kết nối lại.
Trang đồng ý hiển thị sai email Chọn Hủy, đăng xuất khỏi uPresenter, đăng nhập bằng đúng tài khoản và kết nối lại. Sau đó kiểm tra Ứng dụng đã kết nối để gỡ mọi ứng dụng đã kết nối với nhầm tài khoản.
Codex chỉ liệt kê một vài khả năng uPresenter Điều này là bình thường. Codex tự tìm các khả năng khác khi cần.
Bạn yêu cầu xuất, xem báo cáo hoặc lớp học nhưng không có gì xảy ra Plugin không làm được những việc này. Hãy dùng trình soạn thảo, như mô tả ở Mục 7.
Trợ lý ngừng phản hồi các thay đổi trong trình soạn thảo Kiểm tra tab trình soạn thảo vẫn đang mở và không bị tải lại sang một bài thuyết trình khác.
Trợ lý nói không làm được một việc mà trình soạn thảo có hỗ trợ Cập nhật plugin như mô tả ở Mục 8, rồi bắt đầu một cuộc trò chuyện mới.

Kiểm tra nhanh

Trước khi kết thúc, hãy chắc chắn bạn có thể:

Trước: Dùng Cảm hứng và Remix nội dung công khai · Tiếp theo: Làm quen với màn hình trình soạn thảo · Quay lại Phần III · Quay lại toàn bộ hướng dẫn