Describes the capabilities of the function. This is used by the AI agent to determine when to call it.
OptionalpromptId?: neverNot used with description; supply one or the other.
Optionaldescription?: stringOptional inline description; when omitted, the description comes from promptId.
Id of a registered prompt that supplies this function's description, as an alternative to an inline
description. Squid's built-in connectors use this to keep tool descriptions in the central prompt
registry. The id is stored verbatim and resolved server-side — it is never resolved here in the SDK.
Options for the
@aiFunctionannotation.You must provide a
description— it tells the AI agent when to call the function. The alternativepromptIdform is an advanced option used only by Squid's built-in connectors to source the description from the central prompt registry; customer functions always usedescription.