mark agent callback as TODO

Author: BhAem

docs/content/5.tools/5.guardrail-tools.md

@@ -8,8 +8,6 @@ navigation:
 ## 概述
 
 VeADK 基于 Agent 的插件机制，提供了内容安全护栏工具 `content_safety`。该工具通过以下回调函数嵌入 Agent 的执行流程，实现多阶段内容审计：
-- Before Agent Callback
-- After Agent Callback
 - Before Model Callback
 - After Model Callback
 - Before Tool Callback
@@ -34,12 +32,11 @@ agent = Agent(
     name="robot",
     description="A robot can help user.",
     instruction="Talk with user friendly.",
-    before_agent_callback=content_safety.before_agent_callback,
-    before_model_callback=content_safety.before_model_callback,
+    # before_model_callback=content_safety.before_model_callback, # TODO
     after_model_callback=content_safety.after_model_callback,
     before_tool_callback=content_safety.before_tool_callback,
     after_tool_callback=content_safety.after_tool_callback,
-    after_agent_callback=content_safety.after_agent_callback
+    # after_agent_callback=content_safety.after_agent_callback # TODO
 )
 
 runner = Runner(agent=agent)

veadk/tools/builtin_tools/llm_shield.py

@@ -45,12 +45,10 @@ class LLMShieldPlugin(BasePlugin):
         ```python
         from veadk.tools.builtin_tools.llm_shield import content_safety
         agent = Agent(
-            before_agent_callback=content_safety.before_agent_callback,
             before_model_callback=content_safety.before_model_callback,
             after_model_callback=content_safety.after_model_callback,
             before_tool_callback=content_safety.before_tool_callback,
             after_tool_callback=content_safety.after_tool_callback,
-            after_agent_callback=content_safety.after_agent_callback
         )
         ```
     """
@@ -205,33 +203,11 @@ def _request_llm_shield(self, message: str, role: str) -> Optional[str]:
     def before_agent_callback(
         self, callback_context: CallbackContext, **kwargs
     ) -> None:
-        """
-        Callback executed before agent processing.
-
-        Currently implements no specific logic for pre-agent processing.
-
-        Args:
-            callback_context (CallbackContext): The callback execution context
-            **kwargs: Additional keyword arguments
-
-        Returns:
-            None
-        """
+        # TODO: Implement agent-level input validation and context analysis
         return None
 
     def after_agent_callback(self, callback_context: CallbackContext, **kwargs) -> None:
-        """
-        Callback executed after agent processing.
-
-        Currently implements no specific logic for post-agent processing.
-
-        Args:
-            callback_context (CallbackContext): The callback execution context
-            **kwargs: Additional keyword arguments
-
-        Returns:
-            None
-        """
+        # TODO: Implement post-agent analysis and context analysis
         return None
 
     def before_model_callback(