SaaSコネクタの書き込みをゲートする
接続されたSaaSソースに対してエージェントが操作してよいかをプレーンに尋ね、何かが送信される前に判定を読み取ります。
saas.admit
接続されたSaaSソースに対してエージェントが操作してよいかをプレーンに尋ね、何かが送信される前に判定を読み取ります。
saas.admitエージェントがGitHubやチケットシステムなどのSaaSツールで作業しているとき、各操作を先に許可したい場合です。受け入れルートは判定を返し、SaaSには何も送信しません。
コードはキーをINTRAMEDIAL_KEYから読み取ります。キーはシェルやシークレットストアに保管し、コミットするファイルには入れないでください。サインインした人が必要な呼び出しにはキーを使えず、コンソールが実行します。
source、エージェント、actionを送ります。actionの既定はreadです。
write呼び出しだけです。saas.admitsaas-admitcurl -sS -X POST https://api.intramedial.com/api/v1/acp/saas/admit \
-H "Authorization: Bearer $INTRAMEDIAL_KEY" \
-H "Content-Type: application/json" \
-d '{
"source": "github",
"actorDid": "did:web:acme.example:agent:support",
"action": "write"
}'const res = await fetch("https://api.intramedial.com/api/v1/acp/saas/admit", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
source: "github",
actorDid: "did:web:acme.example:agent:support",
action: "write",
}),
});
console.log(res.status, await res.json());import os, requests
res = requests.post(
"https://api.intramedial.com/api/v1/acp/saas/admit",
headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
json={
"source": "github",
"actorDid": "did:web:acme.example:agent:support",
"action": "write",
},
timeout=30,
)
print(res.status_code, res.json())result.allowとresult.reasonは、経路上にモデルを置かない、Intralockの回答です。確認が必要な書き込みでは、結果にapprovalIdが追加されます。
{
"result": { "allow": false, "reason": "no_grant" },
"llm": false
}管理者は、ソースに書き込みマップを設定できます。そうするとwriteルートが許可、転送、記録を行います。マップがない場合は404を返します。
転載元の資料: /docs/saas-admit
台帳は追記専用で、Merkleルートのもとでシールされます。エントリの時刻はIntramedial自身のクロックによるもので、署名付きバンドルは公開鍵を使ってオフラインで確認できます。
エージェントのツール呼び出しに対するIntralockの判定をMCPゲートウェイに尋ね、理由を読み取り、確認された呼び出し元を一覧します。
mcp.enforceエージェントによるリポジトリへの書き込みをIntralock経由で許可し、判定をチェック実行またはステータスとしてコミットに投稿します。
github.enforce拒否された書き込みを承認キューで待機させ、サインインした人が承認したら、トークンを付けて再試行します。
coordination.approveレシピ集にレシピを追加したときだけ、短いメールを1通。ほかのメールは送らず、どのメールからも配信停止できます。
アカウントは不要です。attestルートで7日間に35回まで呼び出せ、レシートはテストレシートとして明示されます。続けたくなったら、そのときに登録してください。