Framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
Lorenze/max retry defaults tools (#3362)
Lorenze Jayd6254918fd0e
diff --git a/docs/en/tools/overview.mdx b/docs/en/tools/overview.mdxindex 8d69017bb..36d926a08 100644--- a/docs/en/tools/overview.mdx+++ b/docs/en/tools/overview.mdx@@ -117,4 +117,19 @@ agent = Agent()```+## **Max Usage Count**++You can set a maximum usage count for a tool to prevent it from being used more than a certain number of times.+By default, the max usage count is unlimited.++++```python+from crewai_tools import FileReadTool++tool = FileReadTool(max_usage_count=5, ...)+```+++Ready to explore? Pick a category above to discover tools that fit your use case!diff --git a/src/crewai/tools/base_tool.py b/src/crewai/tools/base_tool.pyindex bf8d72cb3..5ddad0872 100644--- a/src/crewai/tools/base_tool.py+++ b/src/crewai/tools/base_tool.py@@ -14,12 +14,14 @@ from pydantic import BaseModel as PydanticBaseModelfrom crewai.tools.structured_tool import CrewStructuredTool+class EnvVar(BaseModel):name: strdescription: strrequired: bool = Truedefault: Optional[str] = None+class BaseTool(BaseModel, ABC):class _ArgsSchemaPlaceholder(PydanticBaseModel):pass@@ -108,7 +110,7 @@ class BaseTool(BaseModel, ABC):def to_structured_tool(self) -> CrewStructuredTool:"""Convert this tool to a CrewStructuredTool instance."""self._set_args_schema()- return CrewStructuredTool(+ structured_tool = CrewStructuredTool(name=self.name,description=self.description,args_schema=self.args_schema,@@ -117,6 +119,8 @@ class BaseTool(BaseModel, ABC):max_usage_count=self.max_usage_count,current_usage_count=self.current_usage_count,)+ structured_tool._original_tool = self+ return structured_tool@classmethoddef from_langchain(cls, tool: Any) -> "BaseTool":@@ -276,7 +280,9 @@ def to_langchain(return [t.to_structured_tool() if isinstance(t, BaseTool) else t for t in tools]-def tool(*args, result_as_answer: bool = False, max_usage_count: int | None = None) -> Callable:+def tool(+ *args, result_as_answer: bool = False, max_usage_count: int | None = None+) -> Callable:"""Decorator to create a tool from a function.diff --git a/src/crewai/tools/structured_tool.py b/src/crewai/tools/structured_tool.pyindex 22f8283aa..725031cd4 100644--- a/src/crewai/tools/structured_tool.py+++ b/src/crewai/tools/structured_tool.py@@ -10,6 +10,11 @@ from pydantic import BaseModel, Field, create_modelfrom crewai.utilities.logger import Logger+from typing import TYPE_CHECKING++if TYPE_CHECKING:+ from crewai.tools.base_tool import BaseTool+class CrewStructuredTool:"""A structured tool that can operate on any number of inputs.@@ -18,6 +23,8 @@ class CrewStructuredTool:that integrates better with CrewAI's ecosystem."""+ _original_tool: BaseTool | None = None+def __init__(self,name: str,@@ -47,6 +54,7 @@ class CrewStructuredTool:self.result_as_answer = result_as_answerself.max_usage_count = max_usage_countself.current_usage_count = current_usage_count+ self._original_tool = None# Validate the function signature matches the schemaself._validate_function_signature()@@ -219,6 +227,8 @@ class CrewStructuredTool:"""parsed_args = self._parse_args(input)+ self._increment_usage_count()+if inspect.iscoroutinefunction(self.func):return await self.func(**parsed_args, **kwargs)else:@@ -242,6 +252,8 @@ class CrewStructuredTool:"""Main method for tool execution."""parsed_args = self._parse_args(input)+ self._increment_usage_count()+if inspect.iscoroutinefunction(self.func):result = asyncio.run(self.func(**parsed_args, **kwargs))return result@@ -253,6 +265,12 @@ class CrewStructuredTool:return result+ def _increment_usage_count(self) -> None:+ """Increment the usage count."""+ self.current_usage_count += 1+ if self._original_tool is not None:+ self._original_tool.current_usage_count = self.current_usage_count+@propertydef args(self) -> dict:"""Get the tool's input arguments schema."""diff --git a/tests/cassettes/test_max_usage_count_is_respected.yaml b/tests/cassettes/test_max_usage_count_is_respected.yamlnew file mode 100644index 000000000..a2ca5a4d6--- /dev/null+++ b/tests/cassettes/test_max_usage_count_is_respected.yaml@@ -0,0 +1,845 @@+interactions:+- request:+ body: '{"messages": [{"role": "system", "content": "You are Iterating Agent. You+ are an agent that iterates a given number of times\nYour personal goal is: Call+ the iterating tool 5 times\nYou ONLY have access to the following tools, and+ should NEVER make up tools that are not listed here:\n\nTool Name: iterating_tool\nTool+ Arguments: {''input_text'': {''description'': None, ''type'': ''str''}}\nTool+ Description: A tool that iterates a given number of times\n\nIMPORTANT: Use+ the following format in your response:\n\n```\nThought: you should always think+ about what to do\nAction: the action to take, only one name of [iterating_tool],+ just the name, exactly as it''s written.\nAction Input: the input to the action,+ just a simple JSON object, enclosed in curly braces, using \" to wrap keys and+ values.\nObservation: the result of the action\n```\n\nOnce all necessary information+ is gathered, return the following format:\n\n```\nThought: I now know the final+ answer\nFinal Answer: the final answer to the original input question\n```"},+ {"role": "user", "content": "\nCurrent Task: Call the iterating tool 5 times\n\nThis+ is the expected criteria for your final answer: A list of the iterations\nyou+ MUST return the actual complete content as the final answer, not a summary.\n\nBegin!+ This is VERY important to you, use the tools available and give your best Final+ Answer, your job depends on it!\n\nThought:"}], "model": "gpt-4o", "stop": ["\nObservation:"]}'+ headers:+ accept:+ - application/json+ accept-encoding:+ - gzip, deflate, zstd+ connection:+ - keep-alive+ content-length:+ - '1452'+ content-type:+ - application/json+ host:+ - api.openai.com+ user-agent:+ - OpenAI/Python 1.93.0+ x-stainless-arch:+ - arm64+ x-stainless-async:+ - 'false'+ x-stainless-lang:+ - python+ x-stainless-os:+ - MacOS+ x-stainless-package-version:+ - 1.93.0+ x-stainless-raw-response:+ - 'true'+ x-stainless-read-timeout:+ - '600.0'+ x-stainless-retry-count:+ - '0'+ x-stainless-runtime:+ - CPython+ x-stainless-runtime-version:+ - 3.12.9+ method: POST+ uri: https://api.openai.com/v1/chat/completions+ response:+ body:+ string: !!binary |+ H4sIAAAAAAAAAwAAAP//hFPRjtMwEHzPV6z83J5ySVvu8nYCIZ1ACKSCEOSUOs4mMefYlr2Boqr/+ jpy0TQ7uxIsV7exMZmftQwTAZMUyYKLlJDqrlq837zbXn/flx6/fVPIp/fI+3ZbaxVv568ObR7YI+ DFP+QEFn1pUwnVVI0ugRFg45YVC9frVeb5I0WacD0JkKVaA1lpYrs0ziZLWMb5bx5kRsjRToWQbf+ IwCAw3AGi7rCPcsgXpwrHXrPG2TZpQmAOaNChXHvpSeuiS0mUBhNqAfXu90u19vW9E1LGdyDRqyA+ DAiuFFCLIAkdJ6kbIGPGUi2dJyDZ4VWu70SYNpv6itB3rsO9tj1lcMiZDF8F4Z5ylkHO3g4qJ5rR+ OTvOLTqse89DQrpXagZwrQ0NjCGchxNyvMShTGOdKf1fVFZLLX1bOOTe6DC6J2PZgB4jgIch9v5J+ ksw601kqyDzi8Lvk9nbUY9OiJzRdn0AyxNWsnq4Wz+gVFRKXys8WxwQXLVYTddoy7ytpZkA0m/pf+ N89pj5OPG/qv/AQIgZawKqzDSoqnE09tDsM7eKntkvJgmHl0P6XAgiS6sIkKa96r8Yoy/9sTdkUt+ dYPOOjne09oWq01Z1zHG4oZFx+gPAAAA//8DAHvlcCKwAwAA+ headers:+ CF-RAY:+ - 971b3f72effa6897-SJC+ Connection:+ - keep-alive+ Content-Encoding:+ - gzip+ Content-Type:+ - application/json+ Date:+ - Tue, 19 Aug 2025 17:07:35 GMT+ Server:+ - cloudflare+ Set-Cookie:+ - __cf_bm=6OZC5kPO9TEmVSACP2sSOZK9ZEZ5I4T_VUlfmzsoY9Y-1755623255-1.0.1.1-ek3SaNBOhXmCg7K3J7LIsE0aCrnK5YfSumHDT6nc8Df1Zh3bzMLHLDqTUwtqiG8SwxiIFXeGP4.Vt2sx9b3FCkxoyrqNpgrBL5DAffAGHm8;+ path=/; expires=Tue, 19-Aug-25 17:37:35 GMT; domain=.api.openai.com; HttpOnly;+ Secure; SameSite=None+ - _cfuvid=R_H7SrOF3QFEWePZfvxzuyKWZAt5ulsNbP28.6DC9wM-1755623255760-0.0.1.1-604800000;+ path=/; domain=.api.openai.com; HttpOnly; Secure; SameSite=None+ Strict-Transport-Security:+ - max-age=31536000; includeSubDomains; preload+ Transfer-Encoding:+ - chunked+ X-Content-Type-Options:+ - nosniff+ access-control-expose-headers:+ - X-Request-ID+ alt-svc:+ - h3=":443"; ma=86400+ cf-cache-status:+ - DYNAMIC+ openai-organization:+ - crewai-iuxna1+ openai-processing-ms:+ - '2564'+ openai-project:+ - proj_xitITlrFeen7zjNSzML82h9x+ openai-version:+ - '2020-10-01'+ x-envoy-upstream-service-time:+ - '2751'+ x-ratelimit-limit-project-tokens:+ - '30000000'+ x-ratelimit-limit-requests:+ - '10000'+ x-ratelimit-limit-tokens:+ - '30000000'+ x-ratelimit-remaining-project-tokens:+ - '29999674'+ x-ratelimit-remaining-requests:+ - '9999'+ x-ratelimit-remaining-tokens:+ - '29999674'+ x-ratelimit-reset-project-tokens:+ - 0s+ x-ratelimit-reset-requests:+ - 6ms+ x-ratelimit-reset-tokens:+ - 0s+ x-request-id:+ - req_d654df1116aa42ca8ee7d10b4b424303+ status:+ code: 200+ message: OK+- request:+ body: '{"messages": [{"role": "system", "content": "You are Iterating Agent. You+ are an agent that iterates a given number of times\nYour personal goal is: Call+ the iterating tool 5 times\nYou ONLY have access to the following tools, and+ should NEVER make up tools that are not listed here:\n\nTool Name: iterating_tool\nTool+ Arguments: {''input_text'': {''description'': None, ''type'': ''str''}}\nTool+ Description: A tool that iterates a given number of times\n\nIMPORTANT: Use+ the following format in your response:\n\n```\nThought: you should always think+ about what to do\nAction: the action to take, only one name of [iterating_tool],+ just the name, exactly as it''s written.\nAction Input: the input to the action,+ just a simple JSON object, enclosed in curly braces, using \" to wrap keys and+ values.\nObservation: the result of the action\n```\n\nOnce all necessary information+ is gathered, return the following format:\n\n```\nThought: I now know the final+ answer\nFinal Answer: the final answer to the original input question\n```"},+ {"role": "user", "content": "\nCurrent Task: Call the iterating tool 5 times\n\nThis+ is the expected criteria for your final answer: A list of the iterations\nyou+ MUST return the actual complete content as the final answer, not a summary.\n\nBegin!+ This is VERY important to you, use the tools available and give your best Final+ Answer, your job depends on it!\n\nThought:"}, {"role": "assistant", "content":+ "```\nThought: I need to call the iterating tool the first time.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"First iteration\"}\nObservation: Iteration 0: First+ iteration"}], "model": "gpt-4o", "stop": ["\nObservation:"]}'+ headers:+ accept:+ - application/json+ accept-encoding:+ - gzip, deflate, zstd+ connection:+ - keep-alive+ content-length:+ - '1673'+ content-type:+ - application/json+ cookie:+ - __cf_bm=6OZC5kPO9TEmVSACP2sSOZK9ZEZ5I4T_VUlfmzsoY9Y-1755623255-1.0.1.1-ek3SaNBOhXmCg7K3J7LIsE0aCrnK5YfSumHDT6nc8Df1Zh3bzMLHLDqTUwtqiG8SwxiIFXeGP4.Vt2sx9b3FCkxoyrqNpgrBL5DAffAGHm8;+ _cfuvid=R_H7SrOF3QFEWePZfvxzuyKWZAt5ulsNbP28.6DC9wM-1755623255760-0.0.1.1-604800000+ host:+ - api.openai.com+ user-agent:+ - OpenAI/Python 1.93.0+ x-stainless-arch:+ - arm64+ x-stainless-async:+ - 'false'+ x-stainless-lang:+ - python+ x-stainless-os:+ - MacOS+ x-stainless-package-version:+ - 1.93.0+ x-stainless-raw-response:+ - 'true'+ x-stainless-read-timeout:+ - '600.0'+ x-stainless-retry-count:+ - '0'+ x-stainless-runtime:+ - CPython+ x-stainless-runtime-version:+ - 3.12.9+ method: POST+ uri: https://api.openai.com/v1/chat/completions+ response:+ body:+ string: !!binary |+ H4sIAAAAAAAAA4RTTW/bMAy9+1cQOidFlg8v8G1LB6zosbvNhaNItK3NFjWJ7loE+e+D7CR2uw67+ CAIf3xP5SB0TAGG0yECoWrJqXTPfpffp2tWqu93u7m+Xu+3Dl6/m96+X+pB+VmIWGXT4gYovrBtF+ rWuQDdkBVh4lY1T98HGzSZer5SbtgZY0NpFWOZ6vab5cLNfzxXa+SM/EmozCIDL4ngAAHPszlmg1+ PosMFrNLpMUQZIUiuyYBCE9NjAgZggksLYvZCCqyjLaver/f5/ZbTV1VcwZ3UMsnhHMXqIFrhNL4+ wGAYvYyNgbQaLEaQwHlS52tMDajIaiCLN7n9pGJ6dmHaqmCi5hKHO+s6zuCYCxNvBeMz5yKDXDwM+ KtcXc3GaVu+x7IKM5tmuaSaAtJa4Z/S+PZ6R09Wphirn6RDeUEVprAl14VEGstGVwOREj54SgMd++ It0rk4Xz1DoumH5i/9xqvRn0xLgDE3R7BplYNtP4avaOXqGRpWnCZKZCSVWjHqnjAshOG5oAyaTr+ v6t5T3vofBjRf+VHQCl0jLpwHrVRrzse0zzGL/KvtKvLfcEioH8yCgs26OMkNJaya4btFeElMLZF+ aWyF3nkzrHDpinV6KMsFLtRWJKfkDwAAAP//AwAMYddzywMAAA==+ headers:+ CF-RAY:+ - 971b3f84cf146897-SJC+ Connection:+ - keep-alive+ Content-Encoding:+ - gzip+ Content-Type:+ - application/json+ Date:+ - Tue, 19 Aug 2025 17:07:38 GMT+ Server:+ - cloudflare+ Strict-Transport-Security:+ - max-age=31536000; includeSubDomains; preload+ Transfer-Encoding:+ - chunked+ X-Content-Type-Options:+ - nosniff+ access-control-expose-headers:+ - X-Request-ID+ alt-svc:+ - h3=":443"; ma=86400+ cf-cache-status:+ - DYNAMIC+ openai-organization:+ - crewai-iuxna1+ openai-processing-ms:+ - '1900'+ openai-project:+ - proj_xitITlrFeen7zjNSzML82h9x+ openai-version:+ - '2020-10-01'+ x-envoy-upstream-service-time:+ - '2551'+ x-ratelimit-limit-requests:+ - '10000'+ x-ratelimit-limit-tokens:+ - '30000000'+ x-ratelimit-remaining-requests:+ - '9999'+ x-ratelimit-remaining-tokens:+ - '29999629'+ x-ratelimit-reset-requests:+ - 6ms+ x-ratelimit-reset-tokens:+ - 0s+ x-request-id:+ - req_f4181fe581264993ac5c6deba4f1c287+ status:+ code: 200+ message: OK+- request:+ body: '{"messages": [{"role": "system", "content": "You are Iterating Agent. You+ are an agent that iterates a given number of times\nYour personal goal is: Call+ the iterating tool 5 times\nYou ONLY have access to the following tools, and+ should NEVER make up tools that are not listed here:\n\nTool Name: iterating_tool\nTool+ Arguments: {''input_text'': {''description'': None, ''type'': ''str''}}\nTool+ Description: A tool that iterates a given number of times\n\nIMPORTANT: Use+ the following format in your response:\n\n```\nThought: you should always think+ about what to do\nAction: the action to take, only one name of [iterating_tool],+ just the name, exactly as it''s written.\nAction Input: the input to the action,+ just a simple JSON object, enclosed in curly braces, using \" to wrap keys and+ values.\nObservation: the result of the action\n```\n\nOnce all necessary information+ is gathered, return the following format:\n\n```\nThought: I now know the final+ answer\nFinal Answer: the final answer to the original input question\n```"},+ {"role": "user", "content": "\nCurrent Task: Call the iterating tool 5 times\n\nThis+ is the expected criteria for your final answer: A list of the iterations\nyou+ MUST return the actual complete content as the final answer, not a summary.\n\nBegin!+ This is VERY important to you, use the tools available and give your best Final+ Answer, your job depends on it!\n\nThought:"}, {"role": "assistant", "content":+ "```\nThought: I need to call the iterating tool the first time.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"First iteration\"}\nObservation: Iteration 0: First+ iteration"}, {"role": "assistant", "content": "```\nThought: I have completed+ the first iteration and need to proceed to the second one.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"Second iteration\"}\nObservation: Iteration 0: Second+ iteration"}], "model": "gpt-4o", "stop": ["\nObservation:"]}'+ headers:+ accept:+ - application/json+ accept-encoding:+ - gzip, deflate, zstd+ connection:+ - keep-alive+ content-length:+ - '1922'+ content-type:+ - application/json+ cookie:+ - __cf_bm=6OZC5kPO9TEmVSACP2sSOZK9ZEZ5I4T_VUlfmzsoY9Y-1755623255-1.0.1.1-ek3SaNBOhXmCg7K3J7LIsE0aCrnK5YfSumHDT6nc8Df1Zh3bzMLHLDqTUwtqiG8SwxiIFXeGP4.Vt2sx9b3FCkxoyrqNpgrBL5DAffAGHm8;+ _cfuvid=R_H7SrOF3QFEWePZfvxzuyKWZAt5ulsNbP28.6DC9wM-1755623255760-0.0.1.1-604800000+ host:+ - api.openai.com+ user-agent:+ - OpenAI/Python 1.93.0+ x-stainless-arch:+ - arm64+ x-stainless-async:+ - 'false'+ x-stainless-lang:+ - python+ x-stainless-os:+ - MacOS+ x-stainless-package-version:+ - 1.93.0+ x-stainless-raw-response:+ - 'true'+ x-stainless-read-timeout:+ - '600.0'+ x-stainless-retry-count:+ - '0'+ x-stainless-runtime:+ - CPython+ x-stainless-runtime-version:+ - 3.12.9+ method: POST+ uri: https://api.openai.com/v1/chat/completions+ response:+ body:+ string: !!binary |+ H4sIAAAAAAAAAwAAAP//hFNNb9swDL37VxA6J0XmfCz1bRswNBh2GXrYsBSOItG2ElsUJLrIUOS/+ D7KT2N067CIIfHxP5CP1kgAIo0UGQlWSVePq6afVl9Xq9HAI3z6uj8eHz6os9OGrvt98T9sfYhIZ+ tD+g4ivrTlHjamRDtoeVR8kYVd+9Xy5X6TxdrjugIY11pJWOpwuaprN0MZ2tp7PVhViRURhEBj8T+ AICX7owlWo0nkcFsco00GIIsUWS3JADhqY4RIUMwgaVlMRlARZbRdlXvdrutfayoLSvOYAOVfEa4+ dIEauEIIqMhqMIxexs5AWg0WI0rgPKnLNeZyZbwGsni3tR9UzM6uRFvmTFRf47CxruUMXrbCxFvO+ eOKtyGArHjuR23tbcR4X77Fog4ze2bauR4C0lrhjdLY9XZDzzaiaSudpH/6gisJYE6rcowxkoymB+ yYkOPScAT91A2lceC+epcZwzHbF7bn6/6PXEsAIjdH0BmVjWQ3wxTydv6OUaWZo6jEYqlFQV6oE6+ zF+22tAISEZd/13NW9p95/2E/is/AEqhY9S586iNet3xkOYx/pB/pd1c7goWAf2zUZizQR8nobGQ+ bd0vrwi/AmOTF8aW6J03/QYXLl+s9kUxw5lai+Sc/AYAAP//AwDpY7tZygMAAA==+ headers:+ CF-RAY:+ - 971b3f958e746897-SJC+ Connection:+ - keep-alive+ Content-Encoding:+ - gzip+ Content-Type:+ - application/json+ Date:+ - Tue, 19 Aug 2025 17:07:39 GMT+ Server:+ - cloudflare+ Strict-Transport-Security:+ - max-age=31536000; includeSubDomains; preload+ Transfer-Encoding:+ - chunked+ X-Content-Type-Options:+ - nosniff+ access-control-expose-headers:+ - X-Request-ID+ alt-svc:+ - h3=":443"; ma=86400+ cf-cache-status:+ - DYNAMIC+ openai-organization:+ - crewai-iuxna1+ openai-processing-ms:+ - '890'+ openai-project:+ - proj_xitITlrFeen7zjNSzML82h9x+ openai-version:+ - '2020-10-01'+ x-envoy-upstream-service-time:+ - '906'+ x-ratelimit-limit-project-tokens:+ - '30000000'+ x-ratelimit-limit-requests:+ - '10000'+ x-ratelimit-limit-tokens:+ - '30000000'+ x-ratelimit-remaining-project-tokens:+ - '29999577'+ x-ratelimit-remaining-requests:+ - '9999'+ x-ratelimit-remaining-tokens:+ - '29999577'+ x-ratelimit-reset-project-tokens:+ - 0s+ x-ratelimit-reset-requests:+ - 6ms+ x-ratelimit-reset-tokens:+ - 0s+ x-request-id:+ - req_b3632e88268747218e4cc4cc08d87bca+ status:+ code: 200+ message: OK+- request:+ body: '{"messages": [{"role": "system", "content": "You are Iterating Agent. You+ are an agent that iterates a given number of times\nYour personal goal is: Call+ the iterating tool 5 times\nYou ONLY have access to the following tools, and+ should NEVER make up tools that are not listed here:\n\nTool Name: iterating_tool\nTool+ Arguments: {''input_text'': {''description'': None, ''type'': ''str''}}\nTool+ Description: A tool that iterates a given number of times\n\nIMPORTANT: Use+ the following format in your response:\n\n```\nThought: you should always think+ about what to do\nAction: the action to take, only one name of [iterating_tool],+ just the name, exactly as it''s written.\nAction Input: the input to the action,+ just a simple JSON object, enclosed in curly braces, using \" to wrap keys and+ values.\nObservation: the result of the action\n```\n\nOnce all necessary information+ is gathered, return the following format:\n\n```\nThought: I now know the final+ answer\nFinal Answer: the final answer to the original input question\n```"},+ {"role": "user", "content": "\nCurrent Task: Call the iterating tool 5 times\n\nThis+ is the expected criteria for your final answer: A list of the iterations\nyou+ MUST return the actual complete content as the final answer, not a summary.\n\nBegin!+ This is VERY important to you, use the tools available and give your best Final+ Answer, your job depends on it!\n\nThought:"}, {"role": "assistant", "content":+ "```\nThought: I need to call the iterating tool the first time.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"First iteration\"}\nObservation: Iteration 0: First+ iteration"}, {"role": "assistant", "content": "```\nThought: I have completed+ the first iteration and need to proceed to the second one.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"Second iteration\"}\nObservation: Iteration 0: Second+ iteration"}, {"role": "assistant", "content": "```\nThought: I have completed+ the second iteration and need to proceed to the third one.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"Third iteration\"}\nObservation: Iteration 0: Third+ iteration\n\n\nYou ONLY have access to the following tools, and should NEVER+ make up tools that are not listed here:\n\nTool Name: iterating_tool\nTool Arguments:+ {''input_text'': {''description'': None, ''type'': ''str''}}\nTool Description:+ A tool that iterates a given number of times\n\nIMPORTANT: Use the following+ format in your response:\n\n```\nThought: you should always think about what+ to do\nAction: the action to take, only one name of [iterating_tool], just the+ name, exactly as it''s written.\nAction Input: the input to the action, just+ a simple JSON object, enclosed in curly braces, using \" to wrap keys and values.\nObservation:+ the result of the action\n```\n\nOnce all necessary information is gathered,+ return the following format:\n\n```\nThought: I now know the final answer\nFinal+ Answer: the final answer to the original input question\n```"}], "model": "gpt-4o",+ "stop": ["\nObservation:"]}'+ headers:+ accept:+ - application/json+ accept-encoding:+ - gzip, deflate, zstd+ connection:+ - keep-alive+ content-length:+ - '3018'+ content-type:+ - application/json+ cookie:+ - __cf_bm=6OZC5kPO9TEmVSACP2sSOZK9ZEZ5I4T_VUlfmzsoY9Y-1755623255-1.0.1.1-ek3SaNBOhXmCg7K3J7LIsE0aCrnK5YfSumHDT6nc8Df1Zh3bzMLHLDqTUwtqiG8SwxiIFXeGP4.Vt2sx9b3FCkxoyrqNpgrBL5DAffAGHm8;+ _cfuvid=R_H7SrOF3QFEWePZfvxzuyKWZAt5ulsNbP28.6DC9wM-1755623255760-0.0.1.1-604800000+ host:+ - api.openai.com+ user-agent:+ - OpenAI/Python 1.93.0+ x-stainless-arch:+ - arm64+ x-stainless-async:+ - 'false'+ x-stainless-lang:+ - python+ x-stainless-os:+ - MacOS+ x-stainless-package-version:+ - 1.93.0+ x-stainless-raw-response:+ - 'true'+ x-stainless-read-timeout:+ - '600.0'+ x-stainless-retry-count:+ - '0'+ x-stainless-runtime:+ - CPython+ x-stainless-runtime-version:+ - 3.12.9+ method: POST+ uri: https://api.openai.com/v1/chat/completions+ response:+ body:+ string: !!binary |+ H4sIAAAAAAAAAwAAAP//hFPBbtswDL37Kwidk8JzErfxbdgwtNh1GwrMhaPItK3MFgWJLloE+fdB+ dhK7W4ddBIGP74l8pI4RgNClyECoRrLqbLv8lH5Nb8k9Hu7T5PP37f361R1Wj1us6IeVYhEYtD+g+ 4gvrRlFnW2RNZoSVQ8kYVD/cbjZpsko22wHoqMQ20GrLyzUtkzhZL+O7ZZyeiQ1phV5k8DMCADgO+ ZyjRlPgiMogXl0iH3ssaRXZNAhCO2hAR0nvtWRoWiwlUZBjNUPVut8vNt4b6uuEMHqCRzwjnLrAE+ bhC40a4EzehkaAykKcFgAAmsI3W+htSKescNkMGb3HxUIT27ME1dMFF7icODsT1ncMyFDreC8YVz+ kUEuvowq1xdzcZpX77DqvQzmmb5tZ4A0hnhgDL49nZHT1amWauto7/+gikob7ZvCofRkgiueyYoB+ PUUAT8NE+jcmC+uos1ww/cLhuTRJRz0x7cCEru7OIBPLdsZK14t39IoSWerWz2YqlFQNlhN1WgDZ+ l5pmQDTr+u9q3tMeOx9H9F/5CVAKLWNZWIelVm87ntIchi/yr7Sry0PBwqN71goL1ujCJEqsZN+O+ 2yv8q2fsikqbGp11elzhyhbrdF9VMcbqTkSn6DcAAAD//wMACjMtRssDAAA=+ headers:+ CF-RAY:+ - 971b3f9bbef86897-SJC+ Connection:+ - keep-alive+ Content-Encoding:+ - gzip+ Content-Type:+ - application/json+ Date:+ - Tue, 19 Aug 2025 17:07:40 GMT+ Server:+ - cloudflare+ Strict-Transport-Security:+ - max-age=31536000; includeSubDomains; preload+ Transfer-Encoding:+ - chunked+ X-Content-Type-Options:+ - nosniff+ access-control-expose-headers:+ - X-Request-ID+ alt-svc:+ - h3=":443"; ma=86400+ cf-cache-status:+ - DYNAMIC+ openai-organization:+ - crewai-iuxna1+ openai-processing-ms:+ - '1182'+ openai-project:+ - proj_xitITlrFeen7zjNSzML82h9x+ openai-version:+ - '2020-10-01'+ x-envoy-upstream-service-time:+ - '1208'+ x-ratelimit-limit-project-tokens:+ - '30000000'+ x-ratelimit-limit-requests:+ - '10000'+ x-ratelimit-limit-tokens:+ - '30000000'+ x-ratelimit-remaining-project-tokens:+ - '29999320'+ x-ratelimit-remaining-requests:+ - '9999'+ x-ratelimit-remaining-tokens:+ - '29999320'+ x-ratelimit-reset-project-tokens:+ - 1ms+ x-ratelimit-reset-requests:+ - 6ms+ x-ratelimit-reset-tokens:+ - 1ms+ x-request-id:+ - req_7fc641fabc634f29ae085ef176071402+ status:+ code: 200+ message: OK+- request:+ body: '{"messages": [{"role": "system", "content": "You are Iterating Agent. You+ are an agent that iterates a given number of times\nYour personal goal is: Call+ the iterating tool 5 times\nYou ONLY have access to the following tools, and+ should NEVER make up tools that are not listed here:\n\nTool Name: iterating_tool\nTool+ Arguments: {''input_text'': {''description'': None, ''type'': ''str''}}\nTool+ Description: A tool that iterates a given number of times\n\nIMPORTANT: Use+ the following format in your response:\n\n```\nThought: you should always think+ about what to do\nAction: the action to take, only one name of [iterating_tool],+ just the name, exactly as it''s written.\nAction Input: the input to the action,+ just a simple JSON object, enclosed in curly braces, using \" to wrap keys and+ values.\nObservation: the result of the action\n```\n\nOnce all necessary information+ is gathered, return the following format:\n\n```\nThought: I now know the final+ answer\nFinal Answer: the final answer to the original input question\n```"},+ {"role": "user", "content": "\nCurrent Task: Call the iterating tool 5 times\n\nThis+ is the expected criteria for your final answer: A list of the iterations\nyou+ MUST return the actual complete content as the final answer, not a summary.\n\nBegin!+ This is VERY important to you, use the tools available and give your best Final+ Answer, your job depends on it!\n\nThought:"}, {"role": "assistant", "content":+ "```\nThought: I need to call the iterating tool the first time.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"First iteration\"}\nObservation: Iteration 0: First+ iteration"}, {"role": "assistant", "content": "```\nThought: I have completed+ the first iteration and need to proceed to the second one.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"Second iteration\"}\nObservation: Iteration 0: Second+ iteration"}, {"role": "assistant", "content": "```\nThought: I have completed+ the second iteration and need to proceed to the third one.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"Third iteration\"}\nObservation: Iteration 0: Third+ iteration\n\n\nYou ONLY have access to the following tools, and should NEVER+ make up tools that are not listed here:\n\nTool Name: iterating_tool\nTool Arguments:+ {''input_text'': {''description'': None, ''type'': ''str''}}\nTool Description:+ A tool that iterates a given number of times\n\nIMPORTANT: Use the following+ format in your response:\n\n```\nThought: you should always think about what+ to do\nAction: the action to take, only one name of [iterating_tool], just the+ name, exactly as it''s written.\nAction Input: the input to the action, just+ a simple JSON object, enclosed in curly braces, using \" to wrap keys and values.\nObservation:+ the result of the action\n```\n\nOnce all necessary information is gathered,+ return the following format:\n\n```\nThought: I now know the final answer\nFinal+ Answer: the final answer to the original input question\n```"}, {"role": "assistant",+ "content": "```\nThought: I have completed the third iteration and need to proceed+ to the fourth one.\nAction: iterating_tool\nAction Input: {\"input_text\": \"Fourth+ iteration\"}\nObservation: Iteration 0: Fourth iteration"}], "model": "gpt-4o",+ "stop": ["\nObservation:"]}'+ headers:+ accept:+ - application/json+ accept-encoding:+ - gzip, deflate, zstd+ connection:+ - keep-alive+ content-length:+ - '3267'+ content-type:+ - application/json+ cookie:+ - __cf_bm=6OZC5kPO9TEmVSACP2sSOZK9ZEZ5I4T_VUlfmzsoY9Y-1755623255-1.0.1.1-ek3SaNBOhXmCg7K3J7LIsE0aCrnK5YfSumHDT6nc8Df1Zh3bzMLHLDqTUwtqiG8SwxiIFXeGP4.Vt2sx9b3FCkxoyrqNpgrBL5DAffAGHm8;+ _cfuvid=R_H7SrOF3QFEWePZfvxzuyKWZAt5ulsNbP28.6DC9wM-1755623255760-0.0.1.1-604800000+ host:+ - api.openai.com+ user-agent:+ - OpenAI/Python 1.93.0+ x-stainless-arch:+ - arm64+ x-stainless-async:+ - 'false'+ x-stainless-lang:+ - python+ x-stainless-os:+ - MacOS+ x-stainless-package-version:+ - 1.93.0+ x-stainless-raw-response:+ - 'true'+ x-stainless-read-timeout:+ - '600.0'+ x-stainless-retry-count:+ - '0'+ x-stainless-runtime:+ - CPython+ x-stainless-runtime-version:+ - 3.12.9+ method: POST+ uri: https://api.openai.com/v1/chat/completions+ response:+ body:+ string: !!binary |+ H4sIAAAAAAAAA4RTTW/bMAy9+1cQOieFmyZO5ts2bECxDwztgB3mwlFk2tZmi4JEFx2C/PdBchKn+ W4ddBIGP74l8pPYJgNCVyEGoVrLqbTd/m33INvJ+0NnnT/ff3tTZR72483eSv7xLScwCg3Y/UPGJ+ daWotx2yJjPCyqFkDKrX69UqW9wssjQCPVXYBVpjeb6k+SJdLOfpZp5mR2JLWqEXOXxPAAD28Qwl+ mgqfRA5RJkZ69F42KPJzEoBw1IWIkN5rz9KwmE2gIsNoYtXb7bYwX1sampZzuIVWPiIcu8AKuEWo+ aXDcgmZ0MnQG0lRgMKAE1pE6XmOurrkFMnhVmNcqZOcnomlKJupOcbg1duAc9oXQ4VYyPnEhcijE+ +yhyfq8Qh8viHdaDl8E7M3TdBSCNIY6MaNvDETmcjeqosY52/g+qqLXRvi0dSk8mmOKZrIjoIQF4+ iAMZnnksrKPecsn0E+Nz2Xo16olpBSb05tURZGLZTfH19XL2gl5ZIUvd+YuRCiVVi9VEneYvh0rT+ BZBcdP13NS9pj52PE/qv/AQohZaxKq3DSqvnHU9pDsMP+Vfa2eVYsPDoHrXCkjW6MIkKazl04/IK+ /8sz9mWtTYPOOj1ucG3LZbar6xRTtRHJIfkNAAD//wMANy12ZMoDAAA=+ headers:+ CF-RAY:+ - 971b3fa3ea2f6897-SJC+ Connection:+ - keep-alive+ Content-Encoding:+ - gzip+ Content-Type:+ - application/json+ Date:+ - Tue, 19 Aug 2025 17:07:41 GMT+ Server:+ - cloudflare+ Strict-Transport-Security:+ - max-age=31536000; includeSubDomains; preload+ Transfer-Encoding:+ - chunked+ X-Content-Type-Options:+ - nosniff+ access-control-expose-headers:+ - X-Request-ID+ alt-svc:+ - h3=":443"; ma=86400+ cf-cache-status:+ - DYNAMIC+ openai-organization:+ - crewai-iuxna1+ openai-processing-ms:+ - '780'+ openai-project:+ - proj_xitITlrFeen7zjNSzML82h9x+ openai-version:+ - '2020-10-01'+ x-envoy-upstream-service-time:+ - '878'+ x-ratelimit-limit-project-tokens:+ - '30000000'+ x-ratelimit-limit-requests:+ - '10000'+ x-ratelimit-limit-tokens:+ - '30000000'+ x-ratelimit-remaining-project-tokens:+ - '29999268'+ x-ratelimit-remaining-requests:+ - '9999'+ x-ratelimit-remaining-tokens:+ - '29999268'+ x-ratelimit-reset-project-tokens:+ - 1ms+ x-ratelimit-reset-requests:+ - 6ms+ x-ratelimit-reset-tokens:+ - 1ms+ x-request-id:+ - req_603a6c645bac468888838d21c64db11f+ status:+ code: 200+ message: OK+- request:+ body: '{"messages": [{"role": "system", "content": "You are Iterating Agent. You+ are an agent that iterates a given number of times\nYour personal goal is: Call+ the iterating tool 5 times\nYou ONLY have access to the following tools, and+ should NEVER make up tools that are not listed here:\n\nTool Name: iterating_tool\nTool+ Arguments: {''input_text'': {''description'': None, ''type'': ''str''}}\nTool+ Description: A tool that iterates a given number of times\n\nIMPORTANT: Use+ the following format in your response:\n\n```\nThought: you should always think+ about what to do\nAction: the action to take, only one name of [iterating_tool],+ just the name, exactly as it''s written.\nAction Input: the input to the action,+ just a simple JSON object, enclosed in curly braces, using \" to wrap keys and+ values.\nObservation: the result of the action\n```\n\nOnce all necessary information+ is gathered, return the following format:\n\n```\nThought: I now know the final+ answer\nFinal Answer: the final answer to the original input question\n```"},+ {"role": "user", "content": "\nCurrent Task: Call the iterating tool 5 times\n\nThis+ is the expected criteria for your final answer: A list of the iterations\nyou+ MUST return the actual complete content as the final answer, not a summary.\n\nBegin!+ This is VERY important to you, use the tools available and give your best Final+ Answer, your job depends on it!\n\nThought:"}, {"role": "assistant", "content":+ "```\nThought: I need to call the iterating tool the first time.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"First iteration\"}\nObservation: Iteration 0: First+ iteration"}, {"role": "assistant", "content": "```\nThought: I have completed+ the first iteration and need to proceed to the second one.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"Second iteration\"}\nObservation: Iteration 0: Second+ iteration"}, {"role": "assistant", "content": "```\nThought: I have completed+ the second iteration and need to proceed to the third one.\nAction: iterating_tool\nAction+ Input: {\"input_text\": \"Third iteration\"}\nObservation: Iteration 0: Third+ iteration\n\n\nYou ONLY have access to the following tools, and should NEVER+ make up tools that are not listed here:\n\nTool Name: iterating_tool\nTool Arguments:+ {''input_text'': {''description'': None, ''type'': ''str''}}\nTool Description:+ A tool that iterates a given number of times\n\nIMPORTANT: Use the following+ format in your response:\n\n```\nThought: you should always think about what+ to do\nAction: the action to take, only one name of [iterating_tool], just the+ name, exactly as it''s written.\nAction Input: the input to the action, just+ a simple JSON object, enclosed in curly braces, using \" to wrap keys and values.\nObservation:+ the result of the action\n```\n\nOnce all necessary information is gathered,+ return the following format:\n\n```\nThought: I now know the final answer\nFinal+ Answer: the final answer to the original input question\n```"}, {"role": "assistant",+ "content": "```\nThought: I have completed the third iteration and need to proceed+ to the fourth one.\nAction: iterating_tool\nAction Input: {\"input_text\": \"Fourth+ iteration\"}\nObservation: Iteration 0: Fourth iteration"}, {"role": "assistant",+ "content": "```\nThought: I have completed the fourth iteration and need to+ proceed to the fifth one.\nAction: iterating_tool\nAction Input: {\"input_text\":+ \"Fifth iteration\"}\nObservation: Iteration 0: Fifth iteration"}], "model":+ "gpt-4o", "stop": ["\nObservation:"]}'+ headers:+ accept:+ - application/json+ accept-encoding:+ - gzip, deflate, zstd+ connection:+ - keep-alive+ content-length:+ - '3514'+ content-type:+ - application/json+ cookie:+ - __cf_bm=6OZC5kPO9TEmVSACP2sSOZK9ZEZ5I4T_VUlfmzsoY9Y-1755623255-1.0.1.1-ek3SaNBOhXmCg7K3J7LIsE0aCrnK5YfSumHDT6nc8Df1Zh3bzMLHLDqTUwtqiG8SwxiIFXeGP4.Vt2sx9b3FCkxoyrqNpgrBL5DAffAGHm8;+ _cfuvid=R_H7SrOF3QFEWePZfvxzuyKWZAt5ulsNbP28.6DC9wM-1755623255760-0.0.1.1-604800000+ host:+ - api.openai.com+ user-agent:+ - OpenAI/Python 1.93.0+ x-stainless-arch:+ - arm64+ x-stainless-async:+ - 'false'+ x-stainless-lang:+ - python+ x-stainless-os:+ - MacOS+ x-stainless-package-version:+ - 1.93.0+ x-stainless-raw-response:+ - 'true'+ x-stainless-read-timeout:+ - '600.0'+ x-stainless-retry-count:+ - '0'+ x-stainless-runtime:+ - CPython+ x-stainless-runtime-version:+ - 3.12.9+ method: POST+ uri: https://api.openai.com/v1/chat/completions+ response:+ body:+ string: !!binary |+ H4sIAAAAAAAAA4xTy26jMBTd8xVXXpOK0IRE7KqRInVazaZZTROBY1/AU2NT26QzqvLvI0MSSNuJ+ ZsPC58E99/EeABDBSQqEVdSxupGTb8lDcne7pt8Xb/r14XX5tJiufiT1z8f944smoVfo3S9k7qS6+ YbpuJDqhVQ8zg9Shd50u5vMkvo2TuANqzVF6Wdm4yUxP4iieTaLlJEqOwkoLhpak8BwAALx3X1+i+ 4vibpBCFp5caraUlkvRMAiBGS/9CqLXCOqocCQeQaeVQdVXneb5R60q3ZeVSuIeK7hGOKZADlRLm+ IBwa6kPZm41aCUUl3Cn7hiaF5w25P6EQpbASxrpBsCEhfGA8IdOKX6WsK2GuM1a6Na66ThHFJWO7+ UXmej/tgsGgt9WNQrZQjgCqlXZ/YT2B7RA7nnktdNkbv7AcpKYQStsoMUquV7691uiEdeggAtt1s+ 24txkcbounGZ0y/Y/W4Rz3s/MmzTgM6TI+i0o3KkWk7DL/wyjo4KaUfbQRhlFfJBOqwSbbnQIyAY+ pf5czVfefXKhyv+xHwDGsHHIs8YgF+wy8UAz6I/tX7Rzl7uCiUWzFwwzJ9D4SXAsaCv7OyD2j3VY+ Z4VQJZrGiP4YiiabJbuiiDBiSxIcgr8AAAD//wMAnPTcwxUEAAA=+ headers:+ CF-RAY:+ - 971b3faa6ba46897-SJC+ Connection:+ - keep-alive+ Content-Encoding:+ - gzip+ Content-Type:+ - application/json+ Date:+ - Tue, 19 Aug 2025 17:07:43 GMT+ Server:+ - cloudflare+ Strict-Transport-Security:+ - max-age=31536000; includeSubDomains; preload+ Transfer-Encoding:+ - chunked+ X-Content-Type-Options:+ - nosniff+ access-control-expose-headers:+ - X-Request-ID+ alt-svc:+ - h3=":443"; ma=86400+ cf-cache-status:+ - DYNAMIC+ openai-organization:+ - crewai-iuxna1+ openai-processing-ms:+ - '1392'+ openai-project:+ - proj_xitITlrFeen7zjNSzML82h9x+ openai-version:+ - '2020-10-01'+ x-envoy-upstream-service-time:+ - '1841'+ x-ratelimit-limit-requests:+ - '10000'+ x-ratelimit-limit-tokens:+ - '30000000'+ x-ratelimit-remaining-requests:+ - '9999'+ x-ratelimit-remaining-tokens:+ - '29999217'+ x-ratelimit-reset-requests:+ - 6ms+ x-ratelimit-reset-tokens:+ - 1ms+ x-request-id:+ - req_19dc255cec9d4763be7d5f597c80e936+ status:+ code: 200+ message: OK+version: 1diff --git a/tests/tools/test_base_tool.py b/tests/tools/test_base_tool.pyindex b4f3d2488..0c11e1e09 100644--- a/tests/tools/test_base_tool.py+++ b/tests/tools/test_base_tool.py@@ -1,9 +1,12 @@import asyncio-import inspect-import unittest-from typing import Any, Callable, Dict, List+from typing import Callablefrom unittest.mock import patch+import pytest++from crewai.agent import Agent+from crewai.crew import Crew+from crewai.task import Taskfrom crewai.tools import BaseTool, tool@@ -111,25 +114,26 @@ def test_result_as_answer_in_tool_decorator():def my_tool_with_result_as_answer(question: str) -> str:"""This tool will return its result as the final answer."""return question-+assert my_tool_with_result_as_answer.result_as_answer is True-+converted_tool = my_tool_with_result_as_answer.to_structured_tool()assert converted_tool.result_as_answer is True-+@tool("Tool with default result_as_answer")def my_tool_with_default(question: str) -> str:"""This tool uses the default result_as_answer value."""return question-+assert my_tool_with_default.result_as_answer is False-+converted_tool = my_tool_with_default.to_structured_tool()assert converted_tool.result_as_answer is Falseclass SyncTool(BaseTool):"""Test implementation with a synchronous _run method"""+name: str = "sync_tool"description: str = "A synchronous tool for testing"@@ -140,6 +144,7 @@ class SyncTool(BaseTool):class AsyncTool(BaseTool):"""Test implementation with an asynchronous _run method"""+name: str = "async_tool"description: str = "An asynchronous tool for testing"@@ -174,7 +179,7 @@ def test_run_calls_asyncio_run_for_async_tools():"""Test that asyncio.run is called when using async tools."""async_tool = AsyncTool()- with patch('asyncio.run') as mock_run:+ with patch("asyncio.run") as mock_run:mock_run.return_value = "Processed test asynchronously"async_result = async_tool.run(input_text="test")@@ -186,9 +191,43 @@ def test_run_does_not_call_asyncio_run_for_sync_tools():"""Test that asyncio.run is NOT called when using sync tools."""sync_tool = SyncTool()- with patch('asyncio.run') as mock_run:+ with patch("asyncio.run") as mock_run:sync_result = sync_tool.run(input_text="test")mock_run.assert_not_called()assert sync_result == "Processed test synchronously"+[email protected](filter_headers=["authorization"])+def test_max_usage_count_is_respected():+ class IteratingTool(BaseTool):+ name: str = "iterating_tool"+ description: str = "A tool that iterates a given number of times"++ def _run(self, input_text: str):+ return f"Iteration {input_text}"++ tool = IteratingTool(max_usage_count=5)++ agent = Agent(+ role="Iterating Agent",+ goal="Call the iterating tool 5 times",+ backstory="You are an agent that iterates a given number of times",+ tools=[tool],+ )++ task = Task(+ description="Call the iterating tool 5 times",+ expected_output="A list of the iterations",+ agent=agent,+ )++ crew = Crew(+ agents=[agent],+ tasks=[task],+ verbose=True,+ )++ crew.kickoff()+ assert tool.max_usage_count == 5+ assert tool.current_usage_count == 5