Sardis Identity - 代理身份与声誉

使用TAP（信任锚协议）为AI代理提供完整的身份生命周期管理。注册代理、验证凭证、建立声誉并颁发身份卡。

功能

• - 代理注册：通过TAP认证创建经过验证的代理身份
• 身份检索：获取代理凭证和验证状态
• 声誉追踪：提交和查询代理声誉评分
• 身份卡：生成可共享的代理身份卡
• TAP验证：Ed25519和ECDSA-P256加密验证

安全模型

身份关键：代理身份经过加密验证并与支付能力绑定。请谨慎处理。

快速设置

bash
export SARDISAPIKEY=skyourkey_here

API端点模式

基础URL：https://api.sardis.sh/v2

注册代理

bash

创建带有TAP验证的新代理身份

curl -X POST https://api.sardis.sh/v2/agents/identity/register \
-H Authorization: Bearer $SARDISAPIKEY \
-H Content-Type: application/json \
-d {
name: 客户支持机器人,
description: 处理客户咨询和退款,
public_key: 302a300506032b6570032100...,
key_type: ed25519,
capabilities: [payments, refunds, support],
metadata: {
version: 2.1.0,
provider: Anthropic,
model: claude-opus-4
}
}

示例响应：

{

agentid: agentabc123xyz,

name: 客户支持机器人,

public_key: 302a300506032b6570032100...,

tap_verified: true,

walletid: walletdef456,

created_at: 2026-02-21T10:00:00Z,

identitycardurl: https://sardis.sh/id/agent_abc123xyz,

status: active

}

获取代理身份

bash

检索完整的代理身份和验证状态

curl -X GET https://api.sardis.sh/v2/agents/identity/{agent_id} \
-H Authorization: Bearer $SARDISAPIKEY

示例：

curl -X GET https://api.sardis.sh/v2/agents/identity/agent_abc123xyz \ -H Authorization: Bearer $SARDISAPIKEY

提交声誉

bash

交互后提交声誉反馈

curl -X POST https://api.sardis.sh/v2/agents/identity/{agent_id}/reputation \
-H Authorization: Bearer $SARDISAPIKEY \
-H Content-Type: application/json \
-d {
agentid: agentabc123xyz,
score: 5,
category: payment_reliability,
comment: 快速准确地处理了退款,
transactionid: txrefund789
}

类别：

- payment_reliability：成功执行交易

- policy_compliance：遵守支出政策

- response_quality：代理响应质量

- security_awareness：安全最佳实践

- overall：整体表现

评分：1-5（5为最佳）

获取声誉评分

bash

查询代理的声誉指标

curl -X GET https://api.sardis.sh/v2/agents/identity/{agent_id}/reputation \
-H Authorization: Bearer $SARDISAPIKEY

示例：

curl -X GET https://api.sardis.sh/v2/agents/identity/agent_abc123xyz/reputation \ -H Authorization: Bearer $SARDISAPIKEY

获取代理卡

bash

生成可共享的身份卡

curl -X GET https://api.sardis.sh/v2/agents/identity/{agent_id}/card \
-H Authorization: Bearer $SARDISAPIKEY

返回包含代理信息、声誉和验证状态的JSON卡片

可渲染为HTML或在代理市场中显示

示例命令

完整代理入职

bash

1. 生成TAP密钥对（使用openssl示例）

openssl genpkey -algorithm ed25519 -out agent_key.pem
openssl pkey -in agentkey.pem -pubout -out agentpub.pem

提取公钥十六进制

PUBLICKEY=$(openssl pkey -pubin -in agentpub.pem -text | grep -A 10 pub: | tail -n +2 | tr -d :\n)

2. 注册代理

AGENT=$(curl -s -X POST https://api.sardis.sh/v2/agents/identity/register \ -H Authorization: Bearer $SARDISAPIKEY \ -H Content-Type: application/json \ -d { \name\: \我的支持代理\, \description\: \客户支持自动化\, \publickey\: \$PUBLICKEY\, \key_type\: \ed25519\, \capabilities\: [\payments\, \support\] })

AGENTID=$(echo $AGENT | jq -r .agentid)
echo 代理已注册：$AGENT_ID

3. 显示身份卡

curl -s -X GET https://api.sardis.sh/v2/agents/identity/$AGENT_ID/card \ -H Authorization: Bearer $SARDISAPIKEY | jq .

声誉仪表板

bash

检查所有类别的声誉

AGENTID=agentabc123xyz

echo === 代理声誉仪表板 ===
REP=$(curl -s -X GET https://api.sardis.sh/v2/agents/identity/$AGENT_ID/reputation \
-H Authorization: Bearer $SARDISAPIKEY)

echo $REP | jq -r 总体评分：\(.overall_score)/5
echo $REP | jq -r 总评分次数：\(.total_ratings)
echo $REP | jq -r 信任级别：\(.trust_level)

echo -e \n=== 类别细分 ===
echo $REP | jq -r .categories | to_entries[] | \(.key): \(.value.score)/5 (\(.value.count) 次评分)

交易后提交评分

bash

支付后对代理表现进行评分

AGENTID=agentabc123xyz
TXID=txpayment123

curl -X POST https://api.sardis.sh/v2/agents/identity/$AGENT_ID/reputation \
-H Authorization: Bearer $SARDISAPIKEY \
-H Content-Type: application/json \
-d {
\agentid\: \$AGENTID\,
\score\: 5,
\category\: \payment_reliability\,
\comment\: \交易成功完成\,
\transactionid\: \$TXID\
}

验证代理身份

bash

检查代理是否已正确验证

AGENTID=agentabc123xyz

IDENTITY=$(curl -s -X GET https://api.sardis.sh/v2/agents/identity/$AGENT_ID \
-H Authorization: Bearer $SARDISAPIKEY)

TAPVERIFIED=$(echo $IDENTITY | jq -r .tapverified)
STATUS=$(echo $IDENTITY | jq -r .status)

if [[ $TAP_VERIFIED == true && $STATUS == active ]]; then
echo ✓ 代理身份已验证且活跃
echo 公钥：$(echo $IDENTITY | jq -r .public_key | head -c 16)...
echo 钱包：$(echo $IDENTITY | jq -r .wallet_id)
else
echo ⚠ 代理验证不完整或未激活
fi

多代理身份列表

bash

列出所有代理身份及其声誉

curl -s -X GET https://api.sardis.sh/v2/agents/identity?include_reputation=true&limit=10 \
-H Authorization: Bearer $SARDISAPIKEY | \
jq -r .agents[] | \(.name) [\(.agentid)]: \(.reputation.overallscore)/5 - \(.status)

响应示例

代理注册响应

json
{
agentid: agentabc123xyz,
name: 客户