XÁC ĐỊNH TÁC NHÂN AI

Xác định tác nhân AI cho APIs

API của bạn đã biết khóa nào đã gửi yêu cầu. Proof of Actor cho bạn biết phía sau đó là loại tác nhân nào, bằng chứng nào hỗ trợ kết luận đó, và để code của bạn quyết định điều gì xảy ra tiếp theo.

Nhận quyền truy cập sớm Khám phá cách hoạt động

Bởi Toshendra SharmaNhà sáng lập và CEO, AgentCredia · Updated November 13, 2026

API của bạn biết khóa. Nó không biết tác nhân.

Mỗi yêu cầu API đều đi kèm một số bằng chứng về bên trả phí cho nó: một API key, một OAuth token, một session. Bằng chứng đó trả lời tốt một câu hỏi. Nó cho bạn biết tài khoản nào chịu trách nhiệm cho lần gọi đó. Nó không cho bạn biết chính xác điều gì đang thực sự thực hiện lần gọi ngay lúc này.

Một API key duy nhất có thể được dùng bởi một developer đang thử trong terminal, bởi một backend job chạy theo lịch, bởi một người đang làm việc qua một AI assistant, và bởi một autonomous agent được trao khóa rồi được yêu cầu hoàn thành một nhiệm vụ. Đó là những tác nhân rất khác nhau. Chúng có nhịp độ khác nhau, chế độ lỗi khác nhau và hồ sơ rủi ro khác nhau. Nếu đối xử tất cả như nhau, bạn либо siết quá mức tự động hóa hợp lệ mà khách hàng của bạn phụ thuộc vào, hoặc bảo vệ không đủ những phần của API lẽ ra không bao giờ nên do một agent không có người giám sát điều khiển.

Xác định tác nhân AI cho APIs khép lại khoảng cách đó. Thay vì suy luận mọi thứ từ khóa, bạn nhận được một phân loại của tác nhân đứng sau mỗi yêu cầu, cùng với bằng chứng hỗ trợ kết luận đó. Đó là điều Proof of Actor được xây dựng để cung cấp, và use case APIs cho thấy các nhóm API áp dụng nó theo từng route như thế nào.

Vì sao các nhóm API cần ngữ cảnh tác nhân ngay bây giờ

Lưu lượng tự động đến APIs không phải điều mới. Script, tích hợp và crawler từ lâu đã là một phần của bức tranh. Điều đã thay đổi là kiểu tự động hóa. Các AI agent có thể đọc tài liệu, nối nhiều lệnh gọi lại với nhau, thử lại một cách linh hoạt và hành động thay mặt cho những người không theo dõi từng bước. Nhiều agent trong số đó hữu ích và được chào đón. Một số được xây dựng kém. Một số ít mang tính thù địch.

Nếu không có ngữ cảnh tác nhân, các nhóm API thường phải dựa vào công cụ thô:

Giới hạn tốc độ theo key, khiến agent tốt và agent xấu bị làm chậm như nhau.
Quy tắc user-agent, vốn sẽ hỏng ngay khi client đổi header.
Chặn trên diện rộng, đẩy tự động hóa hợp lệ sang việc scrape web app của bạn thay vào đó.

Ngữ cảnh tác nhân cho phép bạn phản hồi chính xác. Một agent đã ký từ một operator mà bạn nhận ra có thể được cấp giới hạn cao hơn trên các route chỉ đọc. Một bên gọi không xác định chạm vào một route ghi có thể được yêu cầu cung cấp credential mạnh hơn. Một người đang dùng AI assistant vẫn có thể giữ trải nghiệm bình thường. Mục tiêu không phải là chặn agent. Mục tiêu là đưa từng loại bên gọi đi theo đúng đường. Về những gì một request đã ký có thể và không thể cho bạn biết, hãy đọc những gì request tác nhân AI đã ký chứng minh.

Xác định tác nhân AI hoạt động như thế nào trong Proof of Actor

Proof of Actor đi theo cùng một luồng ưu tiên bằng chứng cho mọi yêu cầu. Bạn có thể đọc toàn bộ quy trình trong How It Works; dưới đây là phiên bản ngắn cho các nhóm API.

1. Tín hiệu từ tích hợp của bạn

Tích hợp của bạn truyền cho Proof of Actor các tín hiệu có sẵn trong ngữ cảnh đó. Với API, điều đó thường có nghĩa là ngữ cảnh yêu cầu như headers và chi tiết giao thức, mọi request signature mật mã mà client cung cấp, và mọi khai báo mà client đưa ra về chính nó. Mỗi tín hiệu đều được gắn nhãn với nguồn gốc của nó.

2. Phân loại kèm cơ sở

Các tín hiệu được kiểm tra và kết hợp thành một trong bốn lớp công khai:

Human: các tín hiệu quan sát được cho thấy một tương tác do con người dẫn dắt.
Human + AI: việc hỗ trợ của AI đã được khai báo hoặc được phát hiện bởi một tích hợp có thể quan sát điều đó.
Agent: lưu lượng tự động hoặc có nguồn gốc từ agent, được hỗ trợ bởi danh tính có thể xác minh hoặc một suy luận được điều kiện hóa cẩn thận.
Unknown: bằng chứng không đủ để đưa ra kết luận đáng tin cậy.

Mỗi kết quả cũng mang theo basis của nó: verified, declared, inferred hoặc unknown. Đây là phần mà các nhóm API đánh giá cao nhất. Một yêu cầu có HTTP message signature, như được định nghĩa trong RFC 9421, xác thực với một public key đã công bố sẽ được báo là verified. Một client chỉ tự xưng là agent sẽ được báo là declared. Một mẫu hành vi có vẻ tự động sẽ được báo là inferred. Bạn không bao giờ phải băn khoăn liệu một kết quả dựa trên mật mã hay trên heuristic. Evidence basis là một phần của câu trả lời.

3. Một kết quả mà code của bạn có thể hành động theo

Kết quả được trả về cho ứng dụng của bạn cùng với lớp, basis và bản tóm tắt bằng chứng dễ đọc. Code của bạn quyết định sẽ làm gì với nó. Ở chế độ quan sát, bạn chỉ ghi lại nó. Khi sẵn sàng, bạn route dựa trên nó.

Nhóm của bạn nhận được gì: Detect, Understand, Route

Proof of Actor là một sản phẩm với ba khả năng.

Detect

Thu thập các tín hiệu tác nhân mà API của bạn có thể nhìn thấy và tách các khẳng định đã xác minh khỏi các suy luận hành vi. Các request tác nhân đã ký, client khai báo, tín hiệu tự động hóa và kết quả Unknown đều được giữ tách biệt, để không có gì bị gộp âm thầm thành một điểm số duy nhất.

Understand

Xem tác nhân nào gọi những route nào, điều đó thay đổi thế nào theo thời gian, và bằng chứng nào nằm phía sau từng phân loại. Tỷ lệ Unknown vẫn hiển thị, cho bạn biết chính xác nơi phạm vi quan sát của bạn kết thúc và nơi một tín hiệu mạnh hơn sẽ hữu ích.

Route

Viết chính sách theo từng route và từng mức rủi ro: allow, adapt, challenge, review hoặc rate-limit. Giữ một đường đi có cấu trúc và rộng rãi cho các agent đã xác minh trên các endpoint chỉ đọc. Yêu cầu credential mạnh hơn với các thao tác có tác động lớn. Xác định một phương án dự phòng rõ ràng cho Unknown và cho timeout, để API của bạn hành xử có thể dự đoán được dù điều gì xảy ra. Bạn quyết định mỗi chính sách sẽ fail như thế nào, open hay closed, dựa trên chi phí của một sai lầm ở route đó.

Bằng chứng danh tính, credential và ủy quyền là ba thứ khác nhau

Sai lầm phổ biến nhất trong thiết kế API có nhận biết agent là gộp ba câu hỏi riêng biệt thành một. Proof of Actor giữ chúng tách ra, và thiết kế của bạn cũng nên như vậy.

Identity evidence: loại tác nhân nào đang gọi, và điều gì chứng minh điều đó? Đây là thứ mà xác định tác nhân AI cung cấp. Một chữ ký đã xác minh gắn một yêu cầu với một key và operator identifier đã công bố của nó. Nhóm làm việc IETF Web Bot Auth được giao nhiệm vụ chuẩn hóa loại xác thực mật mã này cho các client tự động, và phạm vi của họ bao gồm việc xác thực agent chứ không phải end user.
Credentials: tài khoản nào chịu trách nhiệm cho lần gọi này? Đây là API key, token hoặc session của bạn, do bạn cấp và quản lý.
Authorization: bên gọi này có được phép làm việc cụ thể này không? Đây là mô hình quyền của bạn.

Một agent đã xác minh không tự động là một agent được ủy quyền. Một chữ ký hợp lệ không chứng minh rằng một người đã ủy quyền cho agent, và nó cũng không làm cho hành động được yêu cầu trở nên an toàn. Proof of Actor cho bạn ngữ cảnh đáng tin cậy cho câu hỏi đầu tiên và giữ câu hỏi thứ hai và thứ ba đúng ở nơi chúng thuộc về: trong ứng dụng của bạn. Đọc thêm về ủy quyền agent và về những gì bằng chứng có thể và không thể thiết lập tại Detection & Limitations.

Unknown là một tính năng, không phải thất bại

Việc ký request là tùy chọn, và một client không ký có thể tự mô tả theo bất kỳ cách nào nó muốn. Một hệ thống bắt mọi yêu cầu phải là Human hoặc Agent sẽ có lúc tự tin nhưng sai, và bạn sẽ không biết khi nào.

Proof of Actor báo Unknown khi bằng chứng không đủ để đưa ra kết luận. Unknown không bao giờ bị chuyển thành Human và không bao giờ mặc định bị xem là độc hại. Chính sách của bạn định nghĩa Unknown có nghĩa là gì cho từng route: cho phép trên các lượt đọc công khai, giữ nguyên các kiểm tra hiện có trên thay đổi tài khoản, xếp hàng để review ở nơi rủi ro cao. Giữ Unknown hiển thị chính là điều làm cho các phân loại khác của bạn trở nên đáng tin cậy. Hướng dẫn về xử lý lưu lượng Unknown cho thấy cách thiết kế cho điều đó.

Xác định tác nhân AI phù hợp ở đâu trong stack của bạn

Proof of Actor nằm cạnh gateway, xác thực và rate limiting hiện có của bạn. Nó không thay thế bất kỳ thứ nào trong số đó. Các vị trí điển hình bao gồm:

Server-side middleware trước các route handler của bạn, để mọi yêu cầu được đánh giá trước khi business logic chạy.
Ở edge, để các tín hiệu được đánh giá trước khi request đến origin của bạn.
Một tích hợp HTTP chung, để bất kỳ stack nào cũng có thể gửi ngữ cảnh request và nhận kết quả cùng basis của nó.

Các tích hợp được triển khai trực tiếp cùng từng nhóm sáng lập trong quá trình onboarding, để đường đi phù hợp với kiến trúc của bạn chứ không phải ngược lại. Developer hub cho thấy các đường tích hợp hiện có hôm nay. Nếu bạn vận hành công cụ cho agent, use case MCP Servers bao gồm các mẫu cụ thể cho tool call.

Bắt đầu ở chế độ quan sát

Cài đặt Proof of Actor không làm thay đổi cách API của bạn phản hồi. Các kết quả được ghi lại để nhóm của bạn có thể so sánh chúng với những kết quả bạn đã biết, xem các agent thực sự đi đâu, đo tỷ lệ Unknown trên từng route, và xem xét bất kỳ phân loại nào có vẻ sai. Chỉ sau đó bạn mới bật một chính sách, theo từng route, nơi bằng chứng hỗ trợ điều đó.

Đó là cách bạn triển khai xác định tác nhân AI mà không làm khách hàng bất ngờ hoặc phá vỡ các tích hợp mà họ phụ thuộc vào. Hướng dẫn về triển khai chính sách có nhận biết tác nhân một cách an toàn sẽ dẫn qua chuỗi bước từng bước.

Tham gia chương trình founding developer

Proof of Actor đang ở private beta với một nhóm nhỏ các đội phát triển sáng lập. Các nhóm được chọn có thể nhận tối đa 12 tháng truy cập miễn phí, trong phạm vi mức sử dụng đã thỏa thuận trong quá trình onboarding, cùng với hỗ trợ tích hợp trực tiếp từ các kỹ sư của chúng tôi và ảnh hưởng thực sự đến những gì chúng tôi xây dựng tiếp theo.

Nếu bạn vận hành một API và muốn biết ai thực sự đang gọi nó, hãy đăng ký quyền truy cập sớm. Hãy cho chúng tôi biết về API của bạn, những route bạn quan tâm nhất, và những quyết định bạn sẽ đưa ra khác đi khi có ngữ cảnh tác nhân. Chúng tôi sẽ cho bạn biết Proof of Actor phù hợp như thế nào.

Nguồn

RFC 9421: HTTP Message Signatures, IETF, February 2024.
Web Bot Auth (webbotauth) working group charter, IETF.

DÀNH CHO NHÀ PHÁT TRIỂN

What your code receives

Every interaction resolves to one result record. Your application reads the class and the basis and applies its own policy.

Result record

{
  "route": "GET /api/v1/catalog",
  "class": "agent",
  "basis": "verified",
  "evidence": [
    { "signal": "http_message_signature", "result": "valid", "keyid": "assistant.example" },
    { "signal": "client_declaration", "value": "assistant.example" }
  ],
  "observed_at": "2026-11-13T10:42:07Z"
}

class: Human, Human + AI, Agent hoặc Unknown.
basis: Bằng chứng mạnh đến mức nào: verified, declared, inferred hoặc unknown.
evidence: Các tín hiệu phía sau kết quả, để team của bạn thấy được lý do.

Bắt đầu ở chế độ quan sát: ghi kết quả cạnh logs của bạn và không thay đổi gì cho đến khi bạn chọn một chính sách. Đọc hướng dẫn tích hợp Node.js

Câu hỏi thường gặp

Xác định tác nhân AI khác gì so với xác thực API key?

Một API key cho bạn biết tài khoản nào đã gửi yêu cầu. Xác định tác nhân AI cho bạn biết loại tác nhân nào đứng sau yêu cầu và bằng chứng nào hỗ trợ kết luận đó. Bạn cần cả hai, vì chúng trả lời những câu hỏi khác nhau.

Proof of Actor có thể xác định mọi tác nhân AI gọi API của tôi không?

Proof of Actor phân loại mọi yêu cầu mà nó thấy thành Human, Human + AI, Agent hoặc Unknown, và nêu rõ cơ sở cho từng kết quả. Khi bằng chứng chưa đủ mạnh, kết quả là Unknown thay vì phán đoán.

Việc xác định một tác nhân có nghĩa là nó được phép hành động không?

Không. Xác định và ủy quyền là hai việc riêng biệt. Proof of Actor cung cấp cho ứng dụng của bạn ngữ cảnh về bên gọi, còn các quy tắc ủy quyền của chính bạn quyết định bên gọi đó được làm gì.

Proof of Actor có chặn yêu cầu đến API của tôi không?

Không, trừ khi bạn quyết định như vậy. Mọi tích hợp đều bắt đầu ở chế độ quan sát, và việc thực thi chỉ diễn ra thông qua các chính sách do nhóm của bạn viết và bật lên.

Làm thế nào để tôi có quyền truy cập?

Proof of Actor đang ở private beta. Hãy đăng ký quyền truy cập sớm và các nhóm phát triển sáng lập được chọn có thể nhận tối đa 12 tháng miễn phí trong phạm vi mức sử dụng đã thỏa thuận.

Biết ai đang dùng app của bạn.

Private beta dành cho một nhóm nhỏ các nhà phát triển sáng lập.

Nhận quyền truy cập sớm Xem giá

Bạn muốn trao đổi trước? Trao đổi với những người sáng lập