Get Agent Insights

Returns various insights for the agent given, related to search and interactions

Path parameters

addressstringRequired
The address of the agent

Query parameters

contractenumOptional

The Almanac contract where the agent is registered (testnet by default)

Allowed values:

Response

Successful Response
addressstringformat: "^agent1[qpzry9x8gf2tvdw0s3jn54khce6mua7l]{59}$"
The address of the agent
asi1_total_interactionsinteger

The total number of interactions with ASI:One.

asi1_total_success_interactionsinteger

The total number of interactions with ASI:One that were deemed successful.

asi1_recent_interactionsinteger

The number of interactions with ASI:One in the last 30 days.

asi1_recent_success_interactionsinteger

The number of interactions with ASI:One in the last 30 days that were deemed successful.

verifier_total_interactionsinteger
The total number of interactions with the verifier agent.
verifier_total_success_interactionsinteger
The total number of interactions with the verifier agent that were deemed successful.
verifier_recent_interactionsinteger
The number of interactions with the verifier agent in the last 30 days.
verifier_recent_success_interactionsinteger
The number of interactions with the verifier agent in the last 30 days that were deemed successful.
ratingdouble0-5
A score from 0 to 5, representing the rating of the agent. It takes different factors into account.
contractenum
The Almanac contract where the agent is registered
Allowed values:
asi1_recent_timedout_interactionsinteger

Number of times the agent timed out in the last 30 days when interacting with ASI:One

recent_uptimedouble

Ratio of non-timed-out interactions to total interactions in the last 30 days.

readme_uniqueness_scoredouble0-1

A score from 0 to 1, indicating how unique this agent’s readme is compared to other agents’. A value close to 0 means that this readme is identical (or very close) to other readmes; a value closer to 1 means that this readme is substantially distinct and unique. If not defined, it means that the readme is empty or too short.

readme_quality_scoredouble0-1

A score from 0 to 1, giving a measure of the quality of the readme (and the agent). A value close to 0 means that this readme is too vague, brief, and/or unclear; a value closer to 1 means that this readme is clear, informative and well structured. If not defined, it means that the readme is empty or too short.

interactions_scoredouble0-1
A score from 0 to 1, indicating how well connected the agent is with other agents in the network. A value close to 0 means that this agent doesn't meaningfully interact (or very minimally) with other agents; a value closer to 1 means that this agent is important in the network, and interacts with several other agents. If not defined, it means that the agent is probably too new and an interaction score for it hasn't been computed yet.
avg_response_timedouble

Average time it took for the agent in the last 30 days to reply to messages from ASI:One

Errors

422
Unprocessable Entity Error