Improve `gen_ai.tool.definitions` with schema of different tool types

[JamesNK]

Area(s)

area:gen-ai

What's missing?

gen_ai.tool.definitions includes some sample JSON of a function tool. However, there is no other guidance for the JSON representation of other tool types.

AI libraries that output telemetry don't know how to represent non-function tools and skip outputting information about them. For example, the Microsoft.Extensions.AI client library only includes information about functions and just includes a type attribute for other tool types. They're waiting on more info from the semantic conventions about how to represent non-function tools.

Describe the solution you'd like

There should be a schema for this column that specifies JSON for common tool types.

Tip

_{React with 👍 to help prioritize this issue. Please use comments to provide useful context, avoiding +1 or me too, to help us triage it. Learn more here.}