From c46aced8ae805126e7afc1548b41a439e4873d72 Mon Sep 17 00:00:00 2001 From: aitbc Date: Thu, 7 May 2026 10:51:20 +0200 Subject: [PATCH] Fix agent training documentation inconsistencies based on Hermes feedback - Add curriculum fields to stages 7, 8, 9 (difficulty, skill_level, depends_on, skills, objectives) - Add missing agent types to README (specialized, architect) - Fix schema inconsistency in ENVIRONMENT_SETUP.md - update example to use official training_schema.json format - Fix Stage 1 integration test - remove wallet_fund from operations, use existing operations - Make messaging_send operation optional in Stage 1 (messaging configuration is optional per ENVIRONMENT_SETUP.md) - Update scenario references in all stage files to point to correct directory (/docs/scenarios/) --- docs/agent-training/ENVIRONMENT_SETUP.md | 72 ++++++++++--------- docs/agent-training/README.md | 2 + docs/agent-training/stage1_foundation.json | 17 ++--- .../stage2_operations_mastery.json | 10 +-- docs/agent-training/stage3_ai_operations.json | 8 +-- .../stage4_marketplace_economics.json | 8 +-- .../stage5_expert_operations.json | 24 +++---- .../stage6_agent_identity_sdk.json | 4 +- .../stage7_cross_node_training.json | 18 +++++ .../stage8_advanced_agent_specialization.json | 18 +++++ .../stage9_multi_chain_architecture.json | 18 +++++ 11 files changed, 132 insertions(+), 67 deletions(-) diff --git a/docs/agent-training/ENVIRONMENT_SETUP.md b/docs/agent-training/ENVIRONMENT_SETUP.md index 581f3459..72ed9397 100644 --- a/docs/agent-training/ENVIRONMENT_SETUP.md +++ b/docs/agent-training/ENVIRONMENT_SETUP.md @@ -124,40 +124,48 @@ The training setup supports schema-driven stage execution using JSON definitions ### Stage JSON Schema +**Note:** The training stages use the official schema defined in `training_schema.json`. The schema uses an operations array with operation/parameters/expected_result/success_criteria format, not the older commands format. + +Example from `stage1_foundation.json`: ```json { - "stage": 1, - "title": "Foundation – Wallets & Accounts", - "prerequisites": [ - "AITBC node running", - "Genesis wallet funded" - ], - "commands": [ - { - "cmd": "wallet create", - "args": ["training-w1", "--password", "abc123"], - "exit_code": 0 - }, - { - "cmd": "wallet list", - "args": [], - "re": "training-w1" - }, - { - "cmd": "wallet send", - "args": ["--password", "", "genesis", "training-w1", "100"], - "exit_code": 0 - } - ], - "expected": { - "wallet_exists": { - "type": "value", - "value": true - }, - "balance": { - "type": "value", - "value": {"symbol": "AIT", "amount": 100} - } + "stage": "stage1_foundation", + "agent_type": "general", + "training_data": { + "operations": [ + { + "operation": "wallet_create", + "parameters": { + "name": "training-wallet", + "password": "training123" + }, + "expected_result": { + "status": "success", + "wallet_id": "training-wallet" + }, + "success_criteria": { + "status": "success", + "response_fields": ["wallet_id", "address"] + } + } + ] + }, + "validation": { + "exam_tests": [ + { + "test_name": "Create wallet", + "operation": "wallet_create", + "test_case": { + "name": "exam-wallet", + "password": "exam123" + }, + "expected_output": { + "status": "success", + "wallet_id": "exam-wallet" + } + } + ], + "passing_score": 80 } } ``` diff --git a/docs/agent-training/README.md b/docs/agent-training/README.md index c83732c4..70583bd8 100644 --- a/docs/agent-training/README.md +++ b/docs/agent-training/README.md @@ -29,6 +29,8 @@ The training program supports different agent types, each with specialized capab - **follower**: Agent that follows blockchain state, monitors transactions, and maintains synchronization with the network. - **wallet**: Agent focused on wallet operations, including creation, management, transaction sending, and balance queries. - **general**: Multi-purpose agent with broad capabilities across wallet, blockchain, and basic operations. +- **specialized**: Domain-specific agent with expertise in particular areas such as bounty systems, portfolio management, and knowledge graph marketing (used in Stage 8). +- **architect**: Expert agent that designs and manages multi-chain architectures, bridge protocols, and interoperability patterns (used in Stage 9). ## Training Stages diff --git a/docs/agent-training/stage1_foundation.json b/docs/agent-training/stage1_foundation.json index db71ad5f..77ef5cc9 100644 --- a/docs/agent-training/stage1_foundation.json +++ b/docs/agent-training/stage1_foundation.json @@ -18,12 +18,12 @@ "Verify service status" ], "scenarios": [ - "01_wallet_basics.md", - "02_transaction_sending.md", - "03_genesis_deployment.md", - "04_messaging_basics.md", - "05_island_creation.md", - "06_basic_trading.md" + "/docs/scenarios/01_wallet_basics.md", + "/docs/scenarios/02_transaction_sending.md", + "/docs/scenarios/03_genesis_deployment.md", + "/docs/scenarios/04_messaging_basics.md", + "/docs/scenarios/05_island_creation.md", + "/docs/scenarios/06_basic_trading.md" ], "training_data": { "prerequisites": { @@ -221,7 +221,8 @@ "success_criteria": { "status": "success", "response_fields": ["message_sent", "message_id"] - } + }, + "optional": true }, { "operation": "island_create", @@ -343,7 +344,7 @@ "integration_tests": [ { "name": "end_to_end_wallet_flow", - "operations": ["wallet_create", "wallet_fund", "wallet_send"], + "operations": ["wallet_create", "transaction_send"], "cleanup": true } ], diff --git a/docs/agent-training/stage2_operations_mastery.json b/docs/agent-training/stage2_operations_mastery.json index 67edaab3..1cc1b5fb 100644 --- a/docs/agent-training/stage2_operations_mastery.json +++ b/docs/agent-training/stage2_operations_mastery.json @@ -24,11 +24,11 @@ "Stake tokens and earn rewards" ], "scenarios": [ - "10_plugin_development.md", - "11_ipfs_storage.md", - "12_database_operations.md", - "13_mining_setup.md", - "14_staking_basics.md" + "/docs/scenarios/10_plugin_development.md", + "/docs/scenarios/11_ipfs_storage.md", + "/docs/scenarios/12_database_operations.md", + "/docs/scenarios/13_mining_setup.md", + "/docs/scenarios/14_staking_basics.md" ], "training_data": { "prerequisites": { diff --git a/docs/agent-training/stage3_ai_operations.json b/docs/agent-training/stage3_ai_operations.json index 2887209d..5e8b338a 100644 --- a/docs/agent-training/stage3_ai_operations.json +++ b/docs/agent-training/stage3_ai_operations.json @@ -22,10 +22,10 @@ "Fine-tune AI models" ], "scenarios": [ - "07_ai_job_submission.md", - "22_ai_training_agent.md", - "32_ai_power_advertiser.md", - "37_distributed_ai_training.md" + "/docs/scenarios/07_ai_job_submission.md", + "/docs/scenarios/22_ai_training_agent.md", + "/docs/scenarios/32_ai_power_advertiser.md", + "/docs/scenarios/37_distributed_ai_training.md" ], "training_data": { "operations": [ diff --git a/docs/agent-training/stage4_marketplace_economics.json b/docs/agent-training/stage4_marketplace_economics.json index 31d796f2..dac75d67 100644 --- a/docs/agent-training/stage4_marketplace_economics.json +++ b/docs/agent-training/stage4_marketplace_economics.json @@ -22,10 +22,10 @@ "Perform market analysis" ], "scenarios": [ - "08_marketplace_bidding.md", - "09_gpu_listing.md", - "21_compute_provider_agent.md", - "25_marketplace_arbitrage.md" + "/docs/scenarios/08_marketplace_bidding.md", + "/docs/scenarios/09_gpu_listing.md", + "/docs/scenarios/21_compute_provider_agent.md", + "/docs/scenarios/25_marketplace_arbitrage.md" ], "training_data": { "operations": [ diff --git a/docs/agent-training/stage5_expert_operations.json b/docs/agent-training/stage5_expert_operations.json index b190c12d..d472c5a8 100644 --- a/docs/agent-training/stage5_expert_operations.json +++ b/docs/agent-training/stage5_expert_operations.json @@ -24,18 +24,18 @@ "Bridge assets across chains" ], "scenarios": [ - "15_blockchain_monitoring.md", - "16_agent_registration.md", - "17_governance_voting.md", - "18_analytics_collection.md", - "19_security_setup.md", - "23_data_oracle_agent.md", - "28_monitoring_agent.md", - "29_plugin_marketplace_agent.md", - "30_database_service_agent.md", - "31_federation_bridge_agent.md", - "34_compliance_agent.md", - "35_edge_compute_agent.md" + "/docs/scenarios/15_blockchain_monitoring.md", + "/docs/scenarios/16_agent_registration.md", + "/docs/scenarios/17_governance_voting.md", + "/docs/scenarios/18_analytics_collection.md", + "/docs/scenarios/19_security_setup.md", + "/docs/scenarios/23_data_oracle_agent.md", + "/docs/scenarios/28_monitoring_agent.md", + "/docs/scenarios/29_plugin_marketplace_agent.md", + "/docs/scenarios/30_database_service_agent.md", + "/docs/scenarios/31_federation_bridge_agent.md", + "/docs/scenarios/34_compliance_agent.md", + "/docs/scenarios/35_edge_compute_agent.md" ], "training_data": { "operations": [ diff --git a/docs/agent-training/stage6_agent_identity_sdk.json b/docs/agent-training/stage6_agent_identity_sdk.json index 1193da3d..a7cb9fa1 100644 --- a/docs/agent-training/stage6_agent_identity_sdk.json +++ b/docs/agent-training/stage6_agent_identity_sdk.json @@ -22,8 +22,8 @@ "Manage agent swarms" ], "scenarios": [ - "16_agent_registration.md", - "24_swarm_coordinator.md" + "/docs/scenarios/16_agent_registration.md", + "/docs/scenarios/24_swarm_coordinator.md" ], "training_data": { "operations": [ diff --git a/docs/agent-training/stage7_cross_node_training.json b/docs/agent-training/stage7_cross_node_training.json index 10661378..1be80e05 100644 --- a/docs/agent-training/stage7_cross_node_training.json +++ b/docs/agent-training/stage7_cross_node_training.json @@ -1,6 +1,24 @@ { "stage": "stage7_cross_node_training", "agent_type": "coordinator", + "difficulty": "expert", + "estimated_time_minutes": 120, + "skill_level": "expert", + "depends_on": ["stage5_expert_operations", "stage6_agent_identity_sdk"], + "skills": [ + "cross_chain_operations", + "multi_node_coordination", + "distributed_consensus", + "network_topology", + "failover_handling" + ], + "objectives": [ + "Perform cross-chain transfers", + "Coordinate agents across multiple nodes", + "Implement distributed consensus", + "Understand network topology", + "Handle failover scenarios" + ], "training_data": { "operations": [ { diff --git a/docs/agent-training/stage8_advanced_agent_specialization.json b/docs/agent-training/stage8_advanced_agent_specialization.json index e0e4c042..bd688339 100644 --- a/docs/agent-training/stage8_advanced_agent_specialization.json +++ b/docs/agent-training/stage8_advanced_agent_specialization.json @@ -1,6 +1,24 @@ { "stage": "stage8_advanced_agent_specialization", "agent_type": "specialized", + "difficulty": "expert", + "estimated_time_minutes": 90, + "skill_level": "expert", + "depends_on": ["stage7_cross_node_training"], + "skills": [ + "bounty_system_management", + "portfolio_management", + "knowledge_graph_marketing", + "domain_specialization", + "custom_skill_development" + ], + "objectives": [ + "Create and manage bounty systems", + "Manage investment portfolios", + "Market knowledge graphs", + "Develop domain-specific capabilities", + "Create custom agent skills" + ], "training_data": { "operations": [ { diff --git a/docs/agent-training/stage9_multi_chain_architecture.json b/docs/agent-training/stage9_multi_chain_architecture.json index 35834636..71f23279 100644 --- a/docs/agent-training/stage9_multi_chain_architecture.json +++ b/docs/agent-training/stage9_multi_chain_architecture.json @@ -1,6 +1,24 @@ { "stage": "stage9_multi_chain_architecture", "agent_type": "architect", + "difficulty": "expert", + "estimated_time_minutes": 120, + "skill_level": "master", + "depends_on": ["stage7_cross_node_training", "stage8_advanced_agent_specialization"], + "skills": [ + "multi_chain_architecture", + "bridge_protocols", + "interoperability_patterns", + "multi_chain_asset_management", + "cross_chain_gossip" + ], + "objectives": [ + "Design multi-chain architectures", + "Implement bridge protocols", + "Understand interoperability patterns", + "Manage assets across chains", + "Configure cross-chain gossip protocols" + ], "training_data": { "operations": [ {