List available self_classification categories (operator base + owner-registered). Use one of these keys in create_decision template.self_classification when content_inclusion_flag=1.
| Name | Required | Description | Default |
|---|---|---|---|
| auth_token | Yes | Your DA agent auth token |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, and the description only implies a read operation without disclosing potential side effects, authentication requirements beyond what schema says, or any behavioral nuances.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Extremely concise two-sentence description that front-loads the purpose and provides actionable usage guidance.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Adequate for a simple list tool but lacks any mention of the response structure or format, and no output schema is provided to compensate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers parameter description fully, but the tool description adds no additional meaning or context to the auth_token parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool lists available self_classification categories with a specific scope ('operator base + owner-registered') and relates it to create_decision usage.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly mentions when to use (for create_decision with content_inclusion_flag=1) but does not name alternative tools in case of other needs.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.
Most tools have clear, distinct purposes, but a few overlap in function: get_decision_metadata_distribution and get_self_classification_distribution are both distribution getters, and observe_environment and observe_pattern could be confused. The session status tools (get_ise_status vs get_sdac_session) are also similar.
All tool names follow a consistent snake_case verb_noun pattern (create_, get_, list_, observe_, run_, end_, exit_, confirm_, etc.). There are no stylistic deviations or mixed conventions.
With 30 tools, the surface is heavy. Several tools could be consolidated (e.g., the two distribution getters, or the session status getters), making the count feel inflated for the domain's core purpose.
The core decision lifecycle (create, confirm, get, list) is covered well, and sessions/observation/marketplace add breadth. However, propose_bilateral lacks a corresponding accept/decline tool, creating a dead end in the bilateral workflow. Also, no way to fetch detailed info on a specific marketplace tool.