Set agent Conversation Insights config
PUThttps://platform.docana.com/api/v1/agents/:agentId/insights/config/
Stores the given Conversation Insights configuration on the agent, replacing any existing config in full and keeping its managed table in sync whenever Insights is enabled with configured fields. Pass insights: null to clear the config and pause its table. Read the current config with getAgent: it is returned under metadata.insights. Each data point has a type (string, number or boolean) and an optional source: omit it for AI extraction, or use nodeReached (boolean) or nodeExecutionCount (number) with a node from listAgentInsightSourceNodes to measure a workflow node deterministically. Boolean and number points can decide an experiment winner; string points cannot. Use getAgentInsightTable for table links and configureAgentInsightTable to pause or include existing history. Unrelated to pollAgentInsights, which reads document insights results.
Request
Responses
- 200
- 400
- 401
- 402
- 403
- 404
- 409
- 500
The stored Insights config after the idempotent replacement.
Invalid path or insights body
The API key or session is missing, expired, or malformed.
Company budget exceeded while creating the insights table
No write access to the application
Agent not found in the application
The connected table was deleted or belongs to another application
Unexpected server error.