import { ProofOfActor } from "@proofofactor/sdk";
const actor = await ProofOfActor.verify({
require: [
"human_presence",
"human_control",
"session_continuity"
]
});
if (actor.humanControl > 0.90) {
allow();
}
// For agents
const authority = await ProofOfActor.verifyAuthority({
agent,
action
});Conjunto de recursos propostos para a API
Cinco endpoints, uma atestação
Solicite o que seu contexto exige, examine as evidências e aplique sua política. O mesmo modelo abrange humanos, humanos com auxílio de AI e agentes.
Criar verificação
POST/v1/verifications
Declare o que a interação exige: presença humana, controle contínuo, declaração do uso de AI e nível de divulgação da identidade.
POST /v1/verifications
{
"requirements": {
"human_presence": true,
"continuous_control": true,
"ai_disclosure": true
}
}Consultar o status do ator
GET/v1/verifications/{verification_id}
Consulte o tipo de ator e o grau de confiança de cada afirmação. Sua política determina o que fazer com essas informações.
GET /v1/verifications/{verification_id}
{
"actor_type": "human",
"confidence": 0.97,
"human_presence": "verified",
"human_control": 0.94,
"ai_participation": "low",
"continuity": 0.99
}Solicitar manifestação explícita da intenção humana
POST/v1/intent
Para ações com consequências que exigem aprovação humana direta para esta ação, neste momento e sob estas condições.
Recuperar atestação
GET/v1/attestations/{id}
Retorna o Actor Trust Receipt em formato legível por máquina para auditoria e sistemas que consomem os dados.
Actor Policy
Declare seus requisitos de confiança
As aplicações devem poder declarar seus requisitos por meio de políticas. O princípio arquitetural central: o Proof of Actor fornece evidências de confiança. O cliente determina a política aceitável.
policy.require({
actor: "human",
presence: "continuous",
control: 0.90,
aiAssistance: "low"
});
policy.allow({
actor: ["human", "authorized_agent"],
agentAuthority: {
required: true
}
});Princípios de design para desenvolvedores
- A integração deve ser mais fácil do que construir uma infraestrutura interna de verificação.
- Todo resultado pode ser explicado: as declarações incluem evidências e um grau de confiança.
- Solicite apenas as declarações de que precisa; não colete nada além disso.
- Humanos e agentes são atores de primeira classe na mesma API.
- A autoridade do agente pode sempre ser revogada e é verificada a cada ação.
Preços
Os preços não são divulgados durante a fase de pesquisa. Não vamos defini-los antes de entender quais componentes de verificação geram mais valor. Um possível modelo futuro:
- Desenvolvedor
- Ambiente de testes gratuito
- Desenvolver
- Valor-base mensal + uso
- Escala
- Preços por uso
- Empresas
- Volume + política avançada + implantação privada
Perguntas frequentes
Perguntas de desenvolvedores
Posso integrar o Proof of Actor hoje?
Ainda não. O Proof of Actor está em desenvolvimento e ainda não há API nem SDK de produção. Os endpoints e as chamadas de SDK nesta página fazem parte da prévia para desenvolvedores do projeto proposto, publicada para que os desenvolvedores possam ajudar a defini-lo.
Haverá um SDK?
Um SDK faz parte da experiência proposta para desenvolvedores. Os nomes de pacotes e métodos mostrados aqui são ilustrativos e podem mudar antes de qualquer lançamento.
Como vai funcionar a precificação?
Os preços não são divulgados durante a fase de pesquisa. As possíveis unidades de cobrança incluem cada verificação, cada sessão contínua, cada atestado e cada verificação de autoridade, com um ambiente de testes gratuito para desenvolvedores. Nada está definido.
Como obtenho acesso?
Participe da Prévia para Desenvolvedores. Conte-nos o que você está tentando verificar e o volume aproximado de interações; usamos essas respostas para priorizar o desenvolvimento e o acesso antecipado.
Ajude a definir a API antes do lançamento.
Conte-nos o que você está tentando verificar e o volume de interações envolvido. Participantes do Developer Preview têm acesso ao projeto primeiro.