chore: import upstream snapshot with attribution

contributing/samples/integrations/crewai_tool_kwargs/agent.py

@@ -0,0 +1,111 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample demonstrating CrewAI tool with **kwargs parameter handling.
+
+This sample shows how CrewaiTool correctly passes arbitrary parameters
+through **kwargs, which is a common pattern in CrewAI tools.
+"""
+
+from typing import Optional
+
+from crewai.tools import BaseTool
+from google.adk import Agent
+from google.adk.tools.crewai_tool import CrewaiTool
+from pydantic import BaseModel
+from pydantic import Field
+
+
+class SearchInput(BaseModel):
+  """Input schema for the search tool."""
+
+  query: str = Field(..., description="The search query string")
+  category: Optional[str] = Field(
+      None, description="Filter by category (e.g., 'technology', 'science')"
+  )
+  date_range: Optional[str] = Field(
+      None, description="Filter by date range (e.g., 'last_week', '2024')"
+  )
+  limit: Optional[int] = Field(
+      None, description="Limit the number of results (e.g., 10, 20)"
+  )
+
+
+class CustomSearchTool(BaseTool):
+  """A custom CrewAI tool that accepts arbitrary search parameters via **kwargs.
+
+  This demonstrates the key CrewAI tool pattern where tools accept
+  flexible parameters through **kwargs.
+  """
+
+  name: str = "custom_search"
+  description: str = (
+      "Search for information with flexible filtering options. "
+      "Accepts a query and optional filter parameters like category, "
+      "date_range, limit, etc."
+  )
+  args_schema: type[BaseModel] = SearchInput
+
+  def _run(self, query: str, **kwargs) -> str:
+    """Execute search with arbitrary filter parameters.
+
+    Args:
+      query: The search query string.
+      **kwargs: Additional filter parameters like category, date_range, limit.
+
+    Returns:
+      A formatted string showing the query and applied filters.
+    """
+    result_parts = [f"Searching for: '{query}'"]
+
+    if kwargs:
+      result_parts.append("Applied filters:")
+      for key, value in kwargs.items():
+        result_parts.append(f"  - {key}: {value}")
+    else:
+      result_parts.append("No additional filters applied.")
+
+    # Simulate search results
+    result_parts.append(f"\nFound 3 results matching your criteria.")
+
+    return "\n".join(result_parts)
+
+
+crewai_search_tool = CustomSearchTool()
+
+# Wrap it with ADK's CrewaiTool
+adk_search_tool = CrewaiTool(
+    crewai_search_tool,
+    name="search_with_filters",
+    description=(
+        "Search for information with optional filters like category, "
+        "date_range, or limit"
+    ),
+)
+
+root_agent = Agent(
+    name="search_agent",
+    description="An agent that can search with flexible filtering options",
+    instruction="""
+      You are a helpful search assistant.
+      When users ask you to search, use the search_with_filters tool.
+      You can pass additional parameters like:
+      - category: to filter by category (e.g., "technology", "science")
+      - date_range: to filter by date (e.g., "last_week", "2024")
+      - limit: to limit the number of results (e.g., 10, 20)
+
+      Always acknowledge what filters you're applying.
+    """,
+    tools=[adk_search_tool],
+)