NeboAI
NeboAI
Bắt đầu

Quy trình

Quy trình làm việc là việc nhân viên làm mà không cần được yêu cầu: bản tóm tắt buổi sáng, trả lời từng tin nhắn mới, báo cáo hằng tuần. Mỗi quy trình kết hợp một trình kích hoạt với các hoạt động mà nhân viên thực hiện. Quy trình làm việc nằm trong agent.json của nhân viên, nên chúng đi cùng vai trò.

Quy trình làm việc đầu tiên

Thêm một ánh xạ workflows vào agent.json. Mỗi khóa là tên một quy trình; mỗi giá trị có một trình kích hoạt và các hoạt động.

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

Quy trình này chạy lúc 08:00 vào các ngày trong tuần, theo giờ địa phương của bot. Nhân viên thực hiện hoạt động bằng chính tính cách, kỹ năng và kết nối của mình.

Các trường của quy trình làm việc

TrườngÝ nghĩa
triggerBắt buộc. Khi nào quy trình chạy. Xem phần Trình kích hoạt.
descriptionQuy trình dùng để làm gì.
activitiesCác bước. Xem phần Hoạt động.
connectionsCác cạnh {from, to, label} biến các hoạt động thành một đồ thị. __trigger__ là điểm bắt đầu và __emit__ là điểm kết thúc.
emitCác sự kiện mà quy trình này thông báo khi hoàn tất: một danh sách, hoặc một chuỗi phân tách bằng dấu phẩy. Xem phần Sự kiện.
inputsCác giá trị được truyền cho mọi lượt chạy.
budget{total_per_run, cost_estimate}. Trong lượt chạy dạng đồ thị, total_per_run giới hạn số token đầu ra; trong các trường hợp khác cả hai chỉ là ước tính.
caseBiến quy trình thành một hồ sơ việc kéo dài cho mỗi người hoặc mỗi đối tượng. Xem phần Hồ sơ việc.

Quy trình có trình kích hoạt mà không có hoạt động vẫn hợp lệ. Một watch không có hoạt động chỉ chuyển tiếp sự kiện của nó tới các quy trình khác.

Cách một lượt chạy được thực hiện

Nếu không có connections, các hoạt động chạy theo thứ tự và nhân viên thực hiện từng hoạt động. Kết quả của mỗi hoạt động được truyền sang hoạt động tiếp theo. Một hoạt động không có đầu ra sẽ kết thúc lượt chạy.

Khi có connections, các hoạt động tạo thành một đồ thị. Các nhánh chạy song song, và sáu loại hoạt động chạy mà không cần mô hình: condition, loop, wait, http, command và decide. Hãy dùng đồ thị khi việc định tuyến phải chính xác.

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

Một lượt chạy nhận được gì

Nhân viên luôn có tính cách của mình và câu trả lời của chủ sở hữu cho các câu hỏi inputs của nhân viên. Một lượt chạy cũng nhận các giá trị sau, tùy theo trình kích hoạt.

Đầu vàoCó mặt khi
_event_source, _event_payload, _event_originMột trình kích hoạt event được kích hoạt. Dữ liệu từ 8 KB trở lên được rút gọn chỉ còn các trường vô hướng, vẫn giữ tiêu đề email và tham chiếu tệp đính kèm.
_watch_payloadMột trình kích hoạt watch hoặc folder được kích hoạt. Một dòng đầu ra của trình theo dõi, hoặc {files} đối với thư mục.
inputsLuôn luôn. Các giá trị inputs riêng của quy trình.

Hồ sơ việc

Có những việc kéo dài nhiều ngày: một khách hàng tiềm năng cần theo dõi, một yêu cầu đang chờ tài liệu. Thêm case và quy trình sẽ giữ một hồ sơ việc đang mở cho mỗi người hoặc mỗi đối tượng thay vì bắt đầu lại từ đầu mỗi lần.

TrườngÝ nghĩa
keyBắt buộc. Các đường dẫn dạng dấu chấm, phân tách bằng dấu phẩy, trỏ vào dữ liệu của trình kích hoạt để xác định đối tượng, chẳng hạn contactEmail,email,phone.
typeLoại hồ sơ việc, chẳng hạn lead. Các quy trình cùng loại dùng chung hồ sơ việc. Mặc định là tên quy trình.
default_waitThời gian chờ khi một lượt không nêu thời gian chờ: 3d, 12h, 45m. Mặc định là ba ngày.

Mỗi lượt của một hồ sơ việc phải kết thúc bằng một đối tượng JSON và không có gì phía sau. result là trạng thái nghiệp vụ; next báo cho bộ máy wait hoặc close. Thời hạn theo định dạng RFC 3339 hoặc một khoảng thời gian tương đối. Bất cứ thứ gì khác đều là lượt không hợp lệ.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

Giới hạn và khôi phục

  • Mỗi hoạt động có thể dùng tối đa 50 lượt mô hình, trừ khi params.maxIterations quy định khác.
  • Trong một đồ thị, một hoạt động có thể chạy tối đa 10.000 lần trong một lượt chạy.
  • Hạn mức chi tiêu mà chủ sở hữu đặt cho nhân viên sẽ dừng lượt chạy khi đạt tới. token_budget của một hoạt động chỉ là ước tính.
  • Lượt chạy bị gián đoạn do khởi động lại sẽ được đánh dấu là bị gián đoạn và được tiếp tục một lần.
  • Nhân viên có thể kết thúc lượt chạy sớm bằng công cụ exit.

Chạy và quản lý quy trình làm việc

Chủ sở hữu có thể chạy thủ công bất kỳ quy trình nào. Nhân viên quản lý quy trình bằng run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled và các công cụ quy trình khác được liệt kê tại Trợ thủ và nhóm.