Como configurar timeout personalizado por ferramenta no agente ADK?

[dgsecc]

Estou construindo um agente com ferramentas que demoram muito para executar. Como posso configurar timeouts personalizados por ferramenta?

Por exemplo, tenho uma ferramenta que chama uma API externa que às vezes demora mais de 30 segundos.

[klateefa]

@dgsecc Could you share more details about your setup and what behavior you’re currently seeing with long-running tools?

[aime-n]

Se entendi bem, você tem uma API que demora muito e quer que ela dê timeout, correto?
Então você pode configurar um timeout diretamente na sua chamada à API.

import asyncio
import httpx
from google.adk.tools import FunctionTool

async def consultar_api_externa(query: str) -> dict:
      try:
          async with httpx.AsyncClient(timeout=60.0) as client:
              response = await client.get("https://minha-api.com/dados", params={"q": query})
              response.raise_for_status()
              return {"status": "ok", "response": response.json()}
      except httpx.TimeoutException:
          return {"status": "failed", "response": "A API externa não respondeu no tempo limite (60s)."}
      except httpx.HTTPStatusError as e:
          return {"status": "failed", "response": f"Erro HTTP {e.response.status_code}"}

tool = FunctionTool(func=consultar_api_externa)

[surajksharma07]

@dgsecc Thanks for raising this — @aime-n's approach above (wrapping your API call with httpx.AsyncClient(timeout=60.0) inside the tool function) is the right pattern for per-tool timeouts with FunctionTool, and it should handle your >30s case without any ADK-level changes needed.

If you're on ADK v2.x and using Workflow nodes, there's also a native timeout field on FunctionNode (FunctionNode(func=your_func, timeout=60.0)) that enforces the timeout at the orchestration layer rather than inside the tool itself.

Since there's been no follow-up for 3+ weeks after @klateefa's question and @aime-n's answer, going ahead and closing this out.

Feel free to reopen if the suggestions above don't cover your specific scenario or you run into something else!