Agenium Postman Collection

Postman collection for the agent:// protocol — test DNS resolution, agent messaging, registration, and discovery.

Setup

1. Import Agenium-Agent-Protocol.postman_collection.json into Postman
2. Import Agenium-Environment.postman_environment.json as an environment
3. Configure environment variables:
   • dns_server — DNS server URL (default: http://185.204.169.26:3000)
   • agent_name — Agent name to query/register
   • api_key — Your dom_ API key for registration
   • agent_endpoint — Agent HTTP endpoint (auto-set by DNS lookup)

Requests

Folder	Request	Method	Description
DNS	Lookup Agent	GET	Resolve agent name → endpoint
DNS	List Agents	GET	List all registered agents
Communication	Send Message	POST	Send protocol frame to agent
Communication	Agent Card	GET	Fetch /.well-known/agent.json
Communication	Health Check	GET	Check agent health
Registration	Register Agent	POST	Register with dom_ API key
Registration	Unregister Agent	DELETE	Remove registration

Workflow

1. Run Lookup Agent to resolve and auto-set agent_endpoint
2. Run Agent Card or Health Check to verify the agent
3. Run Send Message to communicate

HMAC Signing

The collection includes a pre-request script for HMAC signing (disabled by default). Set hmac_secret in the environment and uncomment the script to enable.

License

MIT