GET
/
api
/
v1
/
insights
/
tool-definitions
import os
from syllable_sdk import SyllableSDK


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:

    res = ss_client.insights.tools.insight_tool_get_definitions()

    # Handle response
    print(res)
[
  {
    "id": 1,
    "name": "llm_tool",
    "type": "<string>",
    "description": "An LLM tool evaluates a transcript with a given prompt",
    "tool_parameters": {
      "prompt": "string"
    },
    "tool_result_set": {
      "summary": "string"
    }
  }
]

Authorizations

​
Syllable-API-Key
string
header
required

Response

200 - application/json
Successful Response
​
id
integer
required

Unique ID for insight tool definition

Example:

1

​
name
string
required

Human-readable name of insight tool definition

Example:

"llm_tool"

​
type
string
required

Type of insight tool definition

​
description
string
required

Text description of insight tool definition

Example:

"An LLM tool evaluates a transcript with a given prompt"

​
tool_parameters
object
required

Parameters for tools that use this definition and their associated types

Example:
{ "prompt": "string" }
​
tool_result_set
object
required

Result key/types for insight tool definition

Example:
{ "summary": "string" }