Get Insight Tool Definitions

Get a InsightTool by Name.

GET /api/v1/insights/tool-definitions

Python (SDK)

Python

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)

200

[
  {
    "id": 123,
    "name": "<string>",
    "type": "<string>",
    "description": "<string>",
    "tool_parameters": "<unknown>",
    "tool_result_set": "<unknown>"
  }
]

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 · any · required

Parameters for tools that use this definition and their associated types

Example:

{ "prompt": "string" }

tool_result_set · any · required

Result key/types for insight tool definition

Example:

{ "summary": "string" }