Skip to content

Tutorial: Semantic Search Documentation using deprecated elser service instead of elasticsearch service #117829

@eshaffer321

Description

@eshaffer321

The “Tutorial: semantic search with semantic_text” in the Elasticsearch documentation currently uses the ELSER model, which has been deprecated as of version 8.16. However, the tutorial does not include any deprecation warning to notify users about this status. This can lead to confusion for users following the tutorial, as they may unknowingly rely on a deprecated service.

Steps to Reproduce:

1.	Navigate to the tutorial: [Semantic Search Tutorial](https://github.com/elastic/elasticsearch/issues/link-to-tutorial-page).
2.	Observe that there is no mention of ELSER being deprecated.
3.	Compare with the [ELSER documentation](https://github.com/elastic/elasticsearch/issues/link-to-elser-page), which clearly states the deprecation notice:
The ELSER service is deprecated as of version 8.16 and will be removed in a future release. Use the Elasticsearch inference service instead, with model_id included in service_settings.

Expected Behavior:

•	The tutorial should clearly display a deprecation warning for the ELSER service.
•	The warning should guide users to use the recommended Elasticsearch inference service with model_id in service_settings as an alternative.

Suggested Fix:

	 Deprecated in 8.16
The ELSER service used in this tutorial is deprecated and will be removed in a future release. Use the Elasticsearch inference service with model_id included in service_settings instead. Refer to the [ELSER documentation](https://github.com/elastic/elasticsearch/issues/link-to-elser-page) for details.

Metadata

Metadata

Assignees

Labels

:mlMachine learning>docsGeneral docs changesTeam:DocsMeta label for docs teamTeam:MLMeta label for the ML team

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions