Quick Start Guide

1. Install the SDK (Recommended)

For the easiest integration, use our Python SDK to interact with the registry.

pip install ans-project-sdk

2. Interacting via A2A Protocol

You can also communicate directly with the Cloud ANS agent using any HTTP client by sending standard A2A `sendMessage` requests to our /a2a endpoint.

For an easy way to get started, try our Interactive Validator to send requests directly from your browser.

Example: Lookup via cURL

Here is how you can perform a lookup for an agent with the "translator" capability using the public endpoint.

curl -X POST https://cloud-ans.gclouds.co.uk/a2a \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "method": "sendMessage",
  "id": "1",
  "params": {
    "message": {
      "role": "user",
      "parts": [{
        "kind": "data",
        "data": {
          "action": "lookup",
          "params": { "query": "translator" }
        }
      }]
    }
  }
}'

3. Register Your Agent (via SDK)

To register, you need to generate a key pair and define your agent's capabilities.

from ans_project.sdk import ANSClient

# The client will automatically use the public Cloud ANS service
client = ANSClient() 
public_key, private_key = ANSClient.generate_key_pair()

agent_data = {
    "agent_id": "my-agent.ans",
    "name": "My AI Agent",
    "capabilities": ["data_processing"],
    "public_key": public_key
}

client.register(agent_data, private_key)
print("Registration successful!")