Examples of tool definition and usage.

[Tyler-R-Kendrick]

Problem statement

My team wants to use prompty tool invocation, but we are having difficulty finding documentation on this feature.
We saw that you demoed tool usage around files in the build presentation; but, we didn't see how those tools were defined - or what the limitations of the template syntax were for tool invocation.

Solution Exploration

It appears that jinja2 is specified as the only supported template engine. However, the build demo shows a different template syntax for tool invocation in the yaml portion of a prompty file. The line using string interpolation and file invocation appears to be currently undocumented. It is also unclear if tools other than "file" are able to be registered (or if there are other default tools).

The line I'm referring to reads approx:

sample:
  research: ${file:research.json}

There are many open questions about this syntax. For example:

• How do tools take in multiple arguments?
• What are the restrictions for tool names (can they have dashes, spaces, etc?)
• What are the restrictions for arguments (do they support json object syntax, strings?)

No information about tool invocation was discovered in the markdown portion of the prompt file. Though jinja template syntax should be sufficient, it is uncertain how tools are loaded for execution in this scenario.

The Ask

Provide documentation to clarify how to provide built-in and custom tool invocation for both the yaml and markdown portions of the prompty file where the scenarios are currently supported.