File size: 7,667 Bytes
25732fb
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216

"""
Knowledge Agent - Autonomous knowledge state management
"""
import json
from .base_agent import BaseAgent
from knowledge_tracker import KnowledgeTracker
from agent_knowledge.rules.knowledge_rules import KnowledgeRuleEngine
from models import db, KnowledgeState
import math
from datetime import datetime, timedelta

class KnowledgeAgent(BaseAgent):
    """
    Autonomous agent responsible for:
    - Tracking knowledge evolution
    - Predicting future performance
    - Identifying knowledge gaps
    - Suggesting review topics
    """
    
    def __init__(self):
        super().__init__("KA-001", "KnowledgeAgent")
        self.tracker = KnowledgeTracker()
        self.rule_engine = KnowledgeRuleEngine()
        self.predictions_made = 0
        self.updates_performed = 0
        
    def perceive(self, student_state):
        """
        Perceive student's learning state
        """
        self.update_state("perceiving")
        self.user_id = getattr(student_state, 'user_id', None)
        self.log(f"Perceiving knowledge state for user {self.user_id}")
        
        self.topic_id = getattr(student_state, 'topic_id', None)
        
        # Get all knowledge states
        if self.user_id:
            self.knowledge_states = KnowledgeState.query.filter_by(
                user_id=self.user_id
            ).all()
        else:
            self.knowledge_states = []
            
        self.log(f"Found {len(self.knowledge_states)} knowledge states")
        
        return self
    
    def decide(self):
        """
        Autonomous decisions:
        - Which topics need review?
        - What's the optimal learning path?
        - Are there knowledge gaps?
        """
        self.update_state("deciding")
        
        # Decision 1: Apply forgetting curves
        topics_needing_review = []
        for state in self.knowledge_states:
            days_since_practice = (datetime.utcnow() - state.last_practiced).days
            
            if days_since_practice > 7 and state.knowledge_level > 0.3:
                topics_needing_review.append({
                    'topic_id': state.topic_id,
                    'days_since': days_since_practice,
                    'current_level': state.knowledge_level,
                    'priority': days_since_practice * (1 - state.knowledge_level)
                })
        
        # Sort by priority
        topics_needing_review.sort(key=lambda x: x['priority'], reverse=True)
        self.review_recommendations = topics_needing_review[:3]
        
        # Decision 2: Identify knowledge gaps
        self.knowledge_gaps = [
            state for state in self.knowledge_states
            if 0 < state.knowledge_level < 0.4
        ]
        
        # Decision 3: Predict next knowledge level
        if self.topic_id:
            self.predicted_next_level = self._predict_knowledge_growth(self.topic_id)
        else:
            self.predicted_next_level = None
        
        self.log(f"Decisions: {len(self.review_recommendations)} topics need review, "
                f"{len(self.knowledge_gaps)} knowledge gaps found")
        
        return self
    
    def _predict_knowledge_growth(self, topic_id):
        """Predict knowledge growth based on learning patterns"""
        state = KnowledgeState.query.filter_by(
            user_id=self.user_id,
            topic_id=topic_id
        ).first()
        
        if not state:
            return 0.15  # Expected growth for new topic
        
        # Predict based on practice frequency and current level
        if state.practice_count > 5:
            # Experienced learner - slower growth
            growth = 0.1 * (1 - state.knowledge_level)
        else:
            # New learner - faster initial growth
            growth = 0.15 * (1 - state.knowledge_level)
        
        predicted = min(1.0, state.knowledge_level + growth)
        self.predictions_made += 1
        
        self.log(f"Predicted knowledge growth: {state.knowledge_level:.2f}{predicted:.2f}")
        
        return predicted
    
    def act(self, user_id=None, action_type="monitoring", **kwargs):
        """
        Execute: Update knowledge states and provide recommendations
        """
        self.update_state("acting")
        
        if user_id:
            self.user_id = user_id
            
        # Dispatch based on action type
        if action_type == 'update_state':
            return self.update_knowledge_from_quiz(
                kwargs.get('topic_id'),
                kwargs.get('is_correct'),
                kwargs.get('difficulty')
            )
            
        # Default / Monitoring / get_weak_areas logic
        self.log(f"performing {action_type}...")
        
        # Apply forgetting curves to all states
        updated_states = []
        for state in self.knowledge_states:
            days_since = (datetime.utcnow() - state.last_practiced).days
            
            if days_since > 0:
                # Apply exponential forgetting
                forgetting_factor = math.exp(-0.05 * days_since)
                old_level = state.knowledge_level
                state.knowledge_level *= forgetting_factor
                
                if abs(old_level - state.knowledge_level) > 0.01:
                    updated_states.append({
                        'topic_id': state.topic_id,
                        'old_level': old_level,
                        'new_level': state.knowledge_level,
                        'decay': old_level - state.knowledge_level
                    })
                    self.updates_performed += 1
        
        # Commit updates
        if updated_states:
             db.session.commit()
        
        self.log(f"Updated {len(updated_states)} knowledge states")
        self.update_state("completed")
        
        return {
            "review_recommendations": getattr(self, 'review_recommendations', []),
            "knowledge_gaps": [
                {
                    'topic_id': gap.topic_id,
                    'level': gap.knowledge_level,
                    'confidence': gap.confidence
                }
                for gap in getattr(self, 'knowledge_gaps', [])
            ],
            "predicted_growth": getattr(self, 'predicted_next_level', None),
            "updated_states": updated_states,
            "agent": self.name,
            "timestamp": datetime.utcnow().isoformat()
        }
    
    def update_knowledge_from_quiz(self, topic_id, is_correct, difficulty):
        """
        Autonomous knowledge update based on quiz performance
        """
        self.update_state("updating")
        self.log(f"Updating knowledge for topic {topic_id}, correct={is_correct}")
        
        # Use existing tracker but with agent logging
        state = self.tracker.update_knowledge(
            self.user_id,
            topic_id,
            is_correct,
            difficulty
        )
        
        self.updates_performed += 1
        self.log(f"Knowledge updated: {state.knowledge_level:.2f}, "
                f"confidence: {state.confidence:.2f}")
        
        return {
            "new_level": state.knowledge_level,
            "confidence": state.confidence,
            "practice_count": state.practice_count,
            "agent": self.name
        }
    
    def get_statistics(self):
        """Return agent statistics"""
        return {
            "agent": self.name,
            "predictions_made": self.predictions_made,
            "updates_performed": self.updates_performed,
            "state": self.state,
            "memory_size": len(self.memory)
        }