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.