# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for TextQL Observability Service API version: 1.0.0 extends: openapi/textql-observabilityservice-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-01' generator: build-phrasing.py label: Generated by API Evangelist operations: 30 - target: $.paths['/textql.rpc.public.observe.ObservabilityService/ActivateCustomTopic'].post update: x-apievangelist-phrasing: intent: Activate a custom topic effect: write questions: - How do I turn a custom topic on so new chats get tagged with it? - Can I re-enable a custom topic I paused earlier? instructions: - text: Activate custom topic {topic_id}. slots: topic_id: requestBody.topicId - text: Start tagging chats with custom topic {topic_id} again. slots: topic_id: requestBody.topicId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/BackfillCustomTopic'].post update: x-apievangelist-phrasing: intent: Backfill a custom topic over past chats effect: write questions: - Can a new custom topic be applied to chats from before it existed? - Which date range does a topic backfill cover? instructions: - text: Backfill custom topic {topic_id} from {start_date} to {end_date}. slots: topic_id: requestBody.topicId start_date: requestBody.startDate end_date: requestBody.endDate - text: Tag historical chats with custom topic {topic_id}. slots: topic_id: requestBody.topicId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/BackfillThreadWarnings'].post update: x-apievangelist-phrasing: intent: Backfill warnings on past chat threads effect: write questions: - Can I generate thread warnings for older chats retroactively? - How many days back and with what concurrency can a warnings backfill run? instructions: - text: Backfill thread warnings for the last {days} days. slots: days: requestBody.days - text: Redo warnings on all threads in org {org_id} with concurrency {concurrency}. slots: org_id: requestBody.orgId concurrency: requestBody.concurrency method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/CreateCustomTopic'].post update: x-apievangelist-phrasing: intent: Create a custom topic for tagging chats effect: write questions: - How do I define a custom topic to track what people ask about? - Can a custom topic list what it covers and what it excludes? instructions: - text: Create a custom topic named {name} described by {user_prompt}. slots: name: requestBody.name user_prompt: requestBody.userPrompt - text: Add topic {name} covering {covers} but excluding {excludes}. slots: name: requestBody.name covers: requestBody.covers excludes: requestBody.excludes method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/DeactivateCustomTopic'].post update: x-apievangelist-phrasing: intent: Deactivate a custom topic effect: write questions: - Can I pause a custom topic without deleting it? - What stops new chats being tagged with a topic? instructions: - text: Deactivate custom topic {topic_id}. slots: topic_id: requestBody.topicId - text: Pause tagging for custom topic {topic_id}. slots: topic_id: requestBody.topicId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/DeleteCustomTopic'].post update: x-apievangelist-phrasing: intent: Delete a custom topic effect: destructive questions: - How do I permanently remove a custom topic? - Is deleting a custom topic different from deactivating it? instructions: - text: Delete custom topic {topic_id}. slots: topic_id: requestBody.topicId - text: Permanently remove the topic {topic_id}. slots: topic_id: requestBody.topicId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/ExportObservabilityCsv'].post update: x-apievangelist-phrasing: intent: Export observability data as CSV effect: read questions: - Can I download observability data as a CSV? - Which tab and time window does a CSV export cover? instructions: - text: Export the {tab} observability tab as CSV for the last {days} days. slots: tab: requestBody.tab days: requestBody.days - text: Download observability data for {days} days as a spreadsheet. slots: days: requestBody.days method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/FixCheckRecord'].post update: x-apievangelist-phrasing: intent: Fix a failed check record effect: write questions: - Can a flagged check record be fixed automatically? - What happens when I apply a fix to a check record? instructions: - text: Fix check record {record_id}. slots: record_id: requestBody.recordId - text: Apply the fix for flagged check {record_id}. slots: record_id: requestBody.recordId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/FixWarning'].post update: x-apievangelist-phrasing: intent: Fix a thread warning effect: write questions: - Can I resolve a warning raised on a chat thread? - How are thread warnings fixed? instructions: - text: Fix warning {warning_id}. slots: warning_id: requestBody.warningId - text: Resolve the thread warning {warning_id}. slots: warning_id: requestBody.warningId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetAccessMethodStats'].post update: x-apievangelist-phrasing: intent: Get usage by access method effect: read questions: - Are people using TextQL more through the web app, chat integrations or the API? - Can I break down usage by access method for a date range? instructions: - text: Show access method stats for the last {days} days. slots: days: requestBody.days - text: Break down usage by access channel from {start_date} to {end_date}. slots: start_date: requestBody.startDate end_date: requestBody.endDate method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetActivePeopleStats'].post update: x-apievangelist-phrasing: intent: Get active user counts effect: read questions: - How many people were active in the last month? - What's the active people count for a given window? instructions: - text: Get active people stats for the past {days} days. slots: days: requestBody.days - text: Count how many members were active over {days} days. slots: days: requestBody.days method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetActivePeopleTrend'].post update: x-apievangelist-phrasing: intent: Get the trend of active users over time effect: read questions: - Is the number of active people going up or down over time? - Can I chart daily active people between two dates? instructions: - text: Show the active people trend over {days} days. slots: days: requestBody.days - text: Plot active users between {start_date} and {end_date}. slots: start_date: requestBody.startDate end_date: requestBody.endDate method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetBackfillPreview'].post update: x-apievangelist-phrasing: intent: Preview a thread-warning backfill effect: read questions: - How many threads would a warnings backfill touch before I run it? - Can I estimate a backfill's scope first? instructions: - text: Preview a warnings backfill over {days} days. slots: days: requestBody.days - text: Estimate what a full redo backfill would cover for org {org_id}. slots: org_id: requestBody.orgId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetBackfillStatus'].post update: x-apievangelist-phrasing: intent: Check a thread-warning backfill's progress effect: read questions: - Is my warnings backfill still running? - How far along is the backfill for an org? instructions: - text: Get the backfill status for org {org_id}. slots: org_id: requestBody.orgId - text: Check progress on the current warnings backfill with a {timeout_ms} ms timeout. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetBillingStats'].post update: x-apievangelist-phrasing: intent: Get billing and usage cost stats effect: read questions: - How much usage have we been billed for recently? - What do the billing stats look like for the past quarter? instructions: - text: Get billing stats for the last {days} days. slots: days: requestBody.days - text: Summarize our spend over {days} days. slots: days: requestBody.days method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetChatSourceStats'].post update: x-apievangelist-phrasing: intent: Get chat counts by source effect: read questions: - Where are chats coming from, and in what numbers? - Can I see chat sources for one member over a date range? instructions: - text: Show chat source stats for the last {days} days. slots: days: requestBody.days - text: Break down member {member_id}'s chats by source from {start_date} to {end_date}. slots: member_id: requestBody.memberId start_date: requestBody.startDate end_date: requestBody.endDate method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetChatTopics'].post update: x-apievangelist-phrasing: intent: Get the topics tagged on chats effect: read questions: - Which topics were these chats tagged with? - Can I look up topics for several chats at once? instructions: - text: Get the topics for chats {chat_ids}. slots: chat_ids: requestBody.chatIds - text: Show which topics apply to chat IDs {chat_ids}. slots: chat_ids: requestBody.chatIds method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetCheckRecordFix'].post update: x-apievangelist-phrasing: intent: Get the proposed fix for a check record effect: read questions: - What fix is suggested for a failed check before I apply it? - Can I review the remedy for a check record? instructions: - text: Show the proposed fix for check record {record_id}. slots: record_id: requestBody.recordId - text: Get the suggested remedy for check {record_id} without applying it. slots: record_id: requestBody.recordId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetCustomTopic'].post update: x-apievangelist-phrasing: intent: Get a custom topic and its trend effect: read questions: - How is a custom topic configured and trending? - Can I see a custom topic's trend within a window? instructions: - text: Get custom topic {topic_id}. slots: topic_id: requestBody.topicId - text: Show topic {topic_id} trending from {trend_start} to {trend_end}. slots: topic_id: requestBody.topicId trend_start: requestBody.trendStart trend_end: requestBody.trendEnd method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetCustomTopicPeople'].post update: x-apievangelist-phrasing: intent: List people who discuss a custom topic effect: read questions: - Who in my organization is asking about a given topic? - Which members have chats tagged with this custom topic? instructions: - text: List the people behind custom topic {topic_id}. slots: topic_id: requestBody.topicId - text: Show who talks most about topic {topic_id}. slots: topic_id: requestBody.topicId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetCustomTopicThreads'].post update: x-apievangelist-phrasing: intent: List chat threads tagged with a custom topic effect: read questions: - Which chat threads were tagged with a custom topic? - Can I filter a topic's threads by verdict or by member? instructions: - text: List threads tagged with topic {topic_id}. slots: topic_id: requestBody.topicId - text: Show topic {topic_id} threads from member {member_id} with verdict {verdict}. slots: topic_id: requestBody.topicId member_id: requestBody.memberId verdict: requestBody.verdict - text: Get the next {page_size} topic threads after page token {page_token}. slots: page_size: requestBody.pageSize page_token: requestBody.pageToken method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetEngagementSpectrum'].post update: x-apievangelist-phrasing: intent: Get the engagement spectrum of members effect: read questions: - How is engagement distributed across our users, from power users to inactive? - What does the engagement spectrum look like this month? instructions: - text: Show the engagement spectrum for the last {days} days. slots: days: requestBody.days - text: Bucket members by engagement level over {days} days. slots: days: requestBody.days method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetMemberActivity'].post update: x-apievangelist-phrasing: intent: Get per-member activity effect: read questions: - What has each member been doing lately? - Can I see activity broken out by person? instructions: - text: Get member activity for the past {days} days. slots: days: requestBody.days - text: List activity per teammate over {days} days. slots: days: requestBody.days method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetMemberSignalTrend'].post update: x-apievangelist-phrasing: intent: Get the member signal trend effect: read questions: - How are member signals trending over time? - Is there a trend line for member signals across a window? instructions: - text: Show the member signal trend over {days} days. slots: days: requestBody.days - text: Chart member signals for the last {days} days. slots: days: requestBody.days method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetObservabilityStats'].post update: x-apievangelist-phrasing: intent: Get overall observability stats effect: read questions: - What are the headline usage stats for my org? - Which time windows and timezones can the overview stats use? instructions: - text: Get observability stats for the last {days} days. slots: days: requestBody.days - text: Show the overview stats for {days} days bucketed in timezone {timezone}. slots: days: requestBody.days timezone: requestBody.timezone method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/GetThreadWarnings'].post update: x-apievangelist-phrasing: intent: Get warnings raised on chat threads effect: read questions: - Were any warnings flagged on these chats? - Can I fetch thread warnings for several chats at once? instructions: - text: Get thread warnings for chats {chat_ids}. slots: chat_ids: requestBody.chatIds - text: List the warnings flagged on chat IDs {chat_ids}. slots: chat_ids: requestBody.chatIds method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/ListCustomTopics'].post update: x-apievangelist-phrasing: intent: List custom topics effect: read questions: - Which custom topics have we defined? - Can the topic list include trends for a given window? instructions: - text: List all custom topics. - text: List custom topics with trends from {trend_start} to {trend_end}. slots: trend_start: requestBody.trendStart trend_end: requestBody.trendEnd method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/RefineTopicDraft'].post update: x-apievangelist-phrasing: intent: Refine a draft custom topic definition effect: read questions: - Can the system help me tighten a topic definition before I save it? - Will examples and exclusions improve a topic draft? instructions: - text: Refine the topic draft {prompt}. slots: prompt: requestBody.prompt - text: Improve topic draft {prompt} using examples {examples} and exclusions {exclusions}. slots: prompt: requestBody.prompt examples: requestBody.examples exclusions: requestBody.exclusions method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/SetTopicTagFeedback'].post update: x-apievangelist-phrasing: intent: Give feedback on a chat's topic tag effect: write questions: - What if a chat was tagged with the wrong topic? - Can I exclude a chat from a topic and say why? instructions: - text: Exclude chat {chat_id} from topic {topic_id} because {reason}. slots: chat_id: requestBody.chatId topic_id: requestBody.topicId reason: requestBody.reason - text: Record tag feedback on chat {chat_id} for topic {topic_id}. slots: chat_id: requestBody.chatId topic_id: requestBody.topicId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.observe.ObservabilityService/UpdateCustomTopic'].post update: x-apievangelist-phrasing: intent: Update a custom topic effect: write questions: - Can I rename a custom topic or change what it covers? - How do I edit the exclusions on an existing topic? instructions: - text: Rename custom topic {topic_id} to {name}. slots: topic_id: requestBody.topicId name: requestBody.name - text: Change topic {topic_id} to cover {covers} and exclude {excludes}. slots: topic_id: requestBody.topicId covers: requestBody.covers excludes: requestBody.excludes method: generated generated: '2026-10-01'