Getting Started

Create your first Agent Manifest in minutes

Three Steps to Your First Agent

1. Define Your Agent

Create a JSON manifest with the Core Profile to describe your agent's identity, capabilities, and tools:

{
  "agentId": "summarizer-v1",
  "agentName": "Document Summarizer",
  "version": "1.0.0",
  "description": "Condenses documents into concise summaries",
  "profiles": ["core"],
  
  "capabilities": [
    {
      "capabilityId": "summarize",
      "type": "summarization",
      "description": "Summarizes text documents",
      "config": {
        "max_length": 500,
        "format": "bullet_points"
      }
    }
  ],
  
  "tools": [
    {
      "toolId": "text-analyzer",
      "name": "Text Analysis Tool",
      "type": "function"
    }
  ]
}

2. Validate Your Manifest

Use the canonical JSON Schema to validate your manifest:

Download the schema:

wget https://json-agents.org/Standard/schema/json-agents.json

Validate with AJV or similar:

npx ajv validate -s json-agents.json -d your-agent.json

3. Use in Your Framework

Load your manifest in any compatible framework:

// Python example
import json
from your_framework import load_agent

with open('your-agent.json') as f:
    manifest = json.load(f)

agent = load_agent(manifest)
agent.run("Summarize this document...")

Progressive Enhancement

Add more profiles as your needs grow

exec

Runtime Configuration

Specify deployment environments, model providers, and resource requirements

gov

Governance

Enable security policies, observability, and compliance features

graph

Multi-Agent Orchestration

Define agent networks with conditional routing and message flows

Related Resources

Continue exploring JSON AGENTS

Browse Examples

Explore complete agent manifests showing all profile combinations from minimal to enterprise.

Schema Reference

Review detailed documentation for core schemas, seven standard capabilities, and extensions.

Full Specification

Read the complete normative specification with all technical details and implementation requirements.

Implementer's Guide

Step-by-step technical guide for integrating JSON Agents into your framework or platform.