import os
from syllable_sdk import SyllableSDK
from syllable_sdk.utils import parse_datetime
with SyllableSDK(
api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:
res = ss_client.insights.workflows.create(request={
"name": "summary-workflow",
"source": "agent",
"description": "Default workflow - generates a summary of the call",
"insight_tool_ids": [
1,
],
"conditions": {
"min_duration": 120,
"max_duration": 600,
"sample_rate": 0.1,
"agent_list": [
866324,
826325,
],
"prompt_list": [
"123324",
],
"folder_list": [
16754,
67535,
],
"sheet_info": {
"sheet_id": "1AGOCYz05AZYYOMzow2EYlgdDXSXaWIhyA3-zCxBm4go",
"sheet_name": "Q1 Sales Data",
},
},
"start_datetime": parse_datetime("2025-08-13T00:00:00Z"),
"end_datetime": parse_datetime("2025-08-14T00:00:00Z"),
})
# Handle response
print(res)
{
"name": "summary-workflow",
"source": "agent",
"description": "Default workflow - generates a summary of the call",
"insight_tool_ids": [
1
],
"conditions": {
"min_duration": 120,
"max_duration": 600,
"sample_rate": 0.1,
"agent_list": [
866324,
826325
],
"prompt_list": [
"123324"
],
"folder_list": [
16754,
67535
],
"sheet_info": {
"sheet_id": "1AGOCYz05AZYYOMzow2EYlgdDXSXaWIhyA3-zCxBm4go",
"sheet_name": "Q1 Sales Data"
}
},
"start_datetime": "2025-08-13T00:00:00Z",
"end_datetime": "2025-08-14T00:00:00Z",
"id": 1,
"insight_tools": [
{
"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-13T00:00:00Z",
"updated_at": "2025-08-14T00:00:00Z",
"last_updated_by": "user@email.com"
}
],
"status": "ACTIVE",
"estimate": {
"backfill_count": 100,
"backfill_duration": 1000,
"estimated_daily_count": 10,
"estimated_daily_duration": "3674.11",
"estimated_daily_cost": "45.25",
"estimated_backfill_cost": "4561.00"
},
"queue_count": 10,
"created_at": "2025-08-13T00:00:00Z",
"updated_at": "2025-08-14T00:00:00Z",
"last_updated_by": "user@email.com"
}
Create a new tool in the insights
import os
from syllable_sdk import SyllableSDK
from syllable_sdk.utils import parse_datetime
with SyllableSDK(
api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:
res = ss_client.insights.workflows.create(request={
"name": "summary-workflow",
"source": "agent",
"description": "Default workflow - generates a summary of the call",
"insight_tool_ids": [
1,
],
"conditions": {
"min_duration": 120,
"max_duration": 600,
"sample_rate": 0.1,
"agent_list": [
866324,
826325,
],
"prompt_list": [
"123324",
],
"folder_list": [
16754,
67535,
],
"sheet_info": {
"sheet_id": "1AGOCYz05AZYYOMzow2EYlgdDXSXaWIhyA3-zCxBm4go",
"sheet_name": "Q1 Sales Data",
},
},
"start_datetime": parse_datetime("2025-08-13T00:00:00Z"),
"end_datetime": parse_datetime("2025-08-14T00:00:00Z"),
})
# Handle response
print(res)
{
"name": "summary-workflow",
"source": "agent",
"description": "Default workflow - generates a summary of the call",
"insight_tool_ids": [
1
],
"conditions": {
"min_duration": 120,
"max_duration": 600,
"sample_rate": 0.1,
"agent_list": [
866324,
826325
],
"prompt_list": [
"123324"
],
"folder_list": [
16754,
67535
],
"sheet_info": {
"sheet_id": "1AGOCYz05AZYYOMzow2EYlgdDXSXaWIhyA3-zCxBm4go",
"sheet_name": "Q1 Sales Data"
}
},
"start_datetime": "2025-08-13T00:00:00Z",
"end_datetime": "2025-08-14T00:00:00Z",
"id": 1,
"insight_tools": [
{
"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-13T00:00:00Z",
"updated_at": "2025-08-14T00:00:00Z",
"last_updated_by": "user@email.com"
}
],
"status": "ACTIVE",
"estimate": {
"backfill_count": 100,
"backfill_duration": 1000,
"estimated_daily_count": 10,
"estimated_daily_duration": "3674.11",
"estimated_daily_cost": "45.25",
"estimated_backfill_cost": "4561.00"
},
"queue_count": 10,
"created_at": "2025-08-13T00:00:00Z",
"updated_at": "2025-08-14T00:00:00Z",
"last_updated_by": "user@email.com"
}
Request model to create/update an insight workflow.
Successful Response
Response model for an insight workflow.