Improved tool documentation, explicit field for error, and error filtering · microsoft/autogen#5267

2025-01-30T13:23:24.000Z

### What feature would you like to be added? 1. Documentation currently describes only happy paths for tools. It is unclear how to deal with errors in tools. There is no mention that you can simply raise an exception. 2. The FunctionExecutionResultMessage should have a field indicating that an error was raised (Somewhat related #4725 ) 3. An option to catch only specific errors with the option to stop for others ### Why is this needed? 1. Avoids that everyone has to read the code 2. Anthropic models have an explicit field to indicate tool errors 3. Some exceptions indicate serious issues that make it useless to continue. At that point I'd like to stop.

(2 留言) (0 反應) (0 負責人)Python (58,033 star) (8,759 fork)batch import

help wantedproj-agentchatproj-core

描述

What feature would you like to be added?

Documentation currently describes only happy paths for tools. It is unclear how to deal with errors in tools. There is no mention that you can simply raise an exception.
The FunctionExecutionResultMessage should have a field indicating that an error was raised (Somewhat related #4725 )
An option to catch only specific errors with the option to stop for others

Why is this needed?

Avoids that everyone has to read the code
Anthropic models have an explicit field to indicate tool errors
Some exceptions indicate serious issues that make it useless to continue. At that point I'd like to stop.

貢獻者指南

技術棧: python
領域: documentationbackend
議題類型: feature
難度: 3
預計時間: 1-2 days
活動狀態: fresh
清晰度: clear
前置要求: Basic PythonFamiliarity with autogen toolsUnderstanding of message types
新手友善度: 60
研究方向: Focus on updating the documentation for tools to include error handling (directory: docs/). Examine the FunctionExecutionResultMessage class in autogen/messages.py or similar. Review linked issue #4725 for context on the explicit error field. Investigate how Anthropic handles tool errors for inspiration on error filtering. Implement the error field and filtering options while ensuring backward compatibility.