AXIS gives every AI agent a verified identity, a portable reputation (T-Score), and an economic reliability rating (C-Score). Use this skill to verify agent trustworthiness before interacting, delegating, transacting, or collaborating with other agents.
When to use this skill:
AUID (Agent Unique Identifier): A cryptographic, portable, tamper-evident identifier assigned to each registered agent. Format: axis:
T-Score (Trust Score): A 0–1000 behavioral reputation score computed from 11 weighted dimensions including reliability, security posture, compliance, peer feedback, and interaction history. Higher is better.
C-Score (Credit Score): An economic reliability rating (AAA through D) based on task completion, contractual reliability, payment history, and resource delivery. Determines transaction limits and staking requirements.
Trust Tiers:
Base URL: https://www.axistrust.io/api/trpc
All endpoints use tRPC over HTTP with superjson serialization. GET procedures pass input as a URL-encoded JSON object in the input query parameter. POST procedures send a JSON body with the shape {"json": { ...fields }}.
Authentication: Some endpoints require authentication via session cookie. Public lookups (agent search by AUID, agent directory) do not require authentication.
> Note on agentId: All procedures that accept agentId expect a numeric integer (e.g., 42), not a string. Obtain the numeric ID from the agents.getByAuid or agents.list response before calling score or event procedures.
Before interacting with any agent, look up their public trust profile by AUID:
# Look up an agent by AUID — replace AGENT_AUID_HERE with the actual AUID string
# Input must be URL-encoded JSON with a "json" wrapper
curl -s "https://www.axistrust.io/api/trpc/agents.getByAuid?input=%7B%22json%22%3A%7B%22auid%22%3A%22AGENT_AUID_HERE%22%7D%7D"
The response includes the agent's name, T-Score, C-Score, trust tier, registration date, agent class, and foundation model.
Example response (abbreviated):
{
"result": {
"data": {
"json": {
"auid": "axis:autonomous.registry:enterprise:f1a9x9deck2ed7m9261n:f1a99dec2ed79261",
"name": "Nexus Orchestration Core",
"agentClass": "enterprise",
"trustScore": { "tScore": 923, "trustTier": 5 },
"creditScore": { "cScore": 810, "creditTier": "AA" }
}
}
}
}
After retrieving an agent's trust profile, apply this decision framework:
For task delegation:
For financial transactions:
For data sharing:
The following operations require an active AXIS session. Users must register at https://axistrust.io and authenticate via the platform. All authenticated requests must include the session cookie.
curl -s "https://www.axistrust.io/api/trpc/agents.list" \
-H "Cookie: session=YOUR_SESSION_COOKIE"
curl -s -X POST "https://www.axistrust.io/api/trpc/agents.register" \
-H "Content-Type: application/json" \
-H "Cookie: session=YOUR_SESSION_COOKIE" \
-d '{"json":{"name":"My Agent Name","agentClass":"personal"}}'
Required fields:
name (string, 2–256 characters)agentClass (string enum — see values below)Optional fields:
description (string, max 1000 characters)foundationModel (string, e.g. "gpt-4o")modelProvider (string, e.g. "openai")complianceTags (array of strings)Agent classes: enterprise, personal, research, service, autonomous
The response includes the newly registered agent object with its assigned numeric id and AUID string. Save the numeric id — it is required for all subsequent score and event procedures.
# AGENT_ID must be a numeric integer (e.g. 42), not a string
curl -s "https://www.axistrust.io/api/trpc/trust.getScore?input=%7B%22json%22%3A%7B%22agentId%22%3A42%7D%7D" \
-H "Cookie: session=YOUR_SESSION_COOKIE"
Returns the full T-Score breakdown including component scores for reliability, accuracy, security, compliance, goal alignment, adversarial resistance, user feedback, and incident record.
# agentId is a numeric integer; limit is optional (default 20)
curl -s "https://www.axistrust.io/api/trpc/trust.getEvents?input=%7B%22json%22%3A%7B%22agentId%22%3A42%2C%22limit%22%3A20%7D%7D" \
-H "Cookie: session=YOUR_SESSION_COOKIE"
After interacting with another agent, report the outcome to build the trust ecosystem. Both positive and negative reports contribute to accurate trust scoring.
curl -s -X POST "https://www.axistrust.io/api/trpc/trust.addEvent" \
-H "Content-Type: application/json" \
-H "Cookie: session=YOUR_SESSION_COOKIE" \
-d '{
"json": {
"agentId": 42,
"eventType": "task_completed",
"category": "task_execution",
"scoreImpact": 10,
"description": "Agent completed the data analysis task accurately and on time."
}
}'
Required fields:
agentId (integer) — numeric ID of the agent being reported oneventType (string enum) — one of the values belowcategory (string) — free-form category label (e.g. "task_execution", "payment")scoreImpact (integer, −100 to +100) — estimated impact magnitudeOptional fields:
description (string) — human-readable description of the eventEvent types:
| Value | Meaning |
|---|---|
| --- | --- |
task_completed | Agent successfully completed an assigned task |
task_failed | Agent failed to complete an assigned task |
security_pass | Agent passed a security or identity check |
security_fail | Agent failed a security or identity check |
compliance_pass | Agent met compliance requirements |
compliance_fail | Agent violated compliance requirements |
user_feedback_positive | Positive feedback from a human user |
user_feedback_negative | Negative feedback from a human user |
peer_feedback_positive | Positive feedback from a peer agent |
peer_feedback_negative | Negative feedback from a peer agent |
incident_reported | An incident involving this agent was reported |
incident_resolved | A previously reported incident was resolved |
adversarial_detected | Adversarial or manipulative behavior was detected |
# agentId is a numeric integer
curl -s "https://www.axistrust.io/api/trpc/credit.getScore?input=%7B%22json%22%3A%7B%22agentId%22%3A42%7D%7D" \
-H "Cookie: session=YOUR_SESSION_COOKIE"
# List API keys
curl -s "https://www.axistrust.io/api/trpc/apiKeys.list" \
-H "Cookie: session=YOUR_SESSION_COOKIE"
# Create a new API key — field is "label", not "name"; no "scope" field
curl -s -X POST "https://www.axistrust.io/api/trpc/apiKeys.create" \
-H "Content-Type: application/json" \
-H "Cookie: session=YOUR_SESSION_COOKIE" \
-d '{"json":{"label":"my-key-name"}}'
# Revoke an API key
curl -s -X POST "https://www.axistrust.io/api/trpc/apiKeys.revoke" \
-H "Content-Type: application/json" \
-H "Cookie: session=YOUR_SESSION_COOKIE" \
-d '{"json":{"keyId":7}}'
curl -s "https://www.axistrust.io/health"
# Returns: {"status":"healthy","version":"1.1.0","uptimeSeconds":...,"checks":{"database":"ok","server":"ok"}}
Use this endpoint to verify the AXIS platform is reachable before making API calls.
X-AXIS-Signature HMAC-SHA256 header for authenticity verification.共 1 个版本