Skip to content

Commit 5b01fc5

Browse files
feat: Add ai_topics schema to conversation response (#385)
* feat: Add ai_topics schema to conversation response Add ai_topics, ai_topic, and ai_subtopic component schemas to document the new AI-generated topic/subtopic data on conversation responses. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: Remove incorrect nullable annotations from ai_subtopic.id and ai_topics ai_subtopic.id is always present, and ai_topics returns {} not null. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent c366b1c commit 5b01fc5

1 file changed

Lines changed: 67 additions & 0 deletions

File tree

descriptions/0/api.intercom.io.yaml

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6187,6 +6187,7 @@ paths:
61876187
data: []
61886188
total_count: 0
61896189
has_more: false
6190+
ai_topics:
61906191
ai_agent:
61916192
ai_agent_participated: false
61926193
schema:
@@ -6425,6 +6426,7 @@ paths:
64256426
data: []
64266427
total_count: 0
64276428
has_more: false
6429+
ai_topics:
64286430
ai_agent:
64296431
ai_agent_participated: false
64306432
conversation_parts:
@@ -6672,6 +6674,7 @@ paths:
66726674
data: []
66736675
total_count: 0
66746676
has_more: false
6677+
ai_topics:
66756678
ai_agent:
66766679
ai_agent_participated: false
66776680
conversation_parts:
@@ -6778,6 +6781,7 @@ paths:
67786781
data: []
67796782
total_count: 0
67806783
has_more: false
6784+
ai_topics:
67816785
ai_agent:
67826786
ai_agent_participated: false
67836787
conversation_parts:
@@ -7096,6 +7100,7 @@ paths:
70967100
data: []
70977101
total_count: 0
70987102
has_more: false
7103+
ai_topics:
70997104
ai_agent:
71007105
ai_agent_participated: false
71017106
schema:
@@ -7198,6 +7203,7 @@ paths:
71987203
data: []
71997204
total_count: 0
72007205
has_more: false
7206+
ai_topics:
72017207
ai_agent:
72027208
ai_agent_participated: false
72037209
conversation_parts:
@@ -7274,6 +7280,7 @@ paths:
72747280
data: []
72757281
total_count: 0
72767282
has_more: false
7283+
ai_topics:
72777284
ai_agent:
72787285
ai_agent_participated: false
72797286
conversation_parts:
@@ -7362,6 +7369,7 @@ paths:
73627369
data: []
73637370
total_count: 0
73647371
has_more: false
7372+
ai_topics:
73657373
ai_agent:
73667374
ai_agent_participated: false
73677375
conversation_parts:
@@ -7441,6 +7449,7 @@ paths:
74417449
data: []
74427450
total_count: 0
74437451
has_more: false
7452+
ai_topics:
74447453
ai_agent:
74457454
ai_agent_participated: false
74467455
conversation_parts:
@@ -7641,6 +7650,7 @@ paths:
76417650
data: []
76427651
total_count: 0
76437652
has_more: false
7653+
ai_topics:
76447654
ai_agent:
76457655
ai_agent_participated: false
76467656
conversation_parts:
@@ -7717,6 +7727,7 @@ paths:
77177727
data: []
77187728
total_count: 0
77197729
has_more: false
7730+
ai_topics:
77207731
ai_agent:
77217732
ai_agent_participated: false
77227733
conversation_parts:
@@ -7793,6 +7804,7 @@ paths:
77937804
data: []
77947805
total_count: 0
77957806
has_more: false
7807+
ai_topics:
77967808
ai_agent:
77977809
ai_agent_participated: false
77987810
conversation_parts:
@@ -7869,6 +7881,7 @@ paths:
78697881
data: []
78707882
total_count: 0
78717883
has_more: false
7884+
ai_topics:
78727885
ai_agent:
78737886
ai_agent_participated: false
78747887
conversation_parts:
@@ -8356,6 +8369,7 @@ paths:
83568369
data: []
83578370
total_count: 0
83588371
has_more: false
8372+
ai_topics:
83598373
ai_agent:
83608374
ai_agent_participated: false
83618375
conversation_parts:
@@ -16587,6 +16601,57 @@ components:
1658716601
nullable: true
1658816602
content_sources:
1658916603
"$ref": "#/components/schemas/content_sources_list"
16604+
ai_subtopic:
16605+
title: AI Subtopic
16606+
type: object
16607+
description: An AI-generated subtopic under a topic.
16608+
properties:
16609+
type:
16610+
type: string
16611+
description: Always ai_subtopic.
16612+
example: ai_subtopic
16613+
name:
16614+
type: string
16615+
description: The name of the subtopic.
16616+
example: Payment Issues
16617+
id:
16618+
type: integer
16619+
description: The ID of the subtopic.
16620+
example: 42
16621+
ai_topic:
16622+
title: AI Topic
16623+
type: object
16624+
description: An AI-generated topic assigned to the conversation.
16625+
properties:
16626+
type:
16627+
type: string
16628+
description: Always ai_topic.
16629+
example: ai_topic
16630+
topic_name:
16631+
type: string
16632+
description: The name of the AI-generated topic.
16633+
example: Billing
16634+
subtopics:
16635+
type: array
16636+
description: The subtopics under this topic.
16637+
items:
16638+
$ref: '#/components/schemas/ai_subtopic'
16639+
ai_topics:
16640+
title: AI Topics
16641+
type: object
16642+
x-tags:
16643+
- AI Topics
16644+
description: AI-generated topics and subtopics for the conversation.
16645+
properties:
16646+
type:
16647+
type: string
16648+
description: Always ai_topics.
16649+
example: ai_topics
16650+
topics:
16651+
type: array
16652+
description: The list of AI-generated topics for this conversation.
16653+
items:
16654+
$ref: '#/components/schemas/ai_topic'
1659016655
app:
1659116656
title: App
1659216657
type: object
@@ -18766,6 +18831,8 @@ components:
1876618831
"$ref": "#/components/schemas/conversation_parts"
1876718832
linked_objects:
1876818833
"$ref": "#/components/schemas/linked_object_list"
18834+
ai_topics:
18835+
"$ref": "#/components/schemas/ai_topics"
1876918836
ai_agent_participated:
1877018837
type: boolean
1877118838
description: Indicates whether the AI Agent participated in the conversation.

0 commit comments

Comments
 (0)