Chấp thuận thủ công

mã hóa bằng tay đợi ai đó xác nhận trước khi tiếp tục" như là một sửa đổi bước: khi thực hiện đạt một bước được cấu hình với nó, nó dừng lại và chỉ chạy cơ thể bước sau khi chấp thuận. Cho đến lúc đó, hệ thống không thực hiện hành động cho bước đó hay bất cứ điều gì ngược dòng.

Cấu hình

  - step: apply_changes
    agent: executor
    input: "把已审核的变更应用到线上"
    manual_approval:
      enabled: true
      approvers:            # 平台用户 ID；留空 = 发起人 / 有执行权限者可批
        - "usr_team_lead"
      timeout: 86400        # 秒；24 小时无人批复自动拒绝
      approval_message: |
        请确认是否应用本轮变更。
        拒绝或超时不会做任何线上修改。

Nó có thể gắn vào bất cứ bước nào ( Agent, mã, tiểu công việc, v.v.), và thường được dùng trên một bước mã nhẹ mà chỉ cần in dấu trạng thái, hoạt động như một "cửa con người."

Tham số

Tên

1. Khi thực hiện đạt một bước được cấu hình bằng thủ công, nó dừng lại và trạng thái thực hiện trở thành aWAIT APPROVAL
2. Một hồ sơ chấp thuận được tạo ra và đồng hồ hẹn giờ bắt đầu; các giao diện nhận được sự chấp thuận thời gian thực trên WebSocket, và người xem cũng có thể nhận được email thông báo
3. Người phê duyệt quyết định thông qua một trong ba kênh: danh sách chấp thuận nhập vào, một liên kết một nhấn chuột trong một thông điệp, hoặc hệ thống ARI
4. Approve bước tiếp tục; từ chối vội vàng các bước được xử lý như bị thất bại (bạn có thể gửi một chi nhánh thông báo với failure); thời hạn tự động bỏ ra

Kênh 1: danh sách chấp thuận nhập vào

Bàn điều khiểnChấp nhậnnơi Mạng Bạn có thể dán giấy khi tán thành hoặc từ chối, và ghi chú vào hồ sơ. Các ứng dụng được cấu hình bằng các hành động duyệt được mở rộng ra một bảng có thể chọn được.

Kênh 2: Thông báo email và liên kết một nhấn chuột

Với thông báo email trên, người phê bình (người bắt đầu thực hiện khi người chấp thuận không được xác định) nhận một email tại địa chỉ tài khoản chứa: dòng và tên bước, số hành động có thể xem xét, một thông báo thời hạn ("auto-recovered trong khoảng N giờ"), sự chấp thuận văn bản phát âm và một liên kết đến danh sách chấp thuận.

Trong những tin nhắn không thể đặt tiêu đề tự chọn, như email, Slack, và Telegram, bạn cũng có thể nhúng một liên kết quyết định một lần:

GET https://braidrun.com/api/webhook-trigger/approval/{approvalId}/approve?api_key=dyk_...
GET https://braidrun.com/api/webhook-trigger/approval/{approvalId}/reject?api_key=dyk_...

Liên kết này được xác thực bằng một tham số truy vấn hệ điều hành. Để ngăn chặn sự cố gây ra bởi robot xem liên kết (Slack unfurls, email- khách hàng trước khi phát âm), việc mở đầu tiên chỉ thực hiện một trang xác nhận và không thực hiện hành động; quyết định chỉ được thực hiện khi bạn nhấn nút xác nhận và yêu cầu lặp lại với xác nhận = 1. Trang này không có lỗ hổng và không có đầu mối để ngăn chặn đau nhức hoặc quay lại hệ thống tìm kiếm.

Kênh 3

Open API v1 cung cấp 5 endpoint phê duyệt, tất cả đều yêu cầu scope APPROVAL_RESPOND:

# 批准（可附备注）
curl -X POST https://braidrun.com/api/v1/approvals/<approval-id>/approve \
  -H "Authorization: Bearer dyk_..." \
  -H "Content-Type: application/json" \
  -d '{"comment": "确认执行"}'

# 拒绝
curl -X POST https://braidrun.com/api/v1/approvals/<approval-id>/reject \
  -H "Authorization: Bearer dyk_..." \
  -H "Content-Type: application/json" \
  -d '{"comment": "本轮预算已用完"}'

soạn thảo Items đệ trình tập tin con đã chọn theo tên nhóm, khớp với cấu trúc của mẫu được sửa chữa trong phần kế tiếp; loại bỏ nó chấp nhận mọi thứ.

Stencils

Một số sự tán thành là sự phân phối: trong một loạt các đề nghị bạn chỉ thực hiện một số, và một vài hàng thậm chí cần thay đổi giá trị. Xem lại các hành động có thể biến những sự chấp thuận này thành bảng — người xem xét kiểm tra hàng cần chạy, sửa đổi cột có ghi: có thể sửa đổi trực tiếp (v. d. việc thay đổi giá thầu) và rồi nhấn vào phê chuẩn.

    manual_approval:
      enabled: true
      timeout: 86400
      approval_message: |
        请审核本轮调价建议：可勾选要执行的行，并直接修改建议出价。
      reviewable_actions:
        - name: raise_bid
          title: 加价建议
          source_var: raise_bid_file           # 变量值 = 建议清单 JSON 数组文件路径
          output_var: raise_bid_approved_file  # 批准后 = 勾选/编辑后的子集文件路径
          key_field: item_id
          columns:
            - { key: item_name, label: 名称, editable: false }
            - { key: current_bid, label: 当前出价, type: number, editable: false }
            - { key: proposed_bid, label: 建议出价, type: number, editable: true }
            - { key: reason, label: 理由, editable: false }

• name — Tên nội bộ của nhóm, cũng được sử dụng như tiền tố tập tin xuất (sau khi chấp thuận máy ghi đánh giá < name>.json)
• source_var — Điểm tới một biến có giá trị là danh sách giới thiệu được tạo ra bởi một bước lên dòng (con đường dẫn đến tập tin danh sách JSON)
• output_var — Một biến số được đặt sau khi chấp thuận, giá trị của nó là đường dẫn tới tập tin con đã chọn; có bước thực hiện xuôi dòng đọc nó thay vào đó, và nó sẽ chỉ xử lý hàng được chấp nhận
• key_field — Trường Định dạng Hàng, được dùng để canh lề hàng sau khi sửa; nếu vắng mặt, hàng được sắp xếp theo chỉ mục dãy
• columns — Định nghĩa cột của bảng; cột với khả năng sửa đổi: đúng có thể được thay đổi bởi người đánh giá, và gõ: số chuyển thành đầu vào số

Từ Chối và thời hạn: 0 thay đổi

Lời hứa cốt lõi của cổng chấp thuận là hệ thống không hành động trước khi được chấp thuận. Khi bị từ chối hoặc bị hạn chế —

• Cơ thể bước không chạy, và các bước xuôi dòng phụ thuộc vào nó không được kích hoạt
• Bạn có thể sử dụng một chi nhánh để đính kèm một thông báo "vỗ tay từ chối" hoặc bước cơ bản
• Thời hạn được hệ thống phân loại tự động, với quyết định được ghi lại như hệ thống; mỗi quyết định chấp thuận (bao gồm quyết định, thời gian, và ghi chú) được viết vào bản ghi kiểm tra

Các trang liên quan

• Đã cập nhật
• tham khảo v1 API
• Tự động tiếp tục sau khi dịch vụ khởi động lại