From 7472e27bb7f1518a375684aedf54309bf5d15f1b Mon Sep 17 00:00:00 2001 From: adk-bot Date: Tue, 31 Mar 2026 18:56:26 +0000 Subject: [PATCH] docs: Document RestApiTool timeout behavior change --- docs/tools-custom/openapi-tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools-custom/openapi-tools.md b/docs/tools-custom/openapi-tools.md index ab14ea1e79..880418dc6c 100644 --- a/docs/tools-custom/openapi-tools.md +++ b/docs/tools-custom/openapi-tools.md @@ -33,7 +33,7 @@ The process involves these main steps when you use `OpenAPIToolset`: 4. **`RestApiTool` Functionality**: Each generated `RestApiTool`: * **Schema Generation**: Dynamically creates a `FunctionDeclaration` based on the operation's parameters and request body. This schema tells the LLM how to call the tool (what arguments are expected). - * **Execution**: When called by the LLM, it constructs the correct HTTP request (URL, headers, query params, body) using the arguments provided by the LLM and the details from the OpenAPI spec. It handles authentication (if configured) and executes the API call using the `requests` library. + * **Execution**: When called by the LLM, it constructs the correct HTTP request (URL, headers, query params, body) using the arguments provided by the LLM and the details from the OpenAPI spec. It handles authentication (if configured) and executes the API call using the `httpx` library. By default, `RestApiTool` executes HTTP requests with no timeout (`timeout=None`), which means the agent will wait indefinitely for a response. This accommodates long-running services, but you should be aware of the potential for the agent to hang if the external service is unresponsive. * **Response Handling**: Returns the API response (typically JSON) back to the agent flow. 5. **Authentication**: You can configure global authentication (like API keys or OAuth - see [Authentication](/adk-docs/tools/authentication/) for details) when initializing `OpenAPIToolset`. This authentication configuration is automatically applied to all generated `RestApiTool` instances.