Exigir aprovação humana para uma gravação

O Intramedial está em beta restrito. Ao se cadastrar ou entrar, você precisa informar a senha de beta tester que recebeu ou solicitar uma em preview@intramedial.com. Obrigado.

Carregando…

Caso de uso

A tarefa

Algumas gravações não devem passar só porque um agente disse. A admissão recusa uma gravação sem token e deixa uma solicitação; um administrador ou aprovador autorizado a decide, e aprovar emite um token para esse ator, recurso e verbo.

Pré-requisitos

Antes de começar

Plano: Qualquer plano, até o Free
Credencial: Chave API do workspace
Um token de acesso pessoal, com o header do workspace
Também precisa: Um administrador ou aprovador logado
Uma segunda pessoa: ninguém decide a própria solicitação

O código lê a chave de INTRAMEDIAL_KEY. Guarde-a no seu shell ou no seu cofre de segredos, nunca em um arquivo que você faz commit. Chamadas que exigem uma pessoa logada não podem usar chave: o console as faz.

Passo a passo

Passos

Declarar uma gravação, sem token
Declare uma gravação sem token. A admissão a recusa, e o approvalId na resposta nomeia a solicitação que espera na fila para uma pessoa decidir.

Saída de exemplo

O que é devolvido

A decisão volta como approval, com seu estado.

JSON

200 OK

{
  "approval": {
    "id": "apr_7f3a",
    "actorDid": "did:web:acme.example:agent:billing",
    "resource": "repo:payments/main",
    "action": ,
    : ,
    : ,
    : ,
    : ,
    : ,
    : ,
    : ,
    : ,
    : 
  },
  : 
}

Evidências

O que o recibo prova

Ele prova

Uma pessoa logada aprovou esta solicitação para este ator e recurso.
O token está vinculado a esse intent exato.

Ele não prova isto

Continue

A seguir

Ver as tools

coordination.approvecoordination-approve

Documentação

curl -sS -X POST https://api.intramedial.com/api/v1/acp/coordination/admit \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "actorDid": "did:web:acme.example:agent:billing",
  "resource": "repo:payments/main",
  "action": "write"
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/coordination/admit", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    actorDid: "did:web:acme.example:agent:billing",
    resource: "repo:payments/main",
    action: "write",
  }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/coordination/admit",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "actorDid": "did:web:acme.example:agent:billing",
        "resource": "repo:payments/main",
        "action": "write",
    },
    timeout=30,
)
print(res.status_code, res.json())

Aprovar a gravação

Um aprovador logado lê a solicitação no console e a aprova. Uma chave ou um agente não pode decidir; este é o corpo que o console envia.

JSON

POST /api/v1/acp/coordination/approve

{
  "id": "apr_7f3a",
  "reason": "expected batch"
}

Tentar de novo com o token

O agente tenta de novo com o token como confirmationToken. É de uso único e vinculado ao ator, recurso e verbo.

curl -sS -X POST https://api.intramedial.com/api/v1/acp/coordination/admit \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "actorDid": "did:web:acme.example:agent:billing",
  "resource": "repo:payments/main",
  "action": "write",
  "confirmationToken": "…"
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/coordination/admit", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    actorDid: "did:web:acme.example:agent:billing",
    resource: "repo:payments/main",
    action: "write",
    confirmationToken: "…",
  }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/coordination/admit",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "actorDid": "did:web:acme.example:agent:billing",
        "resource": "repo:payments/main",
        "action": "write",
        "confirmationToken": "…",
    },
    timeout=30,
)
print(res.status_code, res.json())

Os agentes agem quando o plano diz sim, e o registo diz porquê.

A tarefa

Antes de começar

Passos

Declarar uma gravação, sem token

O que é devolvido

O que o recibo prova

Ele prova

Ele não prova isto

A seguir

Ver as tools

Documentação

Aviso de marcas registradas

Região

Escolha seu idioma

Aprovar a gravação

Tentar de novo com o token

Receitas ligadas

Exigir duas pessoas para uma ação

Emita seu primeiro recibo.

Controlar uma gravação de agente no GitHub

Receitas por e-mail

Experimente com a chave grátis.

Exigir aprovação humana para uma gravação

Os agentes agem quando o plano diz sim, e o registo diz porquê.

A tarefa

Antes de começar

Passos

Declarar uma gravação, sem token

O que é devolvido

O que o recibo prova

✓Ele prova

×Ele não prova isto

A seguir

Ver as tools

Documentação

Aprovar a gravação

Tentar de novo com o token

Receitas ligadas

Exigir duas pessoas para uma ação

Emita seu primeiro recibo.

Controlar uma gravação de agente no GitHub

Receitas por e-mail

Experimente com a chave grátis.

Ele prova

Ele não prova isto