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.update(tool_id=368362, insight_tool_input={
"name": "summary-tool",
"description": "This tool uses GPT4.1 to generate a summary of the call",
"version": 1,
"tool_arguments": {
"prompt": "Provide a concise, accurate summary of the conversation's key points, focusing on the user's goal and how the agent responded",
},
"insight_tool_definition_id": 1,
})
# Handle response
print(res)
{
"name": "summary-tool",
"description": "This tool uses GPT4.1 to generate a summary of the call",
"version": 1,
"tool_arguments": "<any>",
"insight_tool_definition_id": 1,
"id": 1,
"insight_tool_definition": {
"id": 1,
"name": "llm_tool",
"type": "<string>",
"description": "An LLM tool evaluates a transcript with a given prompt",
"tool_parameters": "<any>",
"tool_result_set": "<any>"
},
"created_at": "2025-08-19T00:00:00Z",
"updated_at": "2025-08-20T00:00:00Z",
"last_updated_by": "user@email.com"
}
Update an Insights tool.
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.update(tool_id=368362, insight_tool_input={
"name": "summary-tool",
"description": "This tool uses GPT4.1 to generate a summary of the call",
"version": 1,
"tool_arguments": {
"prompt": "Provide a concise, accurate summary of the conversation's key points, focusing on the user's goal and how the agent responded",
},
"insight_tool_definition_id": 1,
})
# Handle response
print(res)
{
"name": "summary-tool",
"description": "This tool uses GPT4.1 to generate a summary of the call",
"version": 1,
"tool_arguments": "<any>",
"insight_tool_definition_id": 1,
"id": 1,
"insight_tool_definition": {
"id": 1,
"name": "llm_tool",
"type": "<string>",
"description": "An LLM tool evaluates a transcript with a given prompt",
"tool_parameters": "<any>",
"tool_result_set": "<any>"
},
"created_at": "2025-08-19T00:00:00Z",
"updated_at": "2025-08-20T00:00:00Z",
"last_updated_by": "user@email.com"
}
Request model to create/update an insight tool configuration.
Successful Response
Response model for an insight tool configuration.