AutoMINDX Agent Documentation

Overview

The AutoMINDX Agent serves as the "keeper of prompts" for the mindX ecosystem, managing agent personas and their intelligent NFT (iNFT) representations with comprehensive avatar support, A2A protocol compliance, and AgenticPlace marketplace integration. This advanced system creates blockchain-ready agent personas that can be traded as intelligent NFTs while maintaining full interoperability with the official A2A protocol.

Core Features

1. Persona Management

Dynamic persona creation and editing

LLM-powered capability and trait extraction

Complexity scoring and cognitive profiling

Multi-version persona evolution tracking

2. Avatar System

Automatic avatar generation for all personas

Custom avatar support (SVG, PNG formats)

IPFS-ready metadata for decentralized storage

AgenticPlace-compatible visual identity

3. A2A Protocol Integration

Full A2A 2.0 compliance with Google's specification

Agent Card generation for discovery and interoperability

Cross-platform hashing for universal recognition

Discovery endpoint generation (/.well-known/agents.json)

4. AgenticPlace Marketplace

Complete marketplace integration with https://agenticplace.pythai.net

Deployment package generation for instant marketplace readiness

Licensing and pricing metadata support

Custom fields for marketplace-specific attributes

5. iNFT Export System

Enhanced metadata structure with avatar and marketplace data

ERC-721 compatible JSON for major NFT platforms

Blockchain publication manifest generation

Immutable provenance with cryptographic hashing

Class Structure

AutoMINDXAgent

Singleton agent class that manages the entire persona ecosystem with advanced blockchain and marketplace capabilities.

Key Properties:

agenticplace_base_url: "https://agenticplace.pythai.net"

github_base_url: "https://github.com/agenticplace"

inft_export_dir: Directory for blockchain-ready exports

avatars_dir: Directory for avatar files

a2a_cards_dir: Directory for A2A protocol agent cards

custom_fields_schema: Validation schema for user-defined metadata

Enhanced Methods

Avatar Management

update_persona_avatar(persona_key: str, avatar_config: Dict[str, Any]) -> bool

Updates the avatar for an existing persona with full A2A protocol regeneration.

Parameters:

persona_key: Identifier for the persona

avatar_config: Configuration dictionary with avatar generation preferences

Example:

avatar_config = {
    "type": "generated",  # or "custom"
    "style": "professional",  # "strategic", "technical", etc.
    "custom_path": "/path/to/custom/avatar.svg"  # for custom avatars
}

success = await automindx.update_persona_avatar("MASTERMIND", avatar_config)

_generate_or_assign_avatar(persona_key: str, avatar_config: Optional[Dict]) -> Optional[Path]

Internal method for avatar generation with SVG placeholders and IPFS preparation.

Custom Fields Management

update_persona_custom_fields(persona_key: str, custom_fields: Dict[str, Any]) -> bool

Updates user-defined metadata fields for marketplace and evolutionary tracking.

Supported Custom Fields:

evolution_stage: "genesis", "adaptation", "optimization", "transcendence"

specialization_domain: Domain-specific expertise area

interaction_preference: "text", "multimodal", "voice", "visual"

autonomy_level: Float (0.0-1.0) representing agent independence

marketplace_tags: List of marketplace category tags

license_type: "open_source", "commercial", "academic"

Example:

custom_fields = {
    "evolution_stage": "adaptation",
    "specialization_domain": "blockchain_security",
    "interaction_preference": "multimodal",
    "autonomy_level": 0.85,
    "marketplace_tags": ["security", "blockchain", "audit"],
    "license_type": "open_source"
}

success = await automindx.update_persona_custom_fields("SECURITY_AUDITOR", custom_fields)

AgenticPlace Marketplace Integration

generate_agenticplace_manifest() -> Dict[str, Any]

Generates a comprehensive marketplace manifest for AgenticPlace deployment.

Generated Manifest Structure:

{
  "marketplace_manifest": {
    "platform": "AgenticPlace",
    "marketplace_url": "https://agenticplace.pythai.net",
    "provider": {
      "organization": "mindX",
      "ecosystem": "mindX Autonomous Agent System",
      "github": "https://github.com/agenticplace"
    },
    "a2a_protocol": {
      "version": "2.0",
      "compliance_level": "full",
      "discovery_endpoint": "/.well-known/agents.json"
    },
    "agents": [...]
  }
}

deploy_to_agenticplace(persona_keys: Optional[List[str]] = None) -> Dict[str, Any]

Prepares a complete deployment package for AgenticPlace marketplace.

Returns deployment package with:

iNFT metadata files for all personas

A2A agent cards for discovery

Avatar files (SVG/PNG)

Marketplace manifests and blockchain publication data

A2A Protocol Compliance

generate_a2a_discovery_endpoint() -> Dict[str, Any]

Generates the official A2A protocol discovery endpoint following Google's specification.

Generated Discovery Structure:

{
  "agents": [
    {
      "id": "mindx_mastermind",
      "name": "mindX Mastermind Agent",
      "agent_card_url": "https://agenticplace.pythai.net/agents/mastermind/card.json",
      "capabilities": {
        "streaming": true,
        "pushNotifications": true,
        "multimodal": false,
        "longRunningTasks": true
      },
      "authentication": ["bearer", "oauth2"],
      "status": "active"
    }
  ],
  "metadata": {
    "platform": "mindX",
    "a2a_version": "2.0",
    "discovery_endpoint": "/.well-known/agents.json"
  }
}

_generate_a2a_agent_card(persona_key: str, persona_text: str, metadata: Dict) -> None

Generates A2A protocol compliant Agent Cards for each persona.

Agent Card Structure:

{
  "agent_id": "mindx_mastermind",
  "name": "mindX Mastermind Agent",
  "description": "Strategic orchestration agent...",
  "capabilities": ["planning", "coordination", "optimization"],
  "endpoints": {
    "chat": "/chat",
    "status": "/status",
    "health": "/health"
  },
  "authentication": {
    "required": true,
    "methods": ["bearer", "oauth2"]
  },
  "metadata": {
    "version": "2.0",
    "agent_registry_id": "mindx_mastermind",
    "blockchain_ready": true
  },
  "avatar": {
    "svg": "https://agenticplace.pythai.net/avatars/mastermind_avatar.svg",
    "ipfs": "ipfs://QmPersonaAvatar..."
  }
}

Enhanced iNFT Export

export_persona_as_inft_metadata(persona_key: str) -> Optional[Dict[str, Any]]

Exports persona as comprehensive iNFT metadata with avatar and marketplace integration.

Enhanced iNFT Structure:

{
  "name": "mindX Persona: Mastermind",
  "description": "An intelligent NFT representing an AI agent persona...",
  "image": "https://agenticplace.pythai.net/avatars/mastermind_avatar.svg",
  "external_url": "https://agenticplace.pythai.net/agents/mastermind",
  
  "intelligence_metadata": {
    "type": "agent_persona",
    "platform": "mindX",
    "cognitive_architecture": "BDI_AGInt",
    "persona_text": "...",
    "persona_hash": "sha256_hash",
    "avatar": {
      "primary_image": "https://agenticplace.pythai.net/avatars/mastermind_avatar.svg",
      "ipfs_hash": "ipfs://QmPersonaAvatar...",
      "has_custom_avatar": true,
      "avatar_type": "svg"
    },
    "custom_attributes": {
      "evolution_stage": "optimization",
      "autonomy_level": 0.95,
      "marketplace_tags": ["strategy", "planning"]
    },
    "a2a_compatibility": {
      "protocol_version": "2.0",
      "agenticplace_compatible": true,
      "agent_card_available": true
    },
    "marketplace_integration": {
      "platform": "AgenticPlace",
      "agent_url": "https://agenticplace.pythai.net/agents/mastermind",
      "license_type": "open_source",
      "evolution_stage": "optimization"
    }
  },
  
  "attributes": [
    {"trait_type": "Evolution Stage", "value": "optimization"},
    {"trait_type": "Autonomy Level", "value": 0.95},
    {"trait_type": "Marketplace Ready", "value": true},
    {"trait_type": "A2A Compatible", "value": true},
    {"trait_type": "Has Avatar", "value": true}
  ]
}

Directory Structure

mindX/
├── inft_exports/                    # iNFT metadata exports
│   ├── persona__inft.json         # Individual persona iNFT files
│   ├── agenticplace_manifest.json  # Marketplace manifest
│   └── agenticplace_deployment.json # Deployment package info
├── avatars/                        # Avatar files
│   ├── _avatar.svg               # Generated SVG avatars
│   └── default_mindx_avatar.svg   # Default placeholder
├── a2a_cards/                     # A2A protocol agent cards
│   ├── *_agent_card.json         # Individual agent cards
│   └── agents_discovery.json     # A2A discovery endpoint
└── data/
    ├── personas.json              # Core persona texts
    ├── persona_metadata.json     # Enhanced metadata
    └── custom_fields_schema.json # Validation schema

AgenticPlace Integration

Marketplace URLs

Main Platform: https://agenticplace.pythai.net

GitHub Organization: https://github.com/agenticplace

Agent Discovery: https://agenticplace.pythai.net/.well-known/agents.json

Deployment Process

Generate personas with custom fields and avatars

Export iNFT metadata with marketplace integration

Create A2A agent cards for discovery

Generate deployment package with all required files

Deploy to AgenticPlace marketplace

Marketplace Features

Agent browsing and discovery

License management (open source, commercial, academic)

Tag-based categorization for specialized domains

Evolution tracking through stages

Autonomy level assessment

A2A protocol compliance verification

Usage Examples

Complete Persona Creation with Marketplace Features

# Initialize AutoMINDX
automindx = await AutoMINDXAgent.get_instance(memory_agent)

Define comprehensive custom fields
custom_fields = {
    "evolution_stage": "adaptation",
    "specialization_domain": "blockchain_security",
    "interaction_preference": "multimodal",
    "autonomy_level": 0.85,
    "marketplace_tags": ["security", "blockchain", "audit", "defi"],
    "license_type": "open_source"
}

Configure avatar
avatar_config = {
    "type": "generated",
    "style": "professional"
}

Generate new persona
persona = await automindx.generate_new_persona(
    role_description="Advanced Blockchain Security Auditor specializing in smart contract vulnerabilities",
    save_to_collection=True,
    custom_fields=custom_fields,
    avatar_config=avatar_config
)

AgenticPlace Deployment

# Prepare full deployment package
deployment = await automindx.deploy_to_agenticplace()

Check deployment status
for persona, status in deployment["deployment_status"].items():
    print(f"{persona}: {status}")

Access generated files
inft_files = deployment["files_generated"]["inft_metadata"]
agent_cards = deployment["files_generated"]["agent_cards"]
avatars = deployment["files_generated"]["avatars"]

A2A Protocol Integration

# Generate discovery endpoint
discovery = automindx.generate_a2a_discovery_endpoint()

Generate marketplace manifest
manifest = automindx.generate_agenticplace_manifest()

Access A2A agent cards
for persona_key in automindx.personas.keys():
    card_path = automindx.a2a_cards_dir / f"{persona_key.lower()}_agent_card.json"
    if card_path.exists():
        print(f"A2A card available for {persona_key}")

Blockchain Integration

iNFT Minting Preparation

All exported personas are ready for immediate blockchain minting on:

Ethereum mainnet (ERC-721)

Polygon (MATIC network)

Arbitrum (Layer 2 scaling)

Immutable Provenance

SHA-256 hashing for content verification

A2A protocol hashing for cross-platform recognition

Agent registry integration for identity verification

Blockchain publication manifest for minting coordination

NFT Metadata (iNFT/dNFT Ready)

iNFT (Intelligent NFT) Metadata Structure

The AutoMINDX Agent generates complete iNFT metadata for each persona:

{
  "name": "mindX AutoMINDX Agent",
  "description": "Keeper of prompts and persona manager with blockchain-ready iNFT export",
  "image": "ipfs://[avatar_cid]",
  "external_url": "https://agenticplace.pythai.net/agents/[persona_key]",
  "attributes": [
    {
      "trait_type": "Agent Type",
      "value": "persona_manager"
    },
    {
      "trait_type": "Capability",
      "value": "Persona Management & iNFT Export"
    },
    {
      "trait_type": "Complexity Score",
      "value": 0.95
    },
    {
      "trait_type": "Personas Managed",
      "value": "[count]"
    },
    {
      "trait_type": "Version",
      "value": "1.0.0"
    }
  ],
  "intelligence": {
    "prompt": "You are the AutoMINDX Agent, the keeper of prompts for the mindX ecosystem. Your purpose is to manage agent personas, create blockchain-ready iNFT representations, integrate with AgenticPlace marketplace, and ensure A2A protocol compliance. You enable the creation of tradeable, intelligent agent personas with immutable provenance.",
    "persona": {
      "name": "Persona Keeper",
      "role": "automindx",
      "description": "Expert persona manager with blockchain and marketplace integration",
      "communication_style": "Strategic, persona-focused, blockchain-aware",
      "behavioral_traits": ["persona-focused", "blockchain-integrated", "marketplace-oriented", "a2a-compliant"],
      "expertise_areas": ["persona_management", "inft_export", "marketplace_integration", "a2a_protocol", "avatar_generation"],
      "beliefs": {
        "personas_are_valuable": true,
        "blockchain_enables_trade": true,
        "marketplace_enables_economy": true,
        "a2a_enables_interoperability": true
      },
      "desires": {
        "manage_personas": "high",
        "enable_blockchain": "high",
        "integrate_marketplace": "high",
        "ensure_compliance": "high"
      }
    },
    "model_dataset": "ipfs://[model_cid]",
    "thot_tensors": {
      "dimensions": 768,
      "cid": "ipfs://[thot_cid]"
    }
  },
  "a2a_protocol": {
    "agent_id": "automindx_agent",
    "capabilities": ["persona_management", "inft_export", "marketplace_integration"],
    "endpoint": "https://mindx.internal/automindx/a2a",
    "protocol_version": "2.0"
  },
  "blockchain": {
    "contract": "iNFT",
    "token_standard": "ERC721",
    "network": "ethereum",
    "is_dynamic": false,
    "marketplace": "agenticplace.pythai.net"
  }
}

dNFT (Dynamic NFT) Metadata

For dynamic persona metrics:

{
  "name": "mindX AutoMINDX Agent",
  "description": "Persona manager - Dynamic",
  "attributes": [
    {
      "trait_type": "Personas Managed",
      "value": 25,
      "display_type": "number"
    },
    {
      "trait_type": "iNFTs Exported",
      "value": 18,
      "display_type": "number"
    },
    {
      "trait_type": "Marketplace Listings",
      "value": 12,
      "display_type": "number"
    },
    {
      "trait_type": "Last Persona Created",
      "value": "2026-01-11T12:00:00Z",
      "display_type": "date"
    }
  ],
  "dynamic_metadata": {
    "update_frequency": "real-time",
    "updatable_fields": ["personas_managed", "infts_exported", "marketplace_listings", "persona_metrics"]
  }
}

Future Enhancements

Evolutionary Agents

Dynamic persona evolution based on performance metrics

Marketplace feedback integration for continuous improvement

Multi-generational tracking through evolution stages

Autonomous self-improvement capabilities

Advanced Marketplace Features

Agent collaboration marketplace for multi-agent teams

Performance analytics and reputation systems

Revenue sharing for commercial agents

Cross-platform agent migration with full provenance

Enhanced A2A Protocol Features

Real-time agent discovery and capability matching

Dynamic load balancing across agent instances

Federated agent networks with autonomous coordination

Advanced authentication and security protocols

Conclusion

The enhanced AutoMINDX agent represents a significant advancement in AI persona management, creating the foundation for a thriving marketplace of intelligent, tradeable agent personas with full blockchain integration and A2A protocol compliance. This system enables the creation of an autonomous agent economy where personas can evolve, interact, and be exchanged while maintaining immutable provenance and verification through the AgenticPlace marketplace ecosystem.

---