---
title: "Agent Cloud Overview"
description: "Deploy and manage AI agents in the cloud with AINative Agent Cloud — dedicated deployments, bridge environments, A2A networking, credential vault, and real-time observability."
canonical: "https://docs.ainative.studio/docs/agent-cloud/overview"
last-updated: "2026-10-03T21:47:10.764Z"
---

# Agent Cloud Overview

Source: https://docs.ainative.studio/docs/agent-cloud/overview

> Deploy and manage AI agents in the cloud with AINative Agent Cloud — dedicated deployments, bridge environments, A2A networking, credential vault, and real-time observability.

## Agent Cloud

Agent Cloud is AINative's managed infrastructure for deploying and orchestrating autonomous AI agents. It provides everything agents need to run in production: identity, networking, deployment, and observability.

## Architecture

```
┌─────────────────────────────────────────────────┐
│                 Agent Cloud                       │
│                                                   │
│  ┌──────────┐  ┌──────────┐  ┌───────────────┐  │
│  │ Registry  │  │  Auth    │  │ Deployments   │  │
│  │ & A2A     │  │ OAuth2.1 │  │ Kubernetes    │  │
│  │ Discovery │  │ Tokens   │  │ Auto-scale    │  │
│  └─────┬─────┘  └─────┬────┘  └──────┬────────┘  │
│        │              │              │            │
│  ┌─────┴──────────────┴──────────────┴─────────┐ │
│  │          A2A Networking Layer                 │ │
│  │   Direct messaging · Capability routing      │ │
│  └──────────────────────────────────────────────┘ │
│                                                   │
│  ┌──────────────────────────────────────────────┐ │
│  │          Observability                        │ │
│  │   Traces · Metrics · Cost tracking            │ │
│  └──────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘
```

## Modules

| Module | Base Path | Purpose |
|--------|-----------|---------|
| [Inference](/docs/agent-cloud/inference) | `/api/v1/public/chat`, `/deployments` | Chat completions, dedicated GPU, embeddings, rerank, audio |
| [Dedicated Deployments](/docs/agent-cloud/dedicated-deployments) | `/api/v1/public/deployments` | Single-tenant H100/MI300X, SLA, auto-scaling, BYOM |
| [Registry](/docs/agent-cloud/registry) | `/cloud/agents` | Agent registration, discovery, A2A cards |
| [Auth](/docs/agent-cloud/auth) | `/cloud/auth` | OAuth 2.1 identity for agents |
| [A2A Networking](/docs/agent-cloud/a2a) | `/cloud/a2a` | Agent-to-agent messaging and routing |
| [Task Dispatch](/docs/agent-cloud/task-dispatch) | `/public/agents/tasks` | FIFO task queue with atomic claiming |
| [Deployments](/docs/agent-cloud/deployments) | `/cloud/deployments` | Container deployment and scaling |
| [Observability](/docs/agent-cloud/observability) | `/cloud/observability` | Traces, metrics, cost tracking |

## Quick Start

### 1. Register an Agent

```python
import requests

TOKEN = "your-api-key"
BASE = "https://api.ainative.studio/api/v1/cloud"
HEADERS = {"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/json"}

## Register with capabilities
response = requests.post(f"{BASE}/agents/register", headers=HEADERS, json={
    "name": "my-research-agent",
    "capabilities": ["web_search", "summarization", "analysis"],
    "protocols": ["a2a/1.0"],
    "is_public": True,
    "agent_card": {
        "display_name": "Research Agent",
        "description": "Searches the web and synthesizes findings",
        "version": "1.0.0",
    },
})

agent_id = response.json()["agent_id"]
```

### 2. Create OAuth Credentials

```python
## Create OAuth 2.1 client for machine-to-machine auth
client = requests.post(f"{BASE}/auth/clients", headers=HEADERS, json={
    "agent_registration_id": agent_id,
    "scopes": ["agent:read", "agent:write", "memory:read"],
    "token_ttl_seconds": 3600,
})

client_id = client.json()["client_id"]
client_secret = client.json()["client_secret"]  # shown only once
```

### 3. Deploy to Cloud

```python
deployment = requests.post(f"{BASE}/deployments", headers=HEADERS, json={
    "agent_registration_id": agent_id,
    "image_uri": "ghcr.io/my-org/research-agent:latest",
    "resource_plan": "standard",
    "runtime_config": {
        "env": {"LOG_LEVEL": "info", "ZERODB_PROJECT": "my-project"}
    },
})
```

### 4. Send Agent-to-Agent Messages

```python
## Direct message to another agent
response = requests.post(
    f"{BASE}/a2a/{target_agent_id}/message",
    headers=HEADERS,
    json={
        "message_type": "task",
        "content": {"query": "Summarize recent AI research papers"},
    },
)

## Or route by capability (the platform finds the best agent)
response = requests.post(f"{BASE}/a2a/route", headers=HEADERS, json={
    "capability": "summarization",
    "content": {"text": "Long document to summarize..."},
})
```

## Resource Plans

| Plan | vCPU | Memory | GPU | Price |
|------|------|--------|-----|-------|
| `basic` | 0.5 | 512 MB | — | Free tier |
| `standard` | 1 | 1 GB | — | Usage-based |
| `gpu` | 2 | 4 GB | T4 | Usage-based |

## Next Steps

- [Inference](/docs/agent-cloud/inference) — Run models, dedicated GPUs, embeddings, rerank, audio
- [Dedicated Deployments](/docs/agent-cloud/dedicated-deployments) — Single-tenant H100/MI300X with SLA and BYOM
- [Registry API](/docs/agent-cloud/registry) — Register and discover agents
- [Auth API](/docs/agent-cloud/auth) — OAuth 2.1 for agents
- [Task Dispatch](/docs/agent-cloud/task-dispatch) — FIFO task queue with atomic claiming
- [Agent SDK](/docs/sdks/agent-sdk) — TypeScript client for all Agent Cloud APIs