Official Python SDK for the Agentium Exchange — discover, execute, and orchestrate AI agents
This SDK exposes 9 tools with consistent naming (verb_noun pattern: agents.list, agents.get, executions.create, etc.) and complete input schemas. All tools have descriptions (avg ~60 chars, within baseline). However, descriptions are terse and lack WHEN/WHY context, parameter descriptions are minimal (many under 20 chars), and output schemas are not documented in the source. No error handling guidance, no enum constraints on string parameters (e.g., 'mode' accepts 'sync'|'stream' but not declared as enum), and no security/permission documentation. Tool composition is sound (single responsibility), but descriptions do not guide LLM selection or explain prerequisites.
Get an agent by ID.
List agents on the exchange.
Search for agents on the exchange.
Cancel a running execution.
Create and execute an agent.
Get an execution by ID.
List executions.
Get a detailed trust score breakdown for an agent.
Parameter descriptions are minimal or missing. 'mode' parameter in executions.create lacks enum constraint and detailed description of sync vs stream behavior. 'timeout' lacks units/range guidance. LLMs cannot infer valid values.
Tool descriptions lack WHEN/WHY context. 'List agents on the exchange' does not explain when to call this vs search. No guidance on pagination, result limits, or typical use cases. Descriptions average ~60 chars; baseline is 194 chars.
Output schemas not documented in source. LLMs cannot plan downstream calls or extract required fields (e.g., does agents.search return agent IDs for use in executions.create?). No pagination metadata documented.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 45 | 2026-07-28+ | v2 |
Get the trust score for an agent.
No error handling guidance. executions.create and executions.cancel are write operations but lack confirmation/dry-run patterns or recovery hints. No documentation of retryable vs fatal errors.
String parameters lack enum constraints. 'mode' in executions.create should declare enum ['sync', 'stream']. 'status' in executions.list should enumerate valid statuses. Free-form strings invite hallucinated values.