Skip to content

Commit 95615a2

Browse files
authored
[Observability AI Assistant] Add multilingual capabilities (elastic#2198)
This PR closes [Issue 285](elastic/obs-docs-projects#285) and adds documentation on the Observability AI Assistant multilingual capabilities.
1 parent 9b4e70a commit 95615a2

File tree

1 file changed

+24
-4
lines changed

1 file changed

+24
-4
lines changed

solutions/observability/observability-ai-assistant.md

Lines changed: 24 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,12 @@ The AI Assistant connects to one of these supported LLM providers:
102102

103103
## Add data to the AI Assistant knowledge base [obs-ai-add-data]
104104

105-
The AI Assistant uses [ELSER](/explore-analyze/machine-learning/nlp/ml-nlp-elser.md), Elastic’s semantic search engine, to recall data from its internal knowledge base index to create retrieval augmented generation (RAG) responses. Adding data such as Runbooks, GitHub issues, internal documentation, and Slack messages to the knowledge base gives the AI Assistant context to provide more specific assistance.
105+
The AI Assistant uses one of the following text embedding models to run semantic search against the internal knowledge base index. The top results are passed to the LLM as context (retrieval‑augmented generation), producing more accurate and grounded responses:
106+
107+
* [ELSER](/explore-analyze/machine-learning/nlp/ml-nlp-elser.md): Recommended for English-only use cases.
108+
* [E5](/explore-analyze/machine-learning/nlp/ml-nlp-e5.md): {applies_to}`stack: ga 9.1` Recommended for non-English use cases.
109+
110+
Adding data such as Runbooks, GitHub issues, internal documentation, and Slack messages to the knowledge base gives the AI Assistant context to provide more specific assistance.
106111

107112
Add data to the knowledge base with one or more of the following methods:
108113

@@ -167,8 +172,8 @@ Field names in custom indices have no specific requirements. Any `semantic_text`
167172
- Create a connector using the [Connector APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-connector)
168173

169174
2. **Create embeddings** (choose one method):
170-
- [`semantic_text` field](#obs-ai-search-connectors-semantic-text): Recommended workflow which handles model setup automatically
171-
- [ML pipeline](#obs-ai-search-connectors-ml-embeddings): Requires manual setup of the ELSER model and inference pipeline
175+
- [`semantic_text` field](#obs-ai-search-connectors-semantic-text): Recommended workflow which handles model setup automatically. Allows the use of any available ML model (Elser, e5, or custom models).
176+
- [ML pipeline](#obs-ai-search-connectors-ml-embeddings): Requires manual setup of the ELSER model and inference pipeline.
172177

173178
#### Option 1: Use a `semantic_text` field type to create embeddings (recommended) [obs-ai-search-connectors-semantic-text]
174179

@@ -210,7 +215,7 @@ After creating the pipeline, complete the following steps:
210215

211216
Ask something to the AI Assistant related with the indexed data.
212217

213-
### Add user-specific system prompts
218+
### Add user-specific system prompts [obs-ai-assistant-user-prompt]
214219

215220
User-specific prompts customize how the AI assistant responds by appending personalized instructions to built-in system prompts. For example, you could specify "Always respond in French," and all subsequent responses will be in French.
216221

@@ -235,6 +240,21 @@ If asked about a Kubernetes pod, namespace, cluster, location, or owner, return
235240
</kubernetes_info>
236241
```
237242
243+
### Choose the Knowledge Base language model
244+
```{applies_to}
245+
stack: ga 9.1
246+
```
247+
Choose the default language model for the AI Assistant in the AI Assistant settings under **Set text embeddings model**.
248+
249+
* [ELSER](/explore-analyze/machine-learning/nlp/ml-nlp-elser.md): recommended for English-only use cases.
250+
* [E5](/explore-analyze/machine-learning/nlp/ml-nlp-e5.md): supports multilingual use cases.
251+
252+
Select the language model and click **Update**.
253+
254+
When switching models, all existing Knowledge Base entries must be reindexed. Entries will be unavailable until reindexing is complete.
255+
256+
To have the AI Assistant respond in a language other than English, set a [user specific prompt](#obs-ai-assistant-user-prompt).
257+
238258
## Interact with the AI Assistant [obs-ai-interact]
239259

240260
::::{important}

0 commit comments

Comments
 (0)