Skip to content

Commit 8a6ff71

Browse files
rahulgdsouzaclaude
rahulgdsouza
and
claude
committed
Document content sources on Fin Agent API replied events
Adds the optional `message.sources` array to the fin_replied event schema in 2.14, 2.15, 2.16 and Preview. Each source carries a title, a type (article or external) and a url. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent a4e40b8 commit 8a6ff71

4 files changed

Lines changed: 124 additions & 0 deletions

File tree

‎descriptions/0/api.intercom.io.yaml‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39109,6 +39109,37 @@ components:
3910939109
format: date-time
3911039110
description: The timestamp the message was created at, with millisecond precision.
3911139111
example: '2025-01-24T09:01:00.456Z'
39112+
sources:
39113+
type: array
39114+
description: |
39115+
The content sources Fin used to generate this reply, in the same order as the
39116+
[n] citation markers in the body. Present only when Fin cited content.
39117+
items:
39118+
type: object
39119+
properties:
39120+
title:
39121+
type: string
39122+
description: The title of the source.
39123+
example: Managing your account
39124+
type:
39125+
type: string
39126+
enum:
39127+
- article
39128+
- external
39129+
description: Whether the source is an Intercom article or external content.
39130+
example: article
39131+
url:
39132+
type: string
39133+
description: The URL of the source.
39134+
example: https://www.example.com/help/en/articles/1-managing-your-account
39135+
required:
39136+
- title
39137+
- type
39138+
- url
39139+
example:
39140+
- title: Managing your account
39141+
type: article
39142+
url: https://www.example.com/help/en/articles/1-managing-your-account
3911239143
required:
3911339144
- author
3911439145
- body

‎descriptions/2.14/api.intercom.io.yaml‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21010,6 +21010,37 @@ components:
2101021010
format: date-time
2101121011
description: The timestamp the message was created at, with millisecond precision.
2101221012
example: '2025-01-24T09:01:00.456Z'
21013+
sources:
21014+
type: array
21015+
description: |
21016+
The content sources Fin used to generate this reply, in the same order as the
21017+
[n] citation markers in the body. Present only when Fin cited content.
21018+
items:
21019+
type: object
21020+
properties:
21021+
title:
21022+
type: string
21023+
description: The title of the source.
21024+
example: Managing your account
21025+
type:
21026+
type: string
21027+
enum:
21028+
- article
21029+
- external
21030+
description: Whether the source is an Intercom article or external content.
21031+
example: article
21032+
url:
21033+
type: string
21034+
description: The URL of the source.
21035+
example: https://www.example.com/help/en/articles/1-managing-your-account
21036+
required:
21037+
- title
21038+
- type
21039+
- url
21040+
example:
21041+
- title: Managing your account
21042+
type: article
21043+
url: https://www.example.com/help/en/articles/1-managing-your-account
2101321044
required:
2101421045
- author
2101521046
- body

‎descriptions/2.15/api.intercom.io.yaml‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21923,6 +21923,37 @@ components:
2192321923
format: date-time
2192421924
description: The timestamp the message was created at, with millisecond precision.
2192521925
example: '2025-01-24T09:01:00.456Z'
21926+
sources:
21927+
type: array
21928+
description: |
21929+
The content sources Fin used to generate this reply, in the same order as the
21930+
[n] citation markers in the body. Present only when Fin cited content.
21931+
items:
21932+
type: object
21933+
properties:
21934+
title:
21935+
type: string
21936+
description: The title of the source.
21937+
example: Managing your account
21938+
type:
21939+
type: string
21940+
enum:
21941+
- article
21942+
- external
21943+
description: Whether the source is an Intercom article or external content.
21944+
example: article
21945+
url:
21946+
type: string
21947+
description: The URL of the source.
21948+
example: https://www.example.com/help/en/articles/1-managing-your-account
21949+
required:
21950+
- title
21951+
- type
21952+
- url
21953+
example:
21954+
- title: Managing your account
21955+
type: article
21956+
url: https://www.example.com/help/en/articles/1-managing-your-account
2192621957
required:
2192721958
- author
2192821959
- body

‎descriptions/2.16/api.intercom.io.yaml‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32427,6 +32427,37 @@ components:
3242732427
format: date-time
3242832428
description: The timestamp the message was created at, with millisecond precision.
3242932429
example: '2025-01-24T09:01:00.456Z'
32430+
sources:
32431+
type: array
32432+
description: |
32433+
The content sources Fin used to generate this reply, in the same order as the
32434+
[n] citation markers in the body. Present only when Fin cited content.
32435+
items:
32436+
type: object
32437+
properties:
32438+
title:
32439+
type: string
32440+
description: The title of the source.
32441+
example: Managing your account
32442+
type:
32443+
type: string
32444+
enum:
32445+
- article
32446+
- external
32447+
description: Whether the source is an Intercom article or external content.
32448+
example: article
32449+
url:
32450+
type: string
32451+
description: The URL of the source.
32452+
example: https://www.example.com/help/en/articles/1-managing-your-account
32453+
required:
32454+
- title
32455+
- type
32456+
- url
32457+
example:
32458+
- title: Managing your account
32459+
type: article
32460+
url: https://www.example.com/help/en/articles/1-managing-your-account
3243032461
required:
3243132462
- author
3243232463
- body

0 commit comments

Comments
 (0)