agno 2.4.3__tar.gz → 2.4.5__tar.gz

{agno-2.4.3 → agno-2.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agno
-Version: 2.4.3
+Version: 2.4.5
 Summary: Agno: a lightweight library for building Multi-Agent Systems
 Author-email: Ashpreet Bedi <ashpreet@agno.com>
 Project-URL: homepage, https://agno.com
@@ -132,6 +132,8 @@ Provides-Extra: evm
 Requires-Dist: web3; extra == "evm"
 Provides-Extra: exa
 Requires-Dist: exa_py; extra == "exa"
+Provides-Extra: seltz
+Requires-Dist: seltz; extra == "seltz"
 Provides-Extra: fal
 Requires-Dist: fal_client; extra == "fal"
 Provides-Extra: firecrawl
@@ -308,6 +310,7 @@ Provides-Extra: tools
 Requires-Dist: agno[apify]; extra == "tools"
 Requires-Dist: agno[arxiv]; extra == "tools"
 Requires-Dist: agno[exa]; extra == "tools"
+Requires-Dist: agno[seltz]; extra == "tools"
 Requires-Dist: agno[cartesia]; extra == "tools"
 Requires-Dist: agno[ddg]; extra == "tools"
 Requires-Dist: agno[duckdb]; extra == "tools"
@@ -531,7 +534,7 @@ https://github.com/user-attachments/assets/feb23db8-15cc-4e88-be7c-01a21a03ebf6
 
 ## Getting Started
 
-1. Follow the [getting started guide](https://github.com/agno-agi/agno/tree/main/cookbook/00_getting_started)
+1. Follow the [quickstart guide](https://github.com/agno-agi/agno/tree/main/cookbook/00_quickstart)
 2. Browse the [cookbook](https://github.com/agno-agi/agno/tree/main/cookbook) for real-world examples
 3. Read the [docs](https://docs.agno.com) to go deeper
 

{agno-2.4.3 → agno-2.4.5}/README.md

@@ -98,7 +98,7 @@ https://github.com/user-attachments/assets/feb23db8-15cc-4e88-be7c-01a21a03ebf6
 
 ## Getting Started
 
-1. Follow the [getting started guide](https://github.com/agno-agi/agno/tree/main/cookbook/00_getting_started)
+1. Follow the [quickstart guide](https://github.com/agno-agi/agno/tree/main/cookbook/00_quickstart)
 2. Browse the [cookbook](https://github.com/agno-agi/agno/tree/main/cookbook) for real-world examples
 3. Read the [docs](https://docs.agno.com) to go deeper
 

{agno-2.4.3 → agno-2.4.5}/agno/agent/agent.py

@@ -320,6 +320,8 @@ class Agent:
     # Add a tool that allows the Model to search the knowledge base (aka Agentic RAG)
     # Added only if knowledge is provided.
     search_knowledge: bool = True
+    # If True, add search_knowledge instructions to the system prompt
+    add_search_knowledge_instructions: bool = True
     # Add a tool that allows the Agent to update Knowledge.
     update_knowledge: bool = False
     # Add a tool that allows the Model to get the tool call history.
@@ -524,6 +526,7 @@ class Agent:
         reasoning_max_steps: int = 10,
         read_chat_history: bool = False,
         search_knowledge: bool = True,
+        add_search_knowledge_instructions: bool = True,
         update_knowledge: bool = False,
         read_tool_call_history: bool = False,
         send_media_to_model: bool = True,
@@ -661,6 +664,7 @@ class Agent:
 
         self.read_chat_history = read_chat_history
         self.search_knowledge = search_knowledge
+        self.add_search_knowledge_instructions = add_search_knowledge_instructions
         self.update_knowledge = update_knowledge
         self.read_tool_call_history = read_tool_call_history
         self.send_media_to_model = send_media_to_model
@@ -7431,6 +7435,10 @@ class Agent:
             config["enable_agentic_knowledge_filters"] = self.enable_agentic_knowledge_filters
         if self.add_knowledge_to_context:
             config["add_knowledge_to_context"] = self.add_knowledge_to_context
+        if not self.search_knowledge:
+            config["search_knowledge"] = self.search_knowledge
+        if self.add_search_knowledge_instructions:
+            config["add_search_knowledge_instructions"] = self.add_search_knowledge_instructions
         # Skip knowledge_retriever as it's a callable
         if self.references_format != "json":
             config["references_format"] = self.references_format
@@ -7481,8 +7489,6 @@ class Agent:
         # --- Default tools settings ---
         if self.read_chat_history:
             config["read_chat_history"] = self.read_chat_history
-        if not self.search_knowledge:
-            config["search_knowledge"] = self.search_knowledge
         if self.update_knowledge:
             config["update_knowledge"] = self.update_knowledge
         if self.read_tool_call_history:
@@ -7806,6 +7812,7 @@ class Agent:
             # --- Default tools settings ---
             read_chat_history=config.get("read_chat_history", False),
             search_knowledge=config.get("search_knowledge", True),
+            add_search_knowledge_instructions=config.get("add_search_knowledge_instructions", True),
             update_knowledge=config.get("update_knowledge", False),
             read_tool_call_history=config.get("read_tool_call_history", False),
             send_media_to_model=config.get("send_media_to_model", True),
@@ -8859,16 +8866,6 @@ class Agent:
         if self.name is not None and self.add_name_to_context:
             additional_information.append(f"Your name is: {self.name}.")
 
-        # 3.2.5 Add knowledge context using protocol's build_context
-        if self.knowledge is not None:
-            build_context_fn = getattr(self.knowledge, "build_context", None)
-            if callable(build_context_fn):
-                knowledge_context = build_context_fn(
-                    enable_agentic_filters=self.enable_agentic_knowledge_filters,
-                )
-                if knowledge_context:
-                    additional_information.append(knowledge_context)
-
         # 3.3 Build the default system message for the Agent.
         system_message_content: str = ""
         # 3.3.1 First add the Agent description if provided
@@ -9045,12 +9042,22 @@ class Agent:
             if learning_context:
                 system_message_content += learning_context + "\n"
 
-        # 3.3.13 Add the system message from the Model
+        # 3.3.13 then add search_knowledge instructions to the system prompt
+        if self.knowledge is not None and self.search_knowledge and self.add_search_knowledge_instructions:
+            build_context_fn = getattr(self.knowledge, "build_context", None)
+            if callable(build_context_fn):
+                knowledge_context = build_context_fn(
+                    enable_agentic_filters=self.enable_agentic_knowledge_filters,
+                )
+                if knowledge_context is not None:
+                    system_message_content += knowledge_context + "\n"
+
+        # 3.3.14 Add the system message from the Model
         system_message_from_model = self.model.get_system_message_for_model(tools)
         if system_message_from_model is not None:
             system_message_content += system_message_from_model
 
-        # 3.3.14 Add the JSON output prompt if output_schema is provided and the model does not support native structured outputs or JSON schema outputs
+        # 3.3.15 Add the JSON output prompt if output_schema is provided and the model does not support native structured outputs or JSON schema outputs
         # or if use_json_mode is True
         if (
             output_schema is not None
@@ -9062,11 +9069,11 @@ class Agent:
         ):
             system_message_content += f"{get_json_output_prompt(output_schema)}"  # type: ignore
 
-        # 3.3.15 Add the response model format prompt if output_schema is provided (Pydantic only)
+        # 3.3.16 Add the response model format prompt if output_schema is provided (Pydantic only)
         if output_schema is not None and self.parser_model is not None and not isinstance(output_schema, dict):
             system_message_content += f"{get_response_model_format_prompt(output_schema)}"
 
-        # 3.3.16 Add the session state to the system message
+        # 3.3.17 Add the session state to the system message
         if add_session_state_to_context and session_state is not None:
             system_message_content += f"\n<session_state>\n{session_state}\n</session_state>\n\n"
 
@@ -9196,24 +9203,6 @@ class Agent:
         if self.name is not None and self.add_name_to_context:
             additional_information.append(f"Your name is: {self.name}.")
 
-        # 3.2.5 Add knowledge context using protocol's build_context (async)
-        if self.knowledge is not None:
-            # Prefer async version if available for async databases
-            abuild_context_fn = getattr(self.knowledge, "abuild_context", None)
-            build_context_fn = getattr(self.knowledge, "build_context", None)
-            if callable(abuild_context_fn):
-                knowledge_context = await abuild_context_fn(
-                    enable_agentic_filters=self.enable_agentic_knowledge_filters,
-                )
-                if knowledge_context:
-                    additional_information.append(knowledge_context)
-            elif callable(build_context_fn):
-                knowledge_context = build_context_fn(
-                    enable_agentic_filters=self.enable_agentic_knowledge_filters,
-                )
-                if knowledge_context:
-                    additional_information.append(knowledge_context)
-
         # 3.3 Build the default system message for the Agent.
         system_message_content: str = ""
         # 3.3.1 First add the Agent description if provided
@@ -9393,12 +9382,30 @@ class Agent:
             if learning_context:
                 system_message_content += learning_context + "\n"
 
-        # 3.3.13 Add the system message from the Model
+        # 3.3.13 then add search_knowledge instructions to the system prompt
+        if self.knowledge is not None and self.search_knowledge and self.add_search_knowledge_instructions:
+            # Prefer async version if available for async databases
+            abuild_context_fn = getattr(self.knowledge, "abuild_context", None)
+            build_context_fn = getattr(self.knowledge, "build_context", None)
+            if callable(abuild_context_fn):
+                knowledge_context = await abuild_context_fn(
+                    enable_agentic_filters=self.enable_agentic_knowledge_filters,
+                )
+                if knowledge_context is not None:
+                    system_message_content += knowledge_context + "\n"
+            elif callable(build_context_fn):
+                knowledge_context = build_context_fn(
+                    enable_agentic_filters=self.enable_agentic_knowledge_filters,
+                )
+                if knowledge_context is not None:
+                    system_message_content += knowledge_context + "\n"
+
+        # 3.3.14 Add the system message from the Model
         system_message_from_model = self.model.get_system_message_for_model(tools)
         if system_message_from_model is not None:
             system_message_content += system_message_from_model
 
-        # 3.3.14 Add the JSON output prompt if output_schema is provided and the model does not support native structured outputs or JSON schema outputs
+        # 3.3.15 Add the JSON output prompt if output_schema is provided and the model does not support native structured outputs or JSON schema outputs
         # or if use_json_mode is True
         if (
             output_schema is not None
@@ -9410,11 +9417,11 @@ class Agent:
         ):
             system_message_content += f"{get_json_output_prompt(output_schema)}"  # type: ignore
 
-        # 3.3.15 Add the response model format prompt if output_schema is provided (Pydantic only)
+        # 3.3.16 Add the response model format prompt if output_schema is provided (Pydantic only)
         if output_schema is not None and self.parser_model is not None and not isinstance(output_schema, dict):
             system_message_content += f"{get_response_model_format_prompt(output_schema)}"
 
-        # 3.3.16 Add the session state to the system message
+        # 3.3.17 Add the session state to the system message
         if add_session_state_to_context and session_state is not None:
             system_message_content += self._get_formatted_session_state_for_system_message(session_state)
 

{agno-2.4.3 → agno-2.4.5}/agno/db/firestore/firestore.py

@@ -1,7 +1,7 @@
 import json
 import time
 from datetime import date, datetime, timedelta, timezone
-from typing import TYPE_CHECKING, Any, Dict, List, Optional, Tuple, Union
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Tuple, Union, cast
 from uuid import uuid4
 
 if TYPE_CHECKING:
@@ -25,7 +25,7 @@ from agno.db.schemas.culture import CulturalKnowledge
 from agno.db.schemas.evals import EvalFilterType, EvalRunRecord, EvalType
 from agno.db.schemas.knowledge import KnowledgeRow
 from agno.db.schemas.memory import UserMemory
-from agno.db.utils import deserialize_session_json_fields, serialize_session_json_fields
+from agno.db.utils import deserialize_session_json_fields
 from agno.session import AgentSession, Session, TeamSession, WorkflowSession
 from agno.utils.log import log_debug, log_error, log_info
 from agno.utils.string import generate_id
@@ -496,6 +496,29 @@ class FirestoreDb(BaseDb):
             if doc_ref is None:
                 return None
 
+            # Check if session_data is stored as JSON string (legacy) or native map.
+            # Legacy sessions stored session_data as a JSON string, but Firestore's dot notation
+            # (e.g., "session_data.session_name") only works with native maps. Using dot notation
+            # on a JSON string overwrites the entire field, causing data loss.
+            # For legacy sessions, we use read-modify-write which also migrates them to native maps.
+            current_doc = doc_ref.get()
+            if not current_doc.exists:
+                return None
+
+            current_data = current_doc.to_dict()
+            session_data = current_data.get("session_data") if current_data else None
+
+            if session_data is None or isinstance(session_data, str):
+                existing_session = self.get_session(session_id, session_type, deserialize=True)
+                if existing_session is None:
+                    return None
+                existing_session = cast(Session, existing_session)
+                if existing_session.session_data is None:
+                    existing_session.session_data = {}
+                existing_session.session_data["session_name"] = session_name
+                return self.upsert_session(existing_session, deserialize=deserialize)
+
+            # Native map format - use efficient dot notation update
             doc_ref.update({"session_data.session_name": session_name, "updated_at": int(time.time())})
 
             updated_doc = doc_ref.get()
@@ -539,50 +562,50 @@ class FirestoreDb(BaseDb):
         """
         try:
             collection_ref = self._get_collection(table_type="sessions", create_collection_if_not_found=True)
-            serialized_session_dict = serialize_session_json_fields(session.to_dict())
+            session_dict = session.to_dict()
 
             if isinstance(session, AgentSession):
                 record = {
-                    "session_id": serialized_session_dict.get("session_id"),
+                    "session_id": session_dict.get("session_id"),
                     "session_type": SessionType.AGENT.value,
-                    "agent_id": serialized_session_dict.get("agent_id"),
-                    "user_id": serialized_session_dict.get("user_id"),
-                    "runs": serialized_session_dict.get("runs"),
-                    "agent_data": serialized_session_dict.get("agent_data"),
-                    "session_data": serialized_session_dict.get("session_data"),
-                    "summary": serialized_session_dict.get("summary"),
-                    "metadata": serialized_session_dict.get("metadata"),
-                    "created_at": serialized_session_dict.get("created_at"),
+                    "agent_id": session_dict.get("agent_id"),
+                    "user_id": session_dict.get("user_id"),
+                    "runs": session_dict.get("runs"),
+                    "agent_data": session_dict.get("agent_data"),
+                    "session_data": session_dict.get("session_data"),
+                    "summary": session_dict.get("summary"),
+                    "metadata": session_dict.get("metadata"),
+                    "created_at": session_dict.get("created_at"),
                     "updated_at": int(time.time()),
                 }
 
             elif isinstance(session, TeamSession):
                 record = {
-                    "session_id": serialized_session_dict.get("session_id"),
+                    "session_id": session_dict.get("session_id"),
                     "session_type": SessionType.TEAM.value,
-                    "team_id": serialized_session_dict.get("team_id"),
-                    "user_id": serialized_session_dict.get("user_id"),
-                    "runs": serialized_session_dict.get("runs"),
-                    "team_data": serialized_session_dict.get("team_data"),
-                    "session_data": serialized_session_dict.get("session_data"),
-                    "summary": serialized_session_dict.get("summary"),
-                    "metadata": serialized_session_dict.get("metadata"),
-                    "created_at": serialized_session_dict.get("created_at"),
+                    "team_id": session_dict.get("team_id"),
+                    "user_id": session_dict.get("user_id"),
+                    "runs": session_dict.get("runs"),
+                    "team_data": session_dict.get("team_data"),
+                    "session_data": session_dict.get("session_data"),
+                    "summary": session_dict.get("summary"),
+                    "metadata": session_dict.get("metadata"),
+                    "created_at": session_dict.get("created_at"),
                     "updated_at": int(time.time()),
                 }
 
             elif isinstance(session, WorkflowSession):
                 record = {
-                    "session_id": serialized_session_dict.get("session_id"),
+                    "session_id": session_dict.get("session_id"),
                     "session_type": SessionType.WORKFLOW.value,
-                    "workflow_id": serialized_session_dict.get("workflow_id"),
-                    "user_id": serialized_session_dict.get("user_id"),
-                    "runs": serialized_session_dict.get("runs"),
-                    "workflow_data": serialized_session_dict.get("workflow_data"),
-                    "session_data": serialized_session_dict.get("session_data"),
-                    "summary": serialized_session_dict.get("summary"),
-                    "metadata": serialized_session_dict.get("metadata"),
-                    "created_at": serialized_session_dict.get("created_at"),
+                    "workflow_id": session_dict.get("workflow_id"),
+                    "user_id": session_dict.get("user_id"),
+                    "runs": session_dict.get("runs"),
+                    "workflow_data": session_dict.get("workflow_data"),
+                    "session_data": session_dict.get("session_data"),
+                    "summary": session_dict.get("summary"),
+                    "metadata": session_dict.get("metadata"),
+                    "created_at": session_dict.get("created_at"),
                     "updated_at": int(time.time()),
                 }
 

{agno-2.4.3 → agno-2.4.5}/agno/db/surrealdb/models.py

@@ -292,25 +292,25 @@ def get_schema(table_type: TableType, table_name: str) -> str:
     elif table_type == "knowledge":
         return dedent(f"""
             {define_table}
-            DEFINE FIELD OVERWRITE created_at ON {table_name} TYPE datetime VALUE time::now();
+            DEFINE FIELD OVERWRITE created_at ON {table_name} TYPE datetime DEFAULT time::now();
             DEFINE FIELD OVERWRITE updated_at ON {table_name} TYPE datetime VALUE time::now();
             """)
     elif table_type == "culture":
         return dedent(f"""
             {define_table}
-            DEFINE FIELD OVERWRITE created_at ON {table_name} TYPE datetime VALUE time::now();
+            DEFINE FIELD OVERWRITE created_at ON {table_name} TYPE datetime DEFAULT time::now();
             DEFINE FIELD OVERWRITE updated_at ON {table_name} TYPE datetime VALUE time::now();
             """)
     elif table_type == "sessions":
         return dedent(f"""
             {define_table}
-            DEFINE FIELD OVERWRITE created_at ON {table_name} TYPE datetime VALUE time::now();
+            DEFINE FIELD OVERWRITE created_at ON {table_name} TYPE datetime DEFAULT time::now();
             DEFINE FIELD OVERWRITE updated_at ON {table_name} TYPE datetime VALUE time::now();
             """)
     elif table_type == "traces":
         return dedent(f"""
             {define_table}
-            DEFINE FIELD OVERWRITE created_at ON {table_name} TYPE datetime VALUE time::now();
+            DEFINE FIELD OVERWRITE created_at ON {table_name} TYPE datetime DEFAULT time::now();
             DEFINE INDEX idx_trace_id ON {table_name} FIELDS trace_id UNIQUE;
             DEFINE INDEX idx_run_id ON {table_name} FIELDS run_id;
             DEFINE INDEX idx_session_id ON {table_name} FIELDS session_id;
@@ -324,7 +324,7 @@ def get_schema(table_type: TableType, table_name: str) -> str:
     elif table_type == "spans":
         return dedent(f"""
             {define_table}
-            DEFINE FIELD OVERWRITE created_at ON {table_name} TYPE datetime VALUE time::now();
+            DEFINE FIELD OVERWRITE created_at ON {table_name} TYPE datetime DEFAULT time::now();
             DEFINE INDEX idx_span_id ON {table_name} FIELDS span_id UNIQUE;
             DEFINE INDEX idx_trace_id ON {table_name} FIELDS trace_id;
             DEFINE INDEX idx_parent_span_id ON {table_name} FIELDS parent_span_id;

{agno-2.4.3 → agno-2.4.5}/agno/db/surrealdb/surrealdb.py

@@ -287,6 +287,7 @@ class SurrealDb(BaseDb):
         where = WhereClause()
         if user_id is not None:
             where = where.and_("user_id", user_id)
+
         where_clause, where_vars = where.build()
         query = dedent(f"""
             SELECT *
@@ -295,7 +296,18 @@ class SurrealDb(BaseDb):
         """)
         vars = {"record": record, **where_vars}
         raw = self._query_one(query, vars, dict)
-        if raw is None or not deserialize:
+        if raw is None:
+            return None
+
+        # Verify session type matches
+        if session_type == SessionType.AGENT and raw.get("agent") is None:
+            return None
+        elif session_type == SessionType.TEAM and raw.get("team") is None:
+            return None
+        elif session_type == SessionType.WORKFLOW and raw.get("workflow") is None:
+            return None
+
+        if not deserialize:
             return raw
 
         return deserialize_session(session_type, raw)

{agno-2.4.3 → agno-2.4.5}/agno/knowledge/chunking/markdown.py

@@ -37,6 +37,103 @@ class MarkdownChunking(ChunkingStrategy):
             if not (1 <= split_on_headings <= 6):
                 raise ValueError("split_on_headings must be between 1 and 6 when using integer value")
 
+    def _split_large_section(self, section: str) -> List[str]:
+        """
+        Split a large section into smaller chunks while preserving the heading context.
+        Each sub-chunk will include the original heading for context.
+
+        Args:
+            section: The section content to split (may start with a heading)
+
+        Returns:
+            List of chunks, each respecting chunk_size
+        """
+        if len(section) <= self.chunk_size:
+            return [section]
+
+        # Extract heading and content from the section
+        lines = section.split("\n")
+        if lines and re.match(r"^#{1,6}\s+", lines[0]):
+            heading = lines[0]
+            content_lines = lines[1:]
+        else:
+            heading = ""
+            content_lines = lines
+
+        content = "\n".join(content_lines).strip()
+
+        # If just heading and small content, return as-is
+        if not content or len(section) <= self.chunk_size:
+            return [section]
+
+        # Split content by paragraphs
+        paragraphs = re.split(r"\n\n+", content)
+
+        chunks: List[str] = []
+        current_chunk_content: List[str] = []
+        # Account for heading size in each chunk
+        heading_size = len(heading) + 2 if heading else 0  # +2 for "\n\n"
+
+        for para in paragraphs:
+            para = para.strip()
+            if not para:
+                continue
+
+            current_size = sum(len(p) for p in current_chunk_content) + len(current_chunk_content) * 2  # \n\n
+            para_size = len(para)
+
+            # Check if adding this paragraph would exceed chunk_size
+            if current_chunk_content and (heading_size + current_size + para_size + 2) > self.chunk_size:
+                # Save current chunk
+                chunk_text = (
+                    heading + "\n\n" + "\n\n".join(current_chunk_content)
+                    if heading
+                    else "\n\n".join(current_chunk_content)
+                )
+                chunks.append(chunk_text.strip())
+                current_chunk_content = []
+
+            # If single paragraph exceeds chunk_size, split it further
+            if para_size + heading_size > self.chunk_size:
+                # Save any accumulated content first
+                if current_chunk_content:
+                    chunk_text = (
+                        heading + "\n\n" + "\n\n".join(current_chunk_content)
+                        if heading
+                        else "\n\n".join(current_chunk_content)
+                    )
+                    chunks.append(chunk_text.strip())
+                    current_chunk_content = []
+
+                # Split the large paragraph by sentences or fixed size
+                available_size = self.chunk_size - heading_size
+                words = para.split()
+                current_words: List[str] = []
+                current_word_len = 0
+
+                for word in words:
+                    if current_word_len + len(word) + 1 > available_size and current_words:
+                        chunk_text = heading + "\n\n" + " ".join(current_words) if heading else " ".join(current_words)
+                        chunks.append(chunk_text.strip())
+                        current_words = []
+                        current_word_len = 0
+                    current_words.append(word)
+                    current_word_len += len(word) + 1
+
+                if current_words:
+                    current_chunk_content.append(" ".join(current_words))
+            else:
+                current_chunk_content.append(para)
+
+        # add the remaining content
+        if current_chunk_content:
+            chunk_text = (
+                heading + "\n\n" + "\n\n".join(current_chunk_content) if heading else "\n\n".join(current_chunk_content)
+            )
+            chunks.append(chunk_text.strip())
+
+        return chunks if chunks else [section]
+
     def _split_by_headings(self, content: str) -> List[str]:
         """
         Split markdown content by headings, keeping each heading with its content.
@@ -163,18 +260,22 @@ class MarkdownChunking(ChunkingStrategy):
             section_size = len(section)
 
             # When split_on_headings is True or an int, each section becomes its own chunk
+            # But if section exceeds chunk_size, split it further
             if self.split_on_headings:
-                meta_data = chunk_meta_data.copy()
-                meta_data["chunk"] = chunk_number
-                chunk_id = None
-                if document.id:
-                    chunk_id = f"{document.id}_{chunk_number}"
-                elif document.name:
-                    chunk_id = f"{document.name}_{chunk_number}"
-                meta_data["chunk_size"] = section_size
-
-                chunks.append(Document(id=chunk_id, name=document.name, meta_data=meta_data, content=section))
-                chunk_number += 1
+                # Split large sections to respect chunk_size
+                sub_chunks = self._split_large_section(section)
+                for sub_chunk in sub_chunks:
+                    meta_data = chunk_meta_data.copy()
+                    meta_data["chunk"] = chunk_number
+                    chunk_id = None
+                    if document.id:
+                        chunk_id = f"{document.id}_{chunk_number}"
+                    elif document.name:
+                        chunk_id = f"{document.name}_{chunk_number}"
+                    meta_data["chunk_size"] = len(sub_chunk)
+
+                    chunks.append(Document(id=chunk_id, name=document.name, meta_data=meta_data, content=sub_chunk))
+                    chunk_number += 1
             elif current_size + section_size <= self.chunk_size:
                 current_chunk.append(section)
                 current_size += section_size

{agno-2.4.3 → agno-2.4.5}/agno/knowledge/knowledge.py

@@ -4451,12 +4451,10 @@ class Knowledge:
     # ========================================================================
 
     # Shared context strings
-    _KNOWLEDGE_BASE_SEARCH_INSTRUCTION = (
-        "You have access to a knowledge base.\n"
-        "IMPORTANT: For any user question that could be answered from the knowledge base, you MUST call the "
-        "search_knowledge_base tool before responding.\n"
-        "If the user question is ambiguous (e.g., 'the candidate') do NOT ask clarifying questions first—search the "
-        "knowledge base to identify the relevant documents.\n"
+    _SEARCH_KNOWLEDGE_INSTRUCTIONS = (
+        "You have a knowledge base you can search using the search_knowledge_base tool. "
+        "Search before answering questions—don't assume you know the answer. "
+        "For ambiguous questions, search first rather than asking for clarification."
     )
 
     _AGENTIC_FILTER_INSTRUCTION_TEMPLATE = """
@@ -4499,7 +4497,7 @@ Make sure to pass the filters as [Dict[str: Any]] to the tool. FOLLOW THIS STRUC
         Returns:
             Context string to add to system prompt.
         """
-        context_parts: List[str] = [self._KNOWLEDGE_BASE_SEARCH_INSTRUCTION]
+        context_parts: List[str] = [self._SEARCH_KNOWLEDGE_INSTRUCTIONS]
 
         # Add filter instructions if agentic filters are enabled
         if enable_agentic_filters:
@@ -4507,7 +4505,7 @@ Make sure to pass the filters as [Dict[str: Any]] to the tool. FOLLOW THIS STRUC
             if valid_filters:
                 context_parts.append(self._get_agentic_filter_instructions(valid_filters))
 
-        return "\n".join(context_parts)
+        return "<knowledge_base>\n" + "\n".join(context_parts) + "\n</knowledge_base>"
 
     async def abuild_context(
         self,
@@ -4526,7 +4524,7 @@ Make sure to pass the filters as [Dict[str: Any]] to the tool. FOLLOW THIS STRUC
         Returns:
             Context string to add to system prompt.
         """
-        context_parts: List[str] = [self._KNOWLEDGE_BASE_SEARCH_INSTRUCTION]
+        context_parts: List[str] = [self._SEARCH_KNOWLEDGE_INSTRUCTIONS]
 
         # Add filter instructions if agentic filters are enabled
         if enable_agentic_filters:
@@ -4534,7 +4532,7 @@ Make sure to pass the filters as [Dict[str: Any]] to the tool. FOLLOW THIS STRUC
             if valid_filters:
                 context_parts.append(self._get_agentic_filter_instructions(valid_filters))
 
-        return "\n".join(context_parts)
+        return "<knowledge_base>\n" + "\n".join(context_parts) + "\n</knowledge_base>"
 
     def get_tools(
         self,

{agno-2.4.3 → agno-2.4.5}/agno/models/base.py

@@ -2109,6 +2109,7 @@ class Model(ABC):
                         tool_name=fc.function.name,
                         tool_args=fc.arguments,
                         requires_confirmation=True,
+                        external_execution_silent=fc.function.external_execution_silent,
                     )
                 )
 
@@ -2128,6 +2129,7 @@ class Model(ABC):
                         tool_args=fc.arguments,
                         requires_user_input=True,
                         user_input_schema=user_input_schema,
+                        external_execution_silent=fc.function.external_execution_silent,
                     )
                 )
 
@@ -2176,6 +2178,7 @@ class Model(ABC):
                         tool_name=fc.function.name,
                         tool_args=fc.arguments,
                         external_execution_required=True,
+                        external_execution_silent=fc.function.external_execution_silent,
                     )
                 )
 
@@ -2270,6 +2273,7 @@ class Model(ABC):
                         tool_name=fc.function.name,
                         tool_args=fc.arguments,
                         requires_confirmation=True,
+                        external_execution_silent=fc.function.external_execution_silent,
                     )
                 )
             # If the function requires user input, we yield a message to the user
@@ -2288,6 +2292,7 @@ class Model(ABC):
                         tool_args=fc.arguments,
                         requires_user_input=True,
                         user_input_schema=user_input_schema,
+                        external_execution_silent=fc.function.external_execution_silent,
                     )
                 )
             # If the function is from the user control flow tools, we handle it here
@@ -2340,6 +2345,7 @@ class Model(ABC):
                         tool_name=fc.function.name,
                         tool_args=fc.arguments,
                         external_execution_required=True,
+                        external_execution_silent=fc.function.external_execution_silent,
                     )
                 )