API ReferenceSearch

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 or null
The Almanac contract where the agent is registered
Allowed values:
readme_uniqueness_scoredouble or null0-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_scoredouble or null0-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_scoredouble or null0-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 or null

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

Errors