|
19 | 19 | from camel.memories import ( |
20 | 20 | BaseContextCreator, |
21 | 21 | ChatHistoryBlock, |
| 22 | + ChatHistoryMemory, |
22 | 23 | LongtermAgentMemory, |
23 | 24 | MemoryRecord, |
24 | 25 | VectorDBBlock, |
25 | 26 | ) |
26 | | -from camel.messages import BaseMessage |
| 27 | +from camel.messages import BaseMessage, FunctionCallingMessage |
| 28 | +from camel.storages.key_value_storages import InMemoryKeyValueStorage |
27 | 29 | from camel.types import OpenAIBackendRole, RoleType |
28 | 30 |
|
29 | 31 |
|
@@ -121,3 +123,201 @@ def test_clear( |
121 | 123 | memory.clear() |
122 | 124 | mock_chat_history_block.clear.assert_called_once() |
123 | 125 | mock_vector_db_block.clear.assert_called_once() |
| 126 | + |
| 127 | + |
| 128 | +class TestChatHistoryMemoryCleanToolCalls: |
| 129 | + @pytest.fixture |
| 130 | + def mock_context_creator(self): |
| 131 | + creator = MagicMock(spec=BaseContextCreator) |
| 132 | + creator.create_context.return_value = ([], 0) |
| 133 | + return creator |
| 134 | + |
| 135 | + def test_clean_tool_calls_removes_function_messages( |
| 136 | + self, mock_context_creator |
| 137 | + ): |
| 138 | + r"""Test that clean_tool_calls removes FUNCTION role messages.""" |
| 139 | + storage = InMemoryKeyValueStorage() |
| 140 | + memory = ChatHistoryMemory(mock_context_creator, storage=storage) |
| 141 | + |
| 142 | + # Create records with FUNCTION messages |
| 143 | + records = [ |
| 144 | + MemoryRecord( |
| 145 | + message=BaseMessage("user", RoleType.USER, None, "Question"), |
| 146 | + role_at_backend=OpenAIBackendRole.USER, |
| 147 | + ), |
| 148 | + MemoryRecord( |
| 149 | + message=FunctionCallingMessage( |
| 150 | + "assistant", |
| 151 | + RoleType.ASSISTANT, |
| 152 | + None, |
| 153 | + "", |
| 154 | + func_name="tool", |
| 155 | + result="result", |
| 156 | + ), |
| 157 | + role_at_backend=OpenAIBackendRole.FUNCTION, |
| 158 | + ), |
| 159 | + ] |
| 160 | + memory.write_records(records) |
| 161 | + |
| 162 | + memory.clean_tool_calls() |
| 163 | + remaining = memory.retrieve() |
| 164 | + |
| 165 | + assert len(remaining) == 1 |
| 166 | + assert ( |
| 167 | + remaining[0].memory_record.role_at_backend |
| 168 | + == OpenAIBackendRole.USER |
| 169 | + ) |
| 170 | + |
| 171 | + def test_clean_tool_calls_removes_assistant_with_tool_calls( |
| 172 | + self, mock_context_creator |
| 173 | + ): |
| 174 | + r"""Test that clean_tool_calls removes ASSISTANT messages with tool |
| 175 | + calls. |
| 176 | + """ |
| 177 | + storage = InMemoryKeyValueStorage() |
| 178 | + memory = ChatHistoryMemory(mock_context_creator, storage=storage) |
| 179 | + |
| 180 | + records = [ |
| 181 | + MemoryRecord( |
| 182 | + message=BaseMessage("user", RoleType.USER, None, "Question"), |
| 183 | + role_at_backend=OpenAIBackendRole.USER, |
| 184 | + ), |
| 185 | + # Assistant with tool call (has args) |
| 186 | + MemoryRecord( |
| 187 | + message=FunctionCallingMessage( |
| 188 | + "assistant", |
| 189 | + RoleType.ASSISTANT, |
| 190 | + None, |
| 191 | + "", |
| 192 | + func_name="add", |
| 193 | + args={"a": 1, "b": 2}, |
| 194 | + tool_call_id="call_123", |
| 195 | + ), |
| 196 | + role_at_backend=OpenAIBackendRole.ASSISTANT, |
| 197 | + ), |
| 198 | + # Function result |
| 199 | + MemoryRecord( |
| 200 | + message=FunctionCallingMessage( |
| 201 | + "function", |
| 202 | + RoleType.ASSISTANT, |
| 203 | + None, |
| 204 | + "", |
| 205 | + func_name="add", |
| 206 | + result="3", |
| 207 | + tool_call_id="call_123", |
| 208 | + ), |
| 209 | + role_at_backend=OpenAIBackendRole.FUNCTION, |
| 210 | + ), |
| 211 | + # Final assistant response (should be kept) |
| 212 | + MemoryRecord( |
| 213 | + message=BaseMessage( |
| 214 | + "assistant", RoleType.ASSISTANT, None, "Answer" |
| 215 | + ), |
| 216 | + role_at_backend=OpenAIBackendRole.ASSISTANT, |
| 217 | + ), |
| 218 | + ] |
| 219 | + memory.write_records(records) |
| 220 | + |
| 221 | + memory.clean_tool_calls() |
| 222 | + remaining = memory.retrieve() |
| 223 | + |
| 224 | + # Should only have USER and final ASSISTANT |
| 225 | + assert len(remaining) == 2 |
| 226 | + assert ( |
| 227 | + remaining[0].memory_record.role_at_backend |
| 228 | + == OpenAIBackendRole.USER |
| 229 | + ) |
| 230 | + assert ( |
| 231 | + remaining[1].memory_record.role_at_backend |
| 232 | + == OpenAIBackendRole.ASSISTANT |
| 233 | + ) |
| 234 | + assert remaining[1].memory_record.message.content == "Answer" |
| 235 | + |
| 236 | + def test_clean_tool_calls_handles_multiple_tool_calls( |
| 237 | + self, mock_context_creator |
| 238 | + ): |
| 239 | + r"""Test clean_tool_calls with multiple tool call sequences.""" |
| 240 | + storage = InMemoryKeyValueStorage() |
| 241 | + memory = ChatHistoryMemory(mock_context_creator, storage=storage) |
| 242 | + |
| 243 | + records = [ |
| 244 | + MemoryRecord( |
| 245 | + message=BaseMessage("user", RoleType.USER, None, "Q1"), |
| 246 | + role_at_backend=OpenAIBackendRole.USER, |
| 247 | + ), |
| 248 | + MemoryRecord( |
| 249 | + message=FunctionCallingMessage( |
| 250 | + "assistant", |
| 251 | + RoleType.ASSISTANT, |
| 252 | + None, |
| 253 | + "", |
| 254 | + func_name="tool1", |
| 255 | + args={"x": 1}, |
| 256 | + ), |
| 257 | + role_at_backend=OpenAIBackendRole.ASSISTANT, |
| 258 | + ), |
| 259 | + MemoryRecord( |
| 260 | + message=FunctionCallingMessage( |
| 261 | + "function", |
| 262 | + RoleType.ASSISTANT, |
| 263 | + None, |
| 264 | + "", |
| 265 | + func_name="tool1", |
| 266 | + result="R1", |
| 267 | + ), |
| 268 | + role_at_backend=OpenAIBackendRole.FUNCTION, |
| 269 | + ), |
| 270 | + MemoryRecord( |
| 271 | + message=BaseMessage( |
| 272 | + "assistant", RoleType.ASSISTANT, None, "A1" |
| 273 | + ), |
| 274 | + role_at_backend=OpenAIBackendRole.ASSISTANT, |
| 275 | + ), |
| 276 | + MemoryRecord( |
| 277 | + message=BaseMessage("user", RoleType.USER, None, "Q2"), |
| 278 | + role_at_backend=OpenAIBackendRole.USER, |
| 279 | + ), |
| 280 | + MemoryRecord( |
| 281 | + message=FunctionCallingMessage( |
| 282 | + "assistant", |
| 283 | + RoleType.ASSISTANT, |
| 284 | + None, |
| 285 | + "", |
| 286 | + func_name="tool2", |
| 287 | + args={"y": 2}, |
| 288 | + ), |
| 289 | + role_at_backend=OpenAIBackendRole.ASSISTANT, |
| 290 | + ), |
| 291 | + MemoryRecord( |
| 292 | + message=FunctionCallingMessage( |
| 293 | + "function", |
| 294 | + RoleType.ASSISTANT, |
| 295 | + None, |
| 296 | + "", |
| 297 | + func_name="tool2", |
| 298 | + result="R2", |
| 299 | + ), |
| 300 | + role_at_backend=OpenAIBackendRole.FUNCTION, |
| 301 | + ), |
| 302 | + MemoryRecord( |
| 303 | + message=BaseMessage( |
| 304 | + "assistant", RoleType.ASSISTANT, None, "A2" |
| 305 | + ), |
| 306 | + role_at_backend=OpenAIBackendRole.ASSISTANT, |
| 307 | + ), |
| 308 | + ] |
| 309 | + memory.write_records(records) |
| 310 | + |
| 311 | + memory.clean_tool_calls() |
| 312 | + remaining = memory.retrieve() |
| 313 | + |
| 314 | + # Should only have: USER, ASSISTANT, USER, ASSISTANT |
| 315 | + assert len(remaining) == 4 |
| 316 | + expected_roles = [ |
| 317 | + OpenAIBackendRole.USER, |
| 318 | + OpenAIBackendRole.ASSISTANT, |
| 319 | + OpenAIBackendRole.USER, |
| 320 | + OpenAIBackendRole.ASSISTANT, |
| 321 | + ] |
| 322 | + actual_roles = [r.memory_record.role_at_backend for r in remaining] |
| 323 | + assert actual_roles == expected_roles |
0 commit comments