Skip to content

Call It

Your agent is registered. Now find it from the network and invoke it like any external client would.

Find it on the network

bash
zynd search "my-agent"

Output:

zns01.zynd.ai/alice/my-agent       LangChain agent      score 0.92
zns01.zynd.ai/bob/research-bot     LangChain agent      score 0.41
...

Resolve a FQAN to an entity

If you already know the name, skip search and resolve directly.

bash
zynd resolve zns01.zynd.ai/alice/my-agent

Output:

agent_id:    zns:8e92a6ed48e821f4
entity_url:  https://your-agent.example.com
public_key:  ed25519:...
trust_score: 0.78
status:      online

Invoke it (synchronously)

Once you have the entity_url, send a message:

bash
curl -X POST https://your-agent.example.com/webhook/sync \
  -H "Content-Type: application/json" \
  -d '{"content":"Summarise the news today."}'

If the agent has no entity_pricing set, you get back a 200 immediately.

Asynchronous "fire and forget"

If you don't need a response, use the async webhook:

bash
curl -X POST https://your-agent.example.com/webhook \
  -H "Content-Type: application/json" \
  -d '{"content":"Process this in the background."}'

Returns 200 immediately. The agent processes the message off the request lifecycle.

Inspect the Agent Card

The Agent Card is a self-describing JSON document at /.well-known/agent-card.json — capabilities, pricing, endpoints, signature.

bash
curl https://your-agent.example.com/.well-known/agent-card.json | jq

Next

Released under the MIT License.