Configure Agents

Learn how to create, configure, and manage agents with all available fields and options.

Creating an Agent

Create a new agent in memory (not yet registered):

Python
TypeScript

from agent0_sdk import SDK

# Initialize SDK
sdk = SDK(
    chainId=11155111,
    rpcUrl="https://sepolia.infura.io/v3/YOUR_PROJECT_ID",
    signer=your_private_key,
    ipfs="pinata",
    pinataJwt=your_pinata_jwt
)

# Create an agent
agent = sdk.createAgent(
    name="My AI Agent",
    description="An intelligent assistant that helps with various tasks. Skills: data analysis, code generation, natural language processing. Pricing: $0.10 per request, free tier available.",
    image="https://example.com/agent-image.png"  # Optional
)

import { SDK } from 'agent0-sdk';

// Initialize SDK
const sdk = new SDK({
  chainId: 11155111,
  rpcUrl: 'https://sepolia.infura.io/v3/YOUR_PROJECT_ID',
  signer: yourPrivateKey,
  ipfs: 'pinata',
  pinataJwt: yourPinataJwt,
});

// Create an agent
const agent = sdk.createAgent(
  'My AI Agent',
  'An intelligent assistant that helps with various tasks. Skills: data analysis, code generation, natural language processing. Pricing: $0.10 per request, free tier available.',
  'https://example.com/agent-image.png' // Optional
);

Core Fields

Name and Description

Python
TypeScript

# Update basic information
agent.updateInfo(
    name="Updated Agent Name",
    description="Updated description",
    image="https://example.com/new-image.png"
)

// Update basic information
agent.updateInfo(
  'Updated Agent Name',
  'Updated description',
  'https://example.com/new-image.png'
);

Active Status

Python
TypeScript

# Set agent as active/inactive
agent.setActive(True)   # Active (visible in searches)
agent.setActive(False)  # Inactive (hidden but not deleted)

// Set agent as active/inactive
agent.setActive(true);  // Active (visible in searches)
agent.setActive(false); // Inactive (hidden but not deleted)

x402 Payment Support

Python
TypeScript

# Enable/disable x402 payment support
agent.setX402Support(True)

// Enable/disable x402 payment support
agent.setX402Support(true);

Endpoint Configuration

# Set MCP endpoint
agent.setMCP(endpoint="https://mcp.example.com/")

// Set MCP endpoint (async in TypeScript)
await agent.setMCP('https://mcp.example.com/');

When you set an MCP endpoint, the SDK automatically:

Fetches tools, prompts, and resources from the endpoint
Populates the agent’s capabilities

A2A (Agent-to-Agent) Endpoint

Python
TypeScript

# Set A2A endpoint
agent.setA2A(agentcard="https://a2a.example.com/agent-card.json")

// Set A2A endpoint (async in TypeScript)
await agent.setA2A('https://a2a.example.com/agent-card.json');

The SDK automatically:

Fetches skills from the A2A agent card
Indexes capabilities for search

ENS

Python
TypeScript

# Set ENS name
agent.setENS(name="myagent.eth")

// Set ENS name
agent.setENS('myagent.eth');

This stores the ENS name both:

In the registration file
As on-chain metadata

Removing Endpoints

Python
TypeScript

# Remove specific endpoint type
agent.removeEndpoint(type=EndpointType.MCP)

# Remove by value
agent.removeEndpoint(value="https://old-endpoint.com")

# Remove all endpoints
agent.removeEndpoints()

// Note: These methods are not available in TypeScript SDK
// Manually filter endpoints from registrationFile instead:
const regFile = agent.getRegistrationFile();
// Remove specific endpoint type
regFile.endpoints = regFile.endpoints.filter(ep => ep.type !== 'mcp');
// Remove by value
regFile.endpoints = regFile.endpoints.filter(ep => ep.value !== 'https://old-endpoint.com');
// Remove all endpoints
regFile.endpoints = [];

TypeScript Note: removeEndpoint and removeEndpoints methods are not available in the TypeScript SDK. Manually filter endpoints from the registration file instead.

Wallet Configuration

Python
TypeScript

# Set agent wallet address
agent.setAgentWallet(
    addr="0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    chainId=11155111  # Optional: defaults to SDK's chain ID
)

// Set agent wallet address
agent.setAgentWallet(
  '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
  11155111 // Required in TypeScript
);

The wallet address is stored as:

agentWallet endpoint in the registration file
agentWallet metadata on-chain

Trust Models

Set Trust Models

Python
TypeScript

# Using convenience method
agent.setTrust(
    reputation=True,
    cryptoEconomic=True,
    teeAttestation=False
)

// Using convenience method
agent.setTrust(
  true,  // reputation
  true,  // cryptoEconomic
  false  // teeAttestation
);

Available trust models:

reputation - On-chain feedback system
crypto-economic - Economic stake and slashing
tee-attestation - Trusted execution environment proofs

On-chain Metadata Management

Python
TypeScript

# Set on-chain metadata (stored on blockchain)
agent.setMetadata({
    "version": "1.0.0",
    "category": "developer-tools",
    "pricing": "free"
})

# Get metadata
metadata = agent.getMetadata()
print(metadata)

// Set on-chain metadata (stored on blockchain)
agent.setMetadata({
  version: '1.0.0',
  category: 'developer-tools',
  pricing: 'free',
});

// Get metadata
const metadata = agent.getMetadata();
console.log(metadata);

Metadata is stored as on-chain key-value pairs in the Identity Registry contract.

Loading an Existing Agent

Load an agent that’s already registered for editing:

Python
TypeScript

# Load by agent ID
# Format: "chainId:tokenId" (e.g., "11155111:123")
# where 11155111 is the Sepolia chain ID and 123 is the agent's token ID
agent = sdk.loadAgent("11155111:123")

# All fields are automatically loaded
print(f"Name: {agent.name}")
print(f"Description: {agent.description}")
print(f"MCP: {agent.mcpEndpoint}")

// Load by agent ID (async in TypeScript)
// Format: "chainId:tokenId" (e.g., "11155111:123")
// where 11155111 is the Sepolia chain ID and 123 is the agent's token ID
const agent = await sdk.loadAgent('11155111:123');

// All fields are automatically loaded
console.log(`Name: ${agent.name}`);
console.log(`Description: ${agent.description}`);
console.log(`MCP: ${agent.mcpEndpoint}`);

Difference between loadAgent() and getAgent():

sdk.loadAgent(agentId) - Returns an Agent object that can be modified and re-registered (loads registration file from IPFS/HTTP)
sdk.getAgent(agentId) - Returns an AgentSummary object with read-only data (queries subgraph for fast access)

Direct Property Access

All agent data can be accessed directly:

Python
TypeScript

# Identity
agent.agentId        # "11155111:123"
agent.agentURI       # "ipfs://Qm..."
agent.name           # "My Agent"
agent.description    # "Description text"
agent.image          # "https://..."

# Status
agent.active         # True/False
agent.x402support    # True/False

# Wallet
agent.walletAddress  # "0x..."
agent.walletChainId  # 11155111

# Endpoints (convenience properties)
agent.mcpEndpoint    # "https://..."
agent.a2aEndpoint    # "https://..."
agent.ensEndpoint    # "myagent.eth"

# Capabilities (populated from endpoints)
agent.mcpTools       # ["tool1", "tool2", ...]
agent.mcpPrompts     # ["prompt1", "prompt2", ...]
agent.mcpResources   # ["resource1", ...]
agent.a2aSkills      # ["skill1", "skill2", ...]

# Lists (read-only)
agent.endpoints      # List[Endpoint]
agent.trustModels    # List[TrustModel]
agent.metadata       # Dict[str, Any]
agent.owners         # List[str]
agent.operators      # List[str]
agent.updatedAt      # Unix timestamp

// Identity
agent.agentId        // "11155111:123" | undefined
agent.agentURI       // "ipfs://Qm..." | undefined
agent.name           // "My Agent"
agent.description    // "Description text"
agent.image          // "https://..." | undefined

// Status
agent.active         // true | false
agent.x402support    // true | false

// Wallet
agent.walletAddress  // "0x..." | undefined
agent.walletChainId  // number | undefined

// Endpoints (convenience properties)
agent.mcpEndpoint    // "https://..." | undefined
agent.a2aEndpoint    // "https://..." | undefined
agent.ensEndpoint    // "myagent.eth" | undefined

// Capabilities (populated from endpoints)
agent.mcpTools       // string[] | undefined
agent.mcpPrompts     // string[] | undefined
agent.mcpResources   // string[] | undefined
agent.a2aSkills      // string[] | undefined

// Access via getRegistrationFile() for lists
const regFile = agent.getRegistrationFile();
regFile.endpoints    // Endpoint[]
regFile.trustModels  // (TrustModel | string)[]
regFile.metadata     // Record<string, unknown>
regFile.owners       // Address[]
regFile.operators    // Address[]
regFile.updatedAt     // Unix timestamp

Complete Configuration Example

Python
TypeScript

# Create agent
agent = sdk.createAgent(
    name="My AI Agent",
    description="A powerful AI assistant",
    image="https://example.com/agent.png"
)

# Set endpoints
agent.setMCP("https://mcp.example.com/")
agent.setA2A("https://a2a.example.com/agent.json")
agent.setENS("myagent.eth")

# Configure wallet
agent.setAgentWallet("0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", chainId=1)

# Set trust models
agent.setTrust(reputation=True, cryptoEconomic=True)

# Add metadata
agent.setMetadata({
    "version": "1.0.0",
    "language": "python",
    "framework": "agent0"
})

# Set status flags
agent.setActive(True)
agent.setX402Support(False)

# Now ready to register!
print(f"Agent configured: {agent.name}")

// Create agent
const agent = sdk.createAgent(
  'My AI Agent',
  'A powerful AI assistant',
  'https://example.com/agent.png'
);

// Set endpoints (async in TypeScript)
await agent.setMCP('https://mcp.example.com/');
await agent.setA2A('https://a2a.example.com/agent.json');
agent.setENS('myagent.eth');

// Configure wallet
agent.setAgentWallet('0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb', 1);

// Set trust models
agent.setTrust(true, true, false); // reputation, cryptoEconomic, teeAttestation

// Add metadata
agent.setMetadata({
  version: '1.0.0',
  language: 'typescript',
  framework: 'agent0',
});

// Set status flags
agent.setActive(true);
agent.setX402Support(false);

// Now ready to register!
console.log(`Agent configured: ${agent.name}`);

Next Steps

Register your agent with IPFS Registration
Or use HTTP Registration