Viết một prompt khiến agent xây dựng một công cụ: 3 phần

Bạn yêu cầu một agent "làm một công cụ", và nhận được thứ gì đó mơ hồ không khớp với ứng dụng của bạn. Cách khắc phục không phải là một prompt dài hơn, mà là một prompt có ba phần cụ thể: công cụ nằm ở đâu, nó làm gì, và những chi tiết cụ thể phải được đảm bảo. Cũng nên chuẩn bị cho nhiều hơn một vòng: ngay cả DeepSeek cũng nói rằng một số plugin demo của họ đã được tinh chỉnh qua nhiều vòng hội thoại.

Hầu hết các prompt trong bộ sưu tập của DeepSeek cho video demo Harness Creator Mode đều thể hiện hình dạng ba phần đó. Trang (bộ sưu tập prompt Creator Mode của DeepSeek, kiểm tra ngày 3 tháng 11 năm 2026, trang không có ngày xuất bản) liệt kê bảy plugin: một thư viện 3D các địa danh nổi tiếng, một hình ảnh trực quan 3D Transformer, một giao diện DSH pixel hóa, một bàn thiết kế poster, một bàn biên tập video, một trình đọc bài báo và thống kê hội thoại. Để dùng một cái, bạn dán prompt vào DeepSeek Harness và chọn tùy chọn Creator Mode. Mỗi prompt được đưa ra bằng tiếng Anh và tiếng Trung.

Ba phần trông như thế nào trong một prompt thực tế#

Lấy prompt hình ảnh trực quan 3D Transformer từ trang đó. Nó mở đầu bằng "Create a DeepSeek Harness plugin with a left sidebar entry". Đó là phần một: công cụ nằm ở đâu. Sau đó nó mô tả chức năng: một trò chơi trình diễn 3D tương tác giải thích tính toán của Transformer. Phần hai. Nó kết thúc bằng một yêu cầu dễ quên và khó sửa sau này: tiêu đề bảng điều khiển và thanh công cụ không được chồng lên các nút cửa sổ gốc của macOS. Phần ba.

Các prompt khác trên trang theo cùng hình dạng, với những khác biệt. Điểm vào thay đổi: một mục ở thanh bên trái trong ba prompt, một điểm truy cập từ cuộc hội thoại trong hai prompt, thanh bên phải trong trình đọc bài báo. Phần kết thúc là nơi chúng trở nên cụ thể: năm kiểu, một trong số đó là pixel hóa, hoặc tiêu đề trang mặc định là "Everything is a plugin". Đó là mẫu đáng sao chép, và sự khác biệt lộ ra nhanh chóng:

Phiên bản đầu tiên để agent đoán mò về mọi thứ. Nó đi đâu? Thanh bên, một lệnh, một cửa sổ riêng? Thế nào là "cho các cuộc hội thoại của tôi"? Phiên bản thứ hai trả lời những câu hỏi đó trước khi agent phải hỏi.

Viết của riêng bạn, từng phần một#

Giả sử bạn muốn một bảng điều khiển nhỏ đọc một bài báo và cho phép bạn đặt câu hỏi về nó. Đi qua các phần theo thứ tự.

Nó nằm ở đâu. Một câu, và nêu chính xác vị trí: "một plugin với một mục ở thanh bên trái", "một nút trên thanh công cụ", "một trang mở từ menu". Nếu bạn bỏ qua, agent sẽ chọn thay bạn.

Nó làm gì. Mô tả những gì bạn thấy và nhấp, không phải cách nó được xây dựng. "Bạn thả vào một PDF, bên trái hiển thị văn bản, bên phải có một cuộc trò chuyện về nó." Bỏ qua framework trừ khi bạn có lý do để nêu tên một cái.

Yêu cầu cụ thể. Đây là nơi những thứ đã sai lần trước được đưa vào. Quy tắc bố cục, những thứ không được chồng lên nhau, một ngôn ngữ, một định dạng tệp, một giới hạn như "không gọi mạng". Những dòng ngắn, có thể kiểm tra. Nếu bạn không thể biết liệu một yêu cầu có được đáp ứng bằng cách nhìn vào kết quả, hãy viết lại cho đến khi có thể.

Ghép lại:

Create a plugin with a left sidebar entry.
It is a paper reader: I open a PDF, the text is shown
on the left, and a chat about the paper is on the right.
Requirements:
- the panel title must not overlap the window buttons
- the chat answers only from the paper's text
- keep everything in one file

Gửi nó qua API#

Creator Mode là một tính năng của DeepSeek Harness; bản thân prompt là văn bản thuần, nên bất cứ thứ gì đọc được prompt đều có thể chạy nó, kể cả một script gọi API CheapTokens. Prompt dưới đây là prompt ở trên, được gửi đến DeepSeek-V4-Flash (id đầy đủ deepseek-ai/DeepSeek-V4-Flash-0731, ngữ cảnh 380K, tối đa 32.768 token trong một câu trả lời, đủ chỗ cho cả một plugin trong một lần trả lời):

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)

prompt = """Create a plugin with a left sidebar entry.
It is a paper reader: I open a PDF, the text is shown
on the left, and a chat about the paper is on the right.
Requirements:
- the panel title must not overlap the window buttons
- the chat answers only from the paper's text
- keep everything in one file"""

resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": prompt}],
    max_tokens=8000,
)
print(resp.choices[0].message.content)
print(resp.choices[0].finish_reason, resp.usage)

Khóa nằm trong một biến môi trường, không bao giờ trong tệp. Nếu finish_reason in ra length, plugin đã bị cắt bởi max_tokens: hãy tăng giới hạn. Việc thiết lập bản thân DeepSeek Harness với một nhà cung cấp tùy chỉnh là một công việc riêng, được đề cập trong kết nối DeepSeek Harness với CheapTokens. Những điều cơ bản về yêu cầu đầu tiên có trong tài liệu CheapTokens.

Tại sao một prompt hiếm khi đủ#

DeepSeek nói thẳng: một số plugin demo đã được tinh chỉnh qua nhiều vòng hội thoại, nên một prompt duy nhất có thể không tái tạo chính xác video. Hãy nghĩ về nó như việc giao việc cho một nhà thầu. Bản vẽ đầu tiên cho bạn phần lớn căn phòng, và bạn đi qua nó và nói "cửa mở sai hướng".

Và đó là nơi tiền đi. Một agent gửi lại cuộc hội thoại với mỗi vòng (cùng hiệu ứng như trong tại sao một cuộc trò chuyện dài tốn kém hơn), nên vòng năm mang theo prompt, bốn câu trả lời trước đó và tất cả mã cho đến nay.

Một phiên xây dựng tốn bao nhiêu#

Đây là một phiên giả định, không phải đo lường: năm vòng, khoảng 12.000 token gửi mỗi vòng (prompt, lịch sử, mã hiện tại) và khoảng 6.000 token được viết lại. Bảng dưới đây sử dụng giá CheapTokens trực tiếp cho từng mô hình; cột OpenRouter ở đó để so sánh cùng một phiên tổng cộng, với đầu vào và đầu ra được tính cùng nhau.

Cho một vòng DeepSeek-V4-Flash, cùng những con số đó ra $0.00078. Nếu plugin của bạn lớn hơn, lịch sử tăng mỗi vòng, nên hãy thay đổi hai con số và chạy lại ước tính. Thêm về ước tính hóa đơn agent trong cách ước tính chi phí của một AI agent, và danh sách mô hình có trên trang giá.

Kiểm tra trước khi gửi#

Viết prompt đầu tiên, đọc những gì trả về, và đưa mọi chỉnh sửa vào phiên bản tiếp theo của các yêu cầu. Sau hai hoặc ba phiên, bạn sẽ có một danh sách ngắn các dòng mà bạn dán vào mọi prompt mới, và vòng đầu tiên sẽ ra gần với ý bạn hơn. Để biết những thói quen cơ bản của bất kỳ prompt nào, xem cách viết một prompt tốt.