docs(agents): Update agent execution timeout documentation

[ks93]

Description

Added a note to the agents.chat() method docstring to inform users that agent execution can exceed the default 30-second timeout. The note provides guidance and an example on how to increase the client's timeout configuration to prevent potential timeout errors. This improves user experience by proactively addressing a common issue with long-running agent operations.

Checklist:

• Tests added/updated.
• Documentation updated. Documentation is generated from docstrings - these must be updated according to your change.
  If a new method has been added it should be referenced in cognite.rst in order to generate docs based on its docstring.
• The PR title follows the Conventional Commit spec.

---

[cursor]

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.79%. Comparing base (ba384ad) to head (b582229).

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #2316      +/-   ##
==========================================
- Coverage   90.80%   90.79%   -0.01%     
==========================================
  Files         168      168              
  Lines       25014    25014              
==========================================
- Hits        22714    22712       -2     
- Misses       2300     2302       +2     

Files with missing lines	Coverage Δ
cognite/client/_api/agents/agents.py	100.00% <ø> (ø)

... and 2 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[haakonvt]

I’m okay with introducing a higher timeout setting for these agent APIs that we expect to be «long running»

[ks93]

I’m okay with introducing a higher timeout setting for these agent APIs that we expect to be «long running»

That would be great @haakonvt . How would we do that?

[haakonvt]

@ks93 If you change self._post to self._do_request("POST", ...), I believe you can pass an override timeout. Then I would suggest agents API calls were appropriate get bumped to 60 sec and even accept timeout directly, timeout: int = 60