provide a bit more info in logs when parsing api schema error

[LeoQuote]

When parse error, neither user nor admin can get decent error messages, just invalid schema, this is confusing and frustrating, adding a bit more logs could be a good start.

Description

Fixes #2914

1. print error message when there are exceptions
2. raise Exception when parse error
3. delete unused functions

Type of Change

Please delete options that are not relevant.

• New feature (non-breaking change which adds functionality)

How Has This Been Tested?

Just a bit code about logging, need no further tests

Suggested Checklist:

• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• My changes generate no new warnings
• I ran dev/reformat(backend) and cd web && npx lint-staged(frontend) to appease the lint gods
• optional I have made corresponding changes to the documentation
• optional I have added tests that prove my fix is effective or that my feature works
• optional New and existing unit tests pass locally with my changes

[Yeuoly]

Looks great! Indeed, as you said, there should be a detailed error report here, and for a further experience, I recommend add the logger here: core.tools.utils.parser.ApiBasedToolSchemaParser.auto_parser_to_tool_bundle, it tries to parse schema in 5 methods, if there is an error, try next, however, the exception was not raised, place the logger in every try could be better.

[LeoQuote]

hmm, ok, you mean even if I added this logger, the output log would still be very vague.

I think the parsing process should be seperated into several part:

1. try to identify it's yaml or json, if yaml, convert it to json. if it's neither json nor yaml, raise exception
2. parse it using openai and swagger, if there's any exception, append to the exception
3. if reached the bottom, meaning all parse failed, raise an exception contains all previous exception.

Considering the users who using this function would know a bit about there api, I'd advice support one schema only or let the user specify schema type, so the error would be much simpler, but this needs more discussion, maybe next pr or someone else do that.

[Yeuoly]

LGTM