Kỹ thuật yêu cầu tác nhân hóa
Các tác nhân AI mang lại những lợi thế đáng kể cho các tác vụ kỹ thuật như thu thập yêu cầu bằng cách cải thiện đáng kể hiệu quả và tự động hóa các quy trình làm việc phức tạp, lặp đi lặp lại. Engineering Assistant của Requirements Portal tận dụng công nghệ AI để cung cấp cho bạn một công cụ rà soát nhanh, tự động cho các yêu cầu của bạn, cho phép bạn đặt câu hỏi về các yêu cầu trong dự án hiện tại bằng ngôn ngữ tự nhiên, tự do và nhận câu trả lời nhanh mà không cần lọc hoặc tìm kiếm thủ công trong các yêu cầu, ví dụ:
-
How many requirements are not verified?
-
Are there any engineering gaps in these requirements?
-
Show me all requirements about the power supply.
-
Which requirements need to be taken into account for PCB design?
-
Do any requirements conflict with each other?
-
Give me an overview of all battery-related requirements.
Engineering Assistant cũng có thể sửa đổi, tạo mới hoặc xóa yêu cầu. Khi bạn gửi yêu cầu tạo mới, thay đổi hoặc xóa một yêu cầu hiện có, Engineering Assistant sẽ cung cấp cho bạn bản tóm tắt các thay đổi sẽ được áp dụng, và bạn có thể xem lại chúng rồi sau đó chọn áp dụng hoặc loại bỏ các thay đổi. Ví dụ về các yêu cầu như vậy:
-
Generate requirements for a lightweight drone power supply that takes a 6S LiPo input, provides regulated 5 V / 5 A and 12 V / 3 A outputs, and weighs under 150 g. It should handle vibration and -10°C to +50°C operation, with protection for short circuit, reverse polarity, overtemperature, and low battery.
-
Change the required maximum operating temperature for all parts to 60°C.
-
Can you identify all requirements that affect the sizing of the power system and ensure they are verifiable?
-
In the new design, I've replaced the camera with an IR sensor. Remove all requirements that were related to the camera.
Có thể truy cập Engineering Assistant qua ngăn Engineering Assistant có sẵn trong Requirement Module bằng cách nhấp vào biểu tượng
ở góc trên bên phải.
Bạn có thể xem ngữ cảnh trò chuyện hiện tại bằng cách nhấp vào nút
ở cuối ngăn Engineering Assistant. Cửa sổ bật lên Chat Context sẽ mở ra và hiển thị thông tin sau:
-
Project – hiển thị tên của dự án hiện tại và tên của thư mục, đặc tả hoặc mục hiện đang được chọn.
-
Filters – hiển thị số lượng bộ lọc hiện đang được áp dụng cho bảng và danh sách các cột đang được áp dụng bộ lọc.
-
Rows selected – hiển thị số lượng hàng yêu cầu hiện đang được chọn.
Để sử dụng Engineering Assistant, hãy nhập truy vấn của bạn vào trường Ask anything ở cuối ngăn Engineering Assistant và nhấp vào biểu tượng
hoặc nhấn Enter. Engineering Assistant sẽ phân tích các yêu cầu và hiển thị câu trả lời phù hợp trong ngăn. Tùy theo truy vấn, Engineering Assistant sẽ trả về một câu trả lời dạng số, một danh sách ID yêu cầu, hoặc một bản tóm tắt ngắn. (Các) yêu cầu liên quan đến truy vấn sẽ được làm nổi bật trong bảng yêu cầu, và số lượng yêu cầu liên quan được hiển thị trong cây dự án bên cạnh các đặc tả, mục và thư mục tương ứng.
Khi bạn gửi yêu cầu tới Engineering Assistant để tạo mới, thay đổi hoặc xóa một yêu cầu hiện có, các thay đổi được đề xuất sẽ hiển thị trong một ô riêng trong ngăn Engineering Assistant nơi bạn có thể xem lại chúng (bằng cách mở rộng vùng thu gọn Changes summary ) rồi chọn áp dụng hoặc loại bỏ các thay đổi. Ngoài ra, các thay đổi được đề xuất cũng sẽ hiển thị trong bảng yêu cầu như sau:
-
Các yêu cầu mới được làm nổi bật bằng màu xanh lá, với biểu tượng trong biểu tượng
ở cột Identifier.
-
Các yêu cầu đã thay đổi được làm nổi bật bằng màu tím, với biểu tượng
ở cột Identifier. Các thay đổi thực tế cũng được làm nổi bật trong bảng.
-
Các yêu cầu được đề xuất xóa sẽ được làm nổi bật bằng màu đỏ, với biểu tượng
ở cột Identifier.
Sử dụng và quản lý AI Skills
Một skill là một tập chỉ dẫn có thể tái sử dụng mà Engineering Assistant có thể thực thi để thực hiện một tác vụ cụ thể một cách nhất quán hơn. Một skill đóng gói cách một tác vụ kỹ thuật cụ thể nên được thực hiện – mục đích, phạm vi giới hạn, dữ liệu đầu vào cần thiết, các bước cần làm theo – để cùng một kết quả được tạo ra một cách nhất quán, bất kể ai chạy hoặc khi nào chạy, mà không cần mỗi người dùng phải giải thích lại cùng một chỉ dẫn mỗi lần.
Một skill có thể được xem là:
-
Một quy trình công việc kỹ thuật có thể lặp lại
-
Một tiêu chuẩn tổ chức được biến thành có thể thực thi
-
Một cách đóng gói chuyên môn và làm cho nó có thể tái sử dụng
Skills được AI tự động gọi, hệ thống sẽ tự động chọn và áp dụng chúng dựa trên mục đích của bạn. Bạn không cần ghi nhớ lệnh hay chọn skill thủ công. Khi bạn gửi một tin nhắn, Engineering Assistant sẽ:
-
Phân tích mục đích của bạn và ngữ cảnh hiện tại.
-
Xem xét các skill có sẵn trong Workspace.
-
So sánh yêu cầu của bạn với Short Description của từng skill để xác định skill nào phù hợp.
-
Chọn skill khớp nhất.
-
Thực hiện theo Instructions của skill để hoàn thành tác vụ.
-
Trả về kết quả để bạn xem xét.
Ví dụ, khi bạn gửi Rewrite these requirements using our company writing standard, Engineering Assistant sẽ nhận diện mục đích (chuẩn hóa yêu cầu), xác định skill có mô tả ngắn khớp nhất với yêu cầu đó, thực thi các chỉ dẫn được định nghĩa trong skill đó, rồi trả về các yêu cầu đã được cải thiện.
Skill Use Examples
-
Break Down Complex Requirements – phân tích các yêu cầu đã chọn và tách chúng thành các yêu cầu nhỏ hơn, có thể kiểm thử độc lập trong khi vẫn giữ nguyên ý định ban đầu.
Ví dụ lời nhắc:
Break down these requirements. -
Apply Requirement Writing Standards – rà soát các yêu cầu và viết lại chúng theo hướng dẫn viết yêu cầu của tổ chức bạn. Các kiểm tra điển hình bao gồm tính mơ hồ, ngôn ngữ không thể kiểm chứng, thiếu tác nhân thực hiện và tiêu chí chấp nhận không rõ ràng.
Ví dụ lời nhắc:
Rewrite these requirements according to our requirement quality standard. -
Translate Requirements – dịch các yêu cầu từ ngôn ngữ này sang ngôn ngữ khác trong khi vẫn giữ nguyên ý nghĩa kỹ thuật, thuật ngữ, ID và các tham chiếu truy vết.
Ví dụ lời nhắc:
Translate these requirements to German. -
Classify Requirements – áp dụng một sơ đồ phân loại của tổ chức cho các yêu cầu, chẳng hạn như Điện tử, Cơ khí, Phần mềm, An toàn, Bảo mật hoặc các hệ phân loại riêng khác của công ty.
Ví dụ lời nhắc:
Classify these requirements according to our applicability model. -
Generate Verification Criteria – phân tích các yêu cầu và đề xuất các phương pháp xác minh, tiêu chí chấp nhận hoặc điều kiện thử nghiệm có thể được sử dụng để chứng minh sự tuân thủ theo cùng một cách nhất quán.
Ví dụ lời nhắc:
Generate verification criteria for these requirements. -
Summarize a Specification/Section/Group of Requirements – tạo một bản tóm tắt ngắn gọn, có cấu trúc cho một đặc tả, một mục yêu cầu hoặc một tập yêu cầu.
Ví dụ lời nhắc:
Summarize the selected requirements.
Một tập các skill khả dụng được quản lý bằng cửa sổ AI Skills được truy cập bằng cách nhấp vào nút
ở góc trên bên phải của ngăn Engineering Assistant. Từ cửa sổ này, bạn có thể thêm mới, thay đổi và xóa các skill hiện có.
-
Các skill hiện có được liệt kê trong vùng Workspace Skills ở phía bên trái của cửa sổ. Nhấp vào một mục để hiển thị chi tiết của skill đã chọn.
-
Để thêm skill mới, nhấp vào nút
ở phía dưới bên trái cửa sổ. Một mục cho skill mới sẽ xuất hiện trong danh sách. Xác định Name, Short Description và Instructions cho skill mới rồi nhấp vào nút
ở phía dưới bên phải.
Tham khảo phần thu gọn Các phương pháp hay nhất để xây dựng một Skill bên dưới để biết chi tiết về từng trường.
-
Để chỉnh sửa một skill hiện có, hãy chọn skill đó trong danh sách, thay đổi các trường theo nhu cầu, rồi nhấp vào nút
ở phía dưới bên phải.
-
Để xóa một skill hiện có, hãy chọn skill đó trong danh sách, nhấp vào nút
ở phía dưới bên phải, rồi xác nhận việc xóa.
Best Practices for Formulating a Skill
Một skill tốt giúp AI hiểu hai điều:
-
Khi nào nên dùng skill
-
AI nên làm gì khi skill được chạy
Khi bạn định nghĩa một skill,
Điều này được thể hiện thông qua ba trường, trong đó mỗi trường có một mục đích khác nhau:
-
Name – giúp bạn nhận biết skill.
-
Short Description – giúp AI quyết định khi nào skill là phù hợp.
-
Instructions – xác định hành vi mà AI cần tuân theo khi skill được chọn.
Tham khảo các phần bên dưới để biết chi tiết về từng trường.
Tên
Name nên ngắn gọn, rõ ràng và định hướng hành động. Nó nên giúp bạn nhanh chóng hiểu skill được tạo ra để làm gì. Một tên tốt thường mô tả hành động và loại dữ liệu kỹ thuật mà skill làm việc cùng.
Một tên skill tốt nên:
-
Đủ cụ thể để phân biệt skill này với các skill khác
-
Đủ ngắn để dễ quét trong danh sách skill
-
Tập trung vào tác vụ chính mà skill thực hiện
-
Được viết bằng ngôn ngữ mà người dùng dễ hiểu một cách tự nhiên
Tránh các tên quá rộng hoặc quá chung chung. Nếu tên đó có thể áp dụng cho nhiều tác vụ khác nhau, thì có lẽ nó chưa đủ cụ thể.
Mô tả ngắn
Short Description giúp AI hiểu skill nói về điều gì và khi nào nó nên được kích hoạt. Trường này rất quan trọng vì bạn không cần chọn skill thủ công. Trợ lý sẽ phân tích lời nhắc của bạn, so sánh với các skill có sẵn và quyết định liệu một skill có liên quan hay không.
Một mô tả ngắn tốt nên giải thích:
-
Skill thực hiện tác vụ gì
-
Nó áp dụng cho loại dữ liệu kỹ thuật nào
-
Khi nào nên dùng skill
-
Kết quả mà skill được kỳ vọng sẽ tạo ra
Mô tả ngắn nên súc tích, nhưng không mơ hồ. Nó cần bao gồm đủ ngữ cảnh để AI phân biệt skill này với các skill tương tự.
Một mô tả ngắn yếu chỉ nói skill thuộc lĩnh vực nào. Một mô tả ngắn mạnh sẽ giải thích tác vụ cụ thể, ngữ cảnh kỳ vọng và tình huống kích hoạt. Ví dụ, thay vì mô tả một skill là thứ “giúp xử lý yêu cầu”, mô tả nên nêu rõ skill đó rà soát chất lượng yêu cầu, phân rã các yêu cầu phức tạp, dịch văn bản yêu cầu, phát hiện xung đột, tạo tiêu chí xác minh hay thực hiện một hành động cụ thể nào khác.
Mô tả ngắn giải thích mục đích và ngữ cảnh sử dụng của skill càng tốt thì trợ lý càng có thể quyết định đáng tin cậy hơn khi nào nên áp dụng nó.
Chỉ dẫn
Instructions xác định AI nên làm gì sau khi skill được chọn. Đây là trường quan trọng nhất để kiểm soát hành vi của skill. Trong khi mô tả ngắn giúp AI quyết định khi nào dùng skill, thì chỉ dẫn xác định skill sẽ chạy như thế nào.
Các chỉ dẫn nên giải thích:
-
What the AI should analyze first – trợ lý thường nên hiểu ý định kỹ thuật, ngữ cảnh, cấu trúc hoặc các mối quan hệ trước khi thay đổi hoặc tạo mới bất kỳ nội dung nào.
-
What steps the AI should perform – hành vi nên được chia thành các bước rõ ràng, để đầu ra có thể lặp lại và dự đoán được.
-
What the AI should preserve – điều này có thể bao gồm ý định ban đầu, ID yêu cầu, thuật ngữ kỹ thuật, đơn vị, giá trị, ràng buộc, tham chiếu, phạm vi áp dụng, phân cấp hoặc ngữ cảnh truy vết.
-
What the AI must not do – các skill tốt nêu rõ việc ngăn AI bịa ra các chi tiết kỹ thuật còn thiếu, thay đổi ý định, đưa vào các giả định mới hoặc áp dụng thay đổi mà không có bước người dùng xem xét.
-
How the AI should handle uncertainty – nếu thiếu thông tin, thông tin mơ hồ hoặc không đủ, skill nên chỉ dẫn AI nêu rõ vấn đề thay vì phỏng đoán.
-
What output format is expected – skill nên xác định xem kết quả nên là bảng, danh sách gạch đầu dòng, văn bản viết lại, bản tóm tắt, danh sách kiểm tra hay báo cáo có cấu trúc.
Các chỉ dẫn tốt đặc biệt quan trọng đối với công việc kỹ thuật vì trợ lý có thể đang làm việc với dữ liệu ảnh hưởng đến đặc tả, xác nhận/kiểm chứng, quyết định thiết kế hoặc triển khai ở các bước sau. Do đó, skill nên hướng dẫn AI sao cho hữu ích mà không trở nên quá tự tin.
Các lưu ý khác
-
Mục tiêu không phải là viết một lời nhắc dài. Mục tiêu là xác định một quy trình vận hành rõ ràng cho AI.
-
Keep Skills Focused
Một skill nên thực hiện tốt một tác vụ có thể lặp lại.
Nếu một skill cố gắng làm quá nhiều việc, trợ lý sẽ khó biết khi nào nên dùng nó hơn và người dùng cũng khó tin tưởng vào đầu ra hơn. Ví dụ, một skill không nên kết hợp phân rã yêu cầu, dịch thuật, rà soát chất lượng, phân tích truy vết và tạo xác minh trừ khi các hành động đó cố ý là một phần của cùng một quy trình làm việc được xác định chặt chẽ.
Nếu mục đích của skill đòi hỏi nhiều hành động không liên quan, hãy tách chúng thành các skill riêng biệt.
-
Define Boundaries Clearly
Các skill tốt nêu rõ ranh giới.
Điều này đặc biệt quan trọng khi làm việc với yêu cầu, đặc tả và dữ liệu kỹ thuật. Trợ lý cần biết nó được phép thay đổi điều gì, điều gì chỉ nên đề xuất và điều gì tuyệt đối không được giả định.
Các ranh giới hữu ích bao gồm:
-
Không thay đổi ý định kỹ thuật ban đầu
-
Không bịa ra giá trị, ràng buộc hoặc quyết định thiết kế
-
Không xóa ID hoặc tham chiếu
-
Không giả định các phương pháp xác minh còn thiếu
-
Không tự động áp dụng thay đổi khi chưa có người dùng xem xét
-
Không coi thông tin không rõ ràng là sự thật
Các ranh giới rõ ràng giúp giảm rủi ro tạo ra đầu ra kỹ thuật có vẻ hợp lý nhưng không chính xác.
-
-
Define the Output Format
Một skill nên cho AI biết cách trả về kết quả.
Một định dạng đầu ra nhất quán giúp skill dễ xem xét, so sánh và tái sử dụng hơn.
Tùy theo skill, đầu ra có thể là:
-
Một bảng
-
Một danh sách gạch đầu dòng
-
Một yêu cầu được viết lại
-
Một báo cáo có cấu trúc
-
Một danh sách kiểm tra
-
Một bản tóm tắt
-
Một danh sách các thay đổi được đề xuất
-
Một tập hợp câu hỏi hoặc các vấn đề còn mở
Định dạng đầu ra nên phù hợp với mục đích của skill. Ví dụ, các skill định hướng rà soát thường hoạt động hiệu quả dưới dạng bảng có các cột vấn đề, giải thích và khuyến nghị. Các skill định hướng viết lại thường hoạt động tốt khi hiển thị văn bản gốc, đầu ra được đề xuất và cơ sở lý do.
-
.









).
).
