Prendi un lease e rilascialo

Intramedial è in beta ristretta. Alla registrazione o all’accesso devi fornire la password da beta tester che hai ricevuto oppure richiederne una a preview@intramedial.com. Grazie.

Caricamento…

Caso d'uso

Il compito

Due agenti non devono fare il deploy in produzione contemporaneamente. Si assegna un lease alla risorsa: il primo agente lo detiene, il secondo viene rifiutato e informato di chi lo detiene e di quanto attendere. Un lease mai rilasciato scade da sé.

Prerequisiti

Prima di iniziare

Piano: Ogni piano, Free incluso
Credenziale: Chiave API workspace
Ti serve anche: Un unico nome di risorsa usato da tutti gli agenti

Il codice legge la chiave da INTRAMEDIAL_KEY. Tienila nella shell o nel tuo secret store, mai in un file di cui fai commit. Le chiamate che richiedono una persona autenticata non possono usare una chiave: le effettua la console.

Passo passo

Passi

Prendi un lease
Richiedi la risorsa come l'agente che la vuole. Una risorsa libera restituisce un lease con una scadenza.

Esempio output

Cosa ritorna

Una risorsa libera risponde { ok: true, lease }. Il lease riporta id, detentore e scadenza.

JSON

200 OK

{
  "ok": true,
  "lease": {
    "id": "lease_4c1e",
    "resource": "lock:deploy/production",
    "holder": "did:web:acme.example:agent:release",
    "expiresAtMs": ,
    : { : , : [] },
    : ,
    : {}
  }
}

Prove

Cosa prova la ricevuta

Dimostra

Il piano ha dato a questo agente un lease su questa risorsa.
Finché non è scaduto o è stato rilasciato, le altre richieste per la risorsa sono state rifiutate con lease_held.

Non lo dimostra

Continua

Prosegui

Pagine tool

coordination.leasecoordination-lease

Documentazione

curl -sS -X POST https://api.intramedial.com/api/v1/acp/coordination/lease \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "resource": "lock:deploy/production",
  "actorDid": "did:web:acme.example:agent:release"
}'

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

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/coordination/lease",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "resource": "lock:deploy/production",
        "actorDid": "did:web:acme.example:agent:release",
    },
    timeout=30,
)
print(res.status_code, res.json())

Richiedi mentre è detenuta

Un secondo agente che richiede la stessa risorsa viene rifiutato con lease_held, il DID del detentore e un back-off in stampede.waitMs. Ogni lease dura 30.000 ms di default; la route non legge ttlMs.

curl -sS -X POST https://api.intramedial.com/api/v1/acp/coordination/lease \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "resource": "lock:deploy/production",
  "actorDid": "did:web:acme.example:agent:cost"
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/coordination/lease", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    resource: "lock:deploy/production",
    actorDid: "did:web:acme.example:agent:cost",
  }),
});
const body = await res.json();
if (!body.ok) console.log(body.reason, "held by", body.holder, "wait", body.stampede?.waitMs, "ms");

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/coordination/lease",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "resource": "lock:deploy/production",
        "actorDid": "did:web:acme.example:agent:cost",
    },
    timeout=30,
)
body = res.json()
if not body.get("ok"):
    print(body["reason"], "held by", body["holder"], "wait", body["stampede"]["waitMs"], "ms")

Rilasciarlo in anticipo

Invia la risorsa e l'agente; release risponde released e releasedIds. Un lease mai rilasciato scade e un allarme lo riprende.

curl -sS -X POST https://api.intramedial.com/api/v1/acp/coordination/release \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "resource": "lock:deploy/production",
  "actorDid": "did:web:acme.example:agent:release"
}'

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

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/coordination/release",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "resource": "lock:deploy/production",
        "actorDid": "did:web:acme.example:agent:release",
    },
    timeout=30,
)
print(res.status_code, res.json())

Gli agenti agiscono quando il piano dice sì, e il registro dice perché.

Il compito

Prima di iniziare

Passi

Prendi un lease

Cosa ritorna

Cosa prova la ricevuta

Dimostra

Non lo dimostra

Prosegui

Pagine tool

Documentazione

Nota sui marchi

Regione

Scegli la tua lingua

Richiedi mentre è detenuta

Rilasciarlo in anticipo

Ricette correlate

Mettersi in coda per lo slot di deploy in produzione

Presenta una rivendicazione su una risorsa

Intermedia un ruolo cloud di breve durata

Nuove ricette via email

Prova con la chiave test gratis.

Prendi un lease e rilascialo

Gli agenti agiscono quando il piano dice sì, e il registro dice perché.

Il compito

Prima di iniziare

Passi

Prendi un lease

Cosa ritorna

Cosa prova la ricevuta

✓Dimostra

×Non lo dimostra

Prosegui

Pagine tool

Documentazione

Richiedi mentre è detenuta

Rilasciarlo in anticipo

Ricette correlate

Mettersi in coda per lo slot di deploy in produzione

Presenta una rivendicazione su una risorsa

Intermedia un ruolo cloud di breve durata

Nuove ricette via email

Prova con la chiave test gratis.

Dimostra

Non lo dimostra