oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 21 Packages Projects Releases Wiki Activity

Fix agent training documentation inconsistencies based on Hermes feedback

Browse Source 
- 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/)
This commit is contained in:
aitbc
2026-05-07 10:51:20 +02:00
parent 7fcc862d22
commit c46aced8ae
11 changed files with 132 additions and 67 deletions
Download Patch File Download Diff File Expand all files Collapse all files

72
docs/agent-training/ENVIRONMENT_SETUP.md
View File

@@ -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
}
}
```

2
docs/agent-training/README.md
View File

@@ -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

17
docs/agent-training/stage1_foundation.json
View File

@@ -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
}
],

10
docs/agent-training/stage2_operations_mastery.json
View File

@@ -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": {

8
docs/agent-training/stage3_ai_operations.json
View File

@@ -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": [

8
docs/agent-training/stage4_marketplace_economics.json
View File

@@ -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": [

24
docs/agent-training/stage5_expert_operations.json
View File

@@ -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": [

4
docs/agent-training/stage6_agent_identity_sdk.json
View File

@@ -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": [

18
docs/agent-training/stage7_cross_node_training.json
View File

@@ -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": [
{

18
docs/agent-training/stage8_advanced_agent_specialization.json
View File

@@ -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": [
{

18
docs/agent-training/stage9_multi_chain_architecture.json
View File

@@ -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": [
{