Xây dựng hướng dẫn dành riêng cho agent trong ElevenLabs

Các hướng dẫn dành riêng cho tác vụ mà agent sẽ load khi cần thiết

Tổng quan về quy trình cho agent

Một quy trình bao gồm các hướng dẫn cho một tác vụ cụ thể. Mỗi quy trình đều có một điều kiện kích hoạt (trigger) xác định thời điểm áp dụng và phần nội dung mô tả các bước cần thực hiện. Khi cuộc hội thoại khớp với điều kiện kích hoạt, agent sẽ load quy trình đó.

Hãy sử dụng quy trình khi agent cần xử lý nhiều tác vụ riêng biệt. Một ví dụ điển hình là agent hỗ trợ khách hàng, trong đó mỗi quy trình giải quyết một loại yêu cầu cụ thể: Hoàn tiền, xác minh danh tính, khôi phục tài khoản hoặc khắc phục sự cố kết nối.

Các loại quy trình cho agent

Có hai loại quy trình:

• Quy trình tự do (Free-form): Được viết dưới dạng hướng dẫn bằng ngôn ngữ tự nhiên; agent sẽ diễn giải và điều chỉnh cách thực hiện tùy theo tình huống.
• Quy trình có cấu trúc (Structured): Là danh sách các bước được sắp xếp theo thứ tự cụ thể; agent sẽ thực hiện những bước này theo cùng một cách trong mọi lần.

Bạn có thể sử dụng cả hai loại quy trình này, kết hợp với các workflow, trên cùng một agent. Agent sẽ chọn quy trình phù hợp dựa trên điều kiện kích hoạt, bất kể loại quy trình đó là gì.

Khi nào nên sử dụng quy trình?

Mỗi agent đều có một câu lệnh hệ thống (system prompt). Quy trình và workflow là hai phương thức thay thế để bổ sung cấu trúc cho agent. Hãy lựa chọn dựa trên mức độ biến đổi có thể xảy ra trong cuộc hội thoại.

Quản lý quy trình

Sử dụng dashboard là phương thức được khuyến nghị để xây dựng các quy trình. Bạn có thể sử dụng API để quản lý quy trình theo phương thức lập trình hoặc tích hợp chúng vào các công cụ triển khai.

Xây dựng qua dashboard

Mở agent của bạn trong dashboard, sau đó chọn mục Procedures. Sử dụng nút + để tạo quy trình tự do (free-form) hoặc quy trình có cấu trúc (structured). 

Quản lý qua API

Các bản nháp quy trình tuân theo vòng đời quản lý phiên bản của agent. Chúng được quản lý theo từng người dùng và từng nhánh, nghĩa là mỗi thành viên trong nhóm sẽ có các bản nháp riêng trên mỗi nhánh. Việc xuất bản sẽ lưu lại các thay đổi quy trình của bạn vào một phiên bản agent mới, cố định (không thể thay đổi) trên nhánh đó. Các bản nháp của người dùng khác sẽ không bị ảnh hưởng.

Các phản hồi cấu hình agent bao gồm siêu dữ liệu (metadata) của quy trình như ID, tên, loại và điều kiện kích hoạt (trigger), nhưng không bao gồm nội dung chi tiết hoặc bản nháp của quy trình. Hãy sử dụng các endpoint dành riêng cho quy trình để đọc và chỉnh sửa toàn bộ nội dung. Tất cả các endpoint quy trình đều nằm trong đường dẫn /v1/convai/agents/{agent_id}/branches/{branch_id}.

1. Tạo hoặc cập nhật bản nháp

Tạo quy trình bằng phương thức POST /procedures. Cập nhật quy trình bằng PATCH /procedures/{procedure_id}/draft, trong đó mỗi yêu cầu cần bao gồm tên, nội dung, loại và điều kiện kích hoạt.

Sử dụng GET /procedures/{procedure_id}/draft để xem các thay đổi chưa được xuất bản. Nếu không có bản nháp nào, endpoint sẽ trả về phiên bản đã được xuất bản.

2. Xuất bản các thay đổi

Xuất bản bản nháp bằng cách tạo một phiên bản agent mới. Các quy trình dạng tự do (free-form) có thể được xuất bản trực tiếp. Đối với quy trình có cấu trúc (structured), trước tiên cần gọi /procedures/compile để tạo workflow.

Hãy làm theo các hướng dẫn cụ thể cho từng loại quy trình (dạng tự do hoặc có cấu trúc).

3. Hủy bỏ hoặc xóa quy trình

DELETE /procedures/{procedure_id}/draft giúp hủy bỏ các chỉnh sửa chưa được xuất bản và khôi phục lại phiên bản đã xuất bản. Nếu quy trình chưa từng được xuất bản, thao tác này sẽ xóa hoàn toàn quy trình đó.

DELETE /procedures/{procedure_id} đánh dấu quy trình đã xuất bản để chờ xóa. Hãy thực hiện xuất bản thay đổi này theo quy trình cụ thể cho từng loại đã nêu ở trên.

Các hạn chế

• Nội dung của một quy trình bị giới hạn ở mức 50.000 ký tự.
• Bạn không thể thay đổi loại quy trình sau khi đã tạo.
• Các quy trình thuộc về một agent cụ thể. Chúng không thể được chia sẻ giữa các agent hoặc lưu trữ dưới dạng tài nguyên cấp workspace.
• Khi sao chép một agent, các quy trình của nó sẽ được sao chép thay vì chia sẻ dùng chung. Các bản sao sẽ nhận ID quy trình mới, do đó các tham chiếu trong agent được sao chép phải sử dụng những ID mới này.
• Quy trình có cấu trúc không thể tham chiếu đến các tài liệu trong cơ sở kiến thức.