add docs.

Author: JDOxygen

docs/docs_en/api/agent/a2a_client_agent.md

@@ -64,33 +64,33 @@ The position of the class is:
 A simple usage of `A2AClientAgent` is like:
 
 ```python
-    oxy.A2AClientAgent(
-        name="remote_a2a_agent",
-        desc="An agent that communicates with an A2A server",
-        server_url="http://127.0.0.1:8082",
-    ),
+oxy.A2AClientAgent(
+    name="remote_a2a_agent",
+    desc="An agent that communicates with an A2A server",
+    server_url="http://127.0.0.1:8082",
+),
 ```
 
 For streaming mode with task polling:
 
 ```python
-    oxy.A2AClientAgent(
-        name="streaming_a2a_agent",
-        desc="Streaming A2A client",
-        server_url="http://127.0.0.1:8082",
-        streaming=True,
-        enable_task_polling=True,
-        task_poll_interval_seconds=2.0,
-        task_poll_max_wait_seconds=30.0,
-    ),
+oxy.A2AClientAgent(
+    name="streaming_a2a_agent",
+    desc="Streaming A2A client",
+    server_url="http://127.0.0.1:8082",
+    streaming=True,
+    enable_task_polling=True,
+    task_poll_interval_seconds=2.0,
+    task_poll_max_wait_seconds=30.0,
+),
 ```
 
 Or use the `minimal()` factory:
 
 ```python
-    oxy.A2AClientAgent.minimal(
-        name="quick_a2a",
-        server_url="http://127.0.0.1:8082",
-        streaming=True,
-    ),
+oxy.A2AClientAgent.minimal(
+    name="quick_a2a",
+    server_url="http://127.0.0.1:8082",
+    streaming=True,
+),
 ```

docs/docs_en/api/agent/chat_agent.md

@@ -46,17 +46,17 @@ The position of the class is:
 
 A simple usage of `ChatAgent` is like:
 ```python
-    oxy.ChatAgent(
-        name="planner_agent",
-        desc="An agent capable of making plans",
-        llm_model="default_llm",
-        prompt="""
-            For a given goal, create a simple and step-by-step executable plan. \
-            The plan should be concise, with each step being an independent and complete functional module—not an atomic function—to avoid over-fragmentation. \
-            The plan should consist of independent tasks that, if executed correctly, will lead to the correct answer. \
-            Ensure that each step is actionable and includes all necessary information for execution. \
-            The result of the final step should be the final answer. Make sure each step contains all the information required for its execution. \
-            Do not add any redundant steps, and do not skip any necessary steps.
-        """.strip(),
-    ),
+oxy.ChatAgent(
+    name="planner_agent",
+    desc="An agent capable of making plans",
+    llm_model="default_llm",
+    prompt="""
+        For a given goal, create a simple and step-by-step executable plan. \
+        The plan should be concise, with each step being an independent and complete functional module—not an atomic function—to avoid over-fragmentation. \
+        The plan should consist of independent tasks that, if executed correctly, will lead to the correct answer. \
+        Ensure that each step is actionable and includes all necessary information for execution. \
+        The result of the final step should be the final answer. Make sure each step contains all the information required for its execution. \
+        Do not add any redundant steps, and do not skip any necessary steps.
+    """.strip(),
+),
 ```

docs/docs_en/api/agent/parallel_agent.md

@@ -46,16 +46,16 @@ The position of the class is:
 
 A simple usage of `ParallelAgent` is like:
 ```python
-    oxy.ParallelAgent(
-        name="expert_panel",
-        llm_model="default_llm",
-        desc="Expert panel parallel evaluation",
-        permitted_tool_name_list=[
-            "tech_expert",
-            "business_expert",
-            "risk_expert",
-            "legal_expert",
-        ],
-        is_master=True,
-    ),
+oxy.ParallelAgent(
+    name="expert_panel",
+    llm_model="default_llm",
+    desc="Expert panel parallel evaluation",
+    permitted_tool_name_list=[
+        "tech_expert",
+        "business_expert",
+        "risk_expert",
+        "legal_expert",
+    ],
+    is_master=True,
+),
 ```

docs/docs_en/api/agent/plan_and_solve_agent.md

@@ -53,14 +53,14 @@ The position of the class is:
 A simple usage of `PlanAndSolveAgent` is like:
 
 ```python
-    oxy.PlanAndSolveAgent(
-        name="plan_solve_agent",
-        desc="An agent that plans and solves complex tasks",
-        llm_model="default_llm",
-        planner_agent="planner",
-        executor_agent="executor",
-        max_replan_rounds=5,
-    ),
+oxy.PlanAndSolveAgent(
+    name="plan_solve_agent",
+    desc="An agent that plans and solves complex tasks",
+    llm_model="default_llm",
+    planner_agent="planner",
+    executor_agent="executor",
+    max_replan_rounds=5,
+),
 ```
 
 Where `planner` is an agent that returns a JSON list of task steps (e.g. `["step1", "step2"]`), and `executor` is an agent that executes each individual step.

docs/docs_en/api/agent/rag_agent.md

@@ -52,15 +52,15 @@ The position of the class is:
 A simple usage of `RAGAgent` is like:
 
 ```python
-    async def retrieve_knowledge(oxy_request):
-        query = oxy_request.get_query()
-        # Your retrieval logic here (e.g., vector DB search)
-        return "Retrieved context: ..."
-
-    oxy.RAGAgent(
-        name="rag_agent",
-        desc="A RAG-powered assistant",
-        llm_model="default_llm",
-        func_retrieve_knowledge=retrieve_knowledge,
-    ),
+async def retrieve_knowledge(oxy_request):
+    query = oxy_request.get_query()
+    # Your retrieval logic here (e.g., vector DB search)
+    return "Retrieved context: ..."
+
+oxy.RAGAgent(
+    name="rag_agent",
+    desc="A RAG-powered assistant",
+    llm_model="default_llm",
+    func_retrieve_knowledge=retrieve_knowledge,
+),
 ```

docs/docs_en/api/agent/react_agent.md

@@ -61,14 +61,14 @@ The position of the class is:
 A simple usage of `ReActAgent` is like:
 
 ```python
-    oxy.ReActAgent(
-        name="time_agent",
-        desc="A tool that can query the time",
-        tools=["time_tools"],
-        llm_model="default_llm",
-        prompt=SYSTEM_PROMPT,
-        timeout=30,
-        is_multimodal_supported=False,
-        semaphore=2
-    ),
+oxy.ReActAgent(
+    name="time_agent",
+    desc="A tool that can query the time",
+    tools=["time_tools"],
+    llm_model="default_llm",
+    prompt=SYSTEM_PROMPT,
+    timeout=30,
+    is_multimodal_supported=False,
+    semaphore=2
+),
 ```

docs/docs_en/api/agent/shell_use_agent.md

@@ -52,16 +52,16 @@ The position of the class is:
 A simple usage of `ShellUseAgent` is like:
 
 ```python
-    oxy.ShellUseAgent(
-        name="shell_agent",
-        desc="An agent that operates a remote Linux machine",
-        llm_model="default_llm",
-        prompt=SHELL_SYSTEM_PROMPT,
-        auth_info={
-            "hostname": "192.168.1.100",
-            "username": "admin",
-            "password": "password",
-        },
-        tools=["ssh_tool"],
-    ),
+oxy.ShellUseAgent(
+    name="shell_agent",
+    desc="An agent that operates a remote Linux machine",
+    llm_model="default_llm",
+    prompt=SHELL_SYSTEM_PROMPT,
+    auth_info={
+        "hostname": "192.168.1.100",
+        "username": "admin",
+        "password": "password",
+    },
+    tools=["ssh_tool"],
+),
 ```

docs/docs_en/api/agent/skill_agent.md

@@ -62,13 +62,13 @@ The position of the class is:
 A simple usage of `SkillAgent` is like:
 
 ```python
-    oxy.SkillAgent(
-        name="skill_agent",
-        desc="An agent with skill awareness",
-        llm_model="default_llm",
-        skills=["./skills/weather", "./skills/code_review"],
-        tools=["time_tools"],
-    ),
+oxy.SkillAgent(
+    name="skill_agent",
+    desc="An agent with skill awareness",
+    llm_model="default_llm",
+    skills=["./skills/weather", "./skills/code_review"],
+    tools=["time_tools"],
+),
 ```
 
 Each skill directory should contain a `SKILL.md` file with frontmatter:

docs/docs_en/api/agent/sse_oxy_agent.md

@@ -52,9 +52,9 @@ The position of the class is:
 A simple usage of `SSEOxyGent` is like:
 
 ```python
-    oxy.SSEOxyGent(
-        name="time_agent",
-        desc="An tool for time query",
-        server_url="http://127.0.0.1:8082",
-    ),
+oxy.SSEOxyGent(
+    name="time_agent",
+    desc="An tool for time query",
+    server_url="http://127.0.0.1:8082",
+),
 ```

docs/docs_en/api/agent/workflow_agent.md

@@ -50,11 +50,11 @@ The position of the class is:
 A simple usage of `WorkflowAgent` is like:
 
 ```python
-    oxy.WorkflowAgent(
-        name="workflow_agent",
-        desc="An agent for executing workflows",
-        func_workflow=my_workflow_function,
-    ),
+oxy.WorkflowAgent(
+    name="workflow_agent",
+    desc="An agent for executing workflows",
+    func_workflow=my_workflow_function,
+),
 ```
 
 Where `my_workflow_function` is a callable that defines the workflow logic to be executed by the agent.