The Livingdocs Source is available on request. If you don’t see Livingdocs in the list of sources, contact Raily to turn it on for your Account.
Before you start
Ask your Livingdocs admin for two things:- The server URL of your Livingdocs instance, for example
https://server.livingdocs.io. It must use HTTPS. - A project API token for the project you want to search. The token needs the
public-api:readandpublic-api:config:readpermissions. One token covers one project, so connect each project as its own Source.
Connect the project
1
Open the source list
Go to Connect a data source and choose Livingdocs from the CMS group.
2
Name the Source
In Name, enter something your team will recognize, such as the publication or project name.
3
Enter the server URL
Paste your instance address into Livingdocs server URL.
4
Paste the token
Paste the project token into Access token.
5
Choose how often to sync
Pick a Sync frequency: Every hour (the default), Every 6 hours, Every 12 hours, Every day, or Every 2 days.
6
Check the connection
Click outside the Credentials box. Raily tests the URL and token against Livingdocs and shows Verified when they work. You’ll also see a message naming the project it found, for example “Connected to Livingdocs project my-project.”
7
Save
Click Create Integration. The button stays disabled until the credentials show Verified.
What happens next
Raily opens the Source’s page and starts the first sync right away. The sync card shows progress as Syncing with a count of items that are already searchable. A large project can take a while on the first run. When the sync finishes, Raily writes the search configuration for the new collection on its own. The card then shows Last sync with the number of items added, updated, and removed, plus when the next sync is due. After that, Raily checks Livingdocs on the schedule you picked. Each sync picks up newly published items, refreshes items that were republished, and removes items that were unpublished. To check right away, click Resync on the Source’s page. Use Full reindex from the menu next to it if search results look wrong and you want every item processed again. To serve the content to agents, wire the collection to an endpoint.What Raily indexes
Raily reads the latest published version of every article, page, and data record in the project. That includes the text in your custom components and the text fields of your data records. Raily does not index drafts, earlier revisions, or media files such as images and video. An image linked from a document can still appear on its result card. Each item keeps these details, which show on result cards and which Raily can use to narrow a search:
Searches can filter on published date, language, document type, content type, and channel.
Change a connected Source
Open the Source and edit it to replace the access token or change the sync frequency. Leave Access token empty to keep the saved token. You can’t change the server URL or the project of a connected Source. To search another Livingdocs instance or project, connect a new Source.Next steps
Create an AI endpoint
Let agents search this source
Data Catalog
Review the fields agents filter on