Bên cạnh việc người dùng có thể tự định nghĩa các biến đầu vào trong khối Bắt đầu (Start), hệ thống còn hỗ trợ sử dụng thêm các biến mặc định (biến hệ thống). Các biến này sẽ tự động được gán giá trị từ hệ thống khi tác vụ được thực thi. Việc sử dụng biến mặc định giúp:Documentation Index
Fetch the complete documentation index at: https://docs-agents.fpt.ai/llms.txt
Use this file to discover all available pages before exploring further.
- Đảm bảo tính nhất quán và chính xác của dữ liệu đầu vào.
- Hạn chế rủi ro Agent nhầm lẫn trong việc truyền giá trị biến và xử lý các biến phức tạp dưới dạng object.
| STT | Tên biến | Kiểu dữ liệu | Mô tả |
|---|---|---|---|
| 1 | user_message | string | Câu query của user |
| 2 | rewrite_message | string | Câu query của user đã được viết lại |
| 3 | extra | object | Thông tin thêm khi tích hợp với app bên thứ 3 |
| 4 | knowledge | object | Kết quả lấy khi trích xuất thông tin. Cấu trúc: { 'answerable': Boolean, 'query_type': Chitchat/QnA, 'related_docs': list[str], 'instruction_if_no_doc': instruction_if_no_doc, 'direct_answer': direct_answer } |
| 5 | sender_id | string | Id của user |
| 6 | sender_name | string | Tên của user |
| 7 | chat_turn_info | object | Thông tin turn chat. Cấu trúc: { 'message_id': str, 'bot_code': input.bot_code, 'tenant_id': input.tenant_id, 'conversation_id': input.conversation_id, 'channel': input.channel, 'sender_id': input.sender_id, 'broker_id': input.broker_id, 'sender_name': input.sender_name } |
| 8 | chat_history | object | Lịch sử cuộc hội thoại |
| 9 | persona | string | Persona của Agent |
| 10 | sys.attachments | array[file] | Thông tin của tệp do người dùng tải lên trong quá trình thực thi nhiệm vụ. Cấu trúc: { "type": "", "url": "" } |
| 11 | sys.urls | array[string] | Các URL người dùng mong muốn lấy thông tin. Cấu trúc: ["", ""]. Để truyền giá trị vào biến sys.urls, cần dùng tính năng Kích hoạt Agent qua Webhook. Hệ thống cho phép thêm tối đa 5 URL trong biến sys.urls |
| 12 | sys.mentioned_file | array[processed_file] | Truyền vào các tệp mà người dùng mention trong quá trình trò chuyện trên MyAgents |
- Thêm biến vào các khối: Biến hệ thống có thể được sử dụng trong bất kỳ khối nào của quy trình như một biến đầu vào.
- Điền giá trị khi kiểm thử: Trong quá trình kiểm thử từng khối hoặc toàn bộ quy trình, người dùng có thể xem và điều chỉnh giá trị của biến hệ thống để mô phỏng các tình huống thực tế.