insights.tools
Create Insight Tool Configuration
agents
channels.twilio.numbers
agents.test
conversations
data_sources
events
incidents
insights
insights.folders
insights.workflows
insights.tools
custom_messages
prompts
session_labels
sessions.transcript
sessions.full-summary
sessions.latency
session_debug
channels.targets
directory
dashboards
outbound.batches
- GETList Outbound Communication Batches
- POSTCreate Outbound Communication Batch
- GETGet Outbound Communication Batch
- PUTUpdate Outbound Communication Batch
- DELDelete Outbound Communication Batch
- POSTUpload Outbound Communication Batch
- GETFetch Outbound Communication Batch Results
- POSTCreate Outbound Communication Request
- POSTDelete Requests By List Of Reference Ids
outbound.campaigns
language_groups
insights.tools
Create Insight Tool Configuration
Create a new insight tool.
POST
/
api
/
v1
/
insights
/
tool-configurations
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.create(request={
"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-05-07T00:00:00Z",
"updated_at": "2025-05-08T00:00:00Z",
"last_updated_by": "user@email.com"
}
Authorizations
Body
application/json
Request model to create/update an insight tool configuration.
Response
200
application/json
Successful Response
Response model for an insight tool configuration.
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.create(request={
"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-05-07T00:00:00Z",
"updated_at": "2025-05-08T00:00:00Z",
"last_updated_by": "user@email.com"
}