From 31dd69537e31dd5bac966c893e609641548a7a9f Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Tue, 17 Jun 2025 11:01:39 -0500 Subject: [PATCH 1/6] update search connector index pattern setting docs --- .../observability-ai-assistant.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/solutions/observability/observability-ai-assistant.md b/solutions/observability/observability-ai-assistant.md index 22d5347b87..5e044e49a0 100644 --- a/solutions/observability/observability-ai-assistant.md +++ b/solutions/observability/observability-ai-assistant.md @@ -130,12 +130,25 @@ To add external data to the knowledge base in {{kib}}: [Search connectors](elasticsearch://reference/search-connectors/index.md) index content from external sources like GitHub, Confluence, Google Drive, Jira, S3, Teams, and Slack to improve the AI Assistant's responses. -**Requirements and limitations:** +#### Requirements and limitations + - For stack 9.0.0+ or {{serverless-short}}, connectors must be [self-managed](elasticsearch://reference/search-connectors/self-managed-connectors.md) - Manage connectors through the Search Solution in {{kib}} (pre-9.0) or via the [Connector APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-connector) -- By default, the AI Assistant queries all search connector indices. To customize which data sources are included in the knowledge base, adjust the **Search connector index pattern** setting on the [AI Assistant Settings](#obs-ai-settings) page. -**Setup process:** +#### Knowledge base data sources +By default, the AI Assistant queries all search connector indices. To customize which indices are used in the knowledge base, set the **Search connector index pattern** setting on the [AI Assistant Settings](#obs-ai-settings) page. + +:::{note} +You can specify any index in the **Search connector index pattern** setting, not just search connectors. +::: + +##### Space awareness +The **Search connector index pattern** setting is [space](../../deploy-manage/manage-spaces.md) aware. This means you can assign different values for different spaces. For example, a "Developers" space may include an index pattern like `github-*,jira*`, while an "HR" space may include an index pattern like `employees-*`. + +##### Custom index requirements +Field names in custom indices have no specific requirements. Any `semantic_text` field is automatically queried. Matching documents are sent to the LLM in full, including all fields. Including or excluding specific fields is not possible. + +#### Setup process: 1. **Create a connector** From d0bcf59d08cb254f5fc4972c5bd3975f37380685 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Tue, 17 Jun 2025 12:29:36 -0500 Subject: [PATCH 2/6] fix typo --- solutions/observability/observability-ai-assistant.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/observability/observability-ai-assistant.md b/solutions/observability/observability-ai-assistant.md index 5e044e49a0..d1b374847a 100644 --- a/solutions/observability/observability-ai-assistant.md +++ b/solutions/observability/observability-ai-assistant.md @@ -139,7 +139,7 @@ To add external data to the knowledge base in {{kib}}: By default, the AI Assistant queries all search connector indices. To customize which indices are used in the knowledge base, set the **Search connector index pattern** setting on the [AI Assistant Settings](#obs-ai-settings) page. :::{note} -You can specify any index in the **Search connector index pattern** setting, not just search connectors. +You can specify any index in the **Search connector index pattern** setting, not just search connector indices. ::: ##### Space awareness From 829aa76e0497b23ac61b4ed680e53e3e1963d914 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Tue, 17 Jun 2025 15:05:36 -0500 Subject: [PATCH 3/6] update note --- solutions/observability/observability-ai-assistant.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/observability/observability-ai-assistant.md b/solutions/observability/observability-ai-assistant.md index d1b374847a..46b0a13817 100644 --- a/solutions/observability/observability-ai-assistant.md +++ b/solutions/observability/observability-ai-assistant.md @@ -139,7 +139,7 @@ To add external data to the knowledge base in {{kib}}: By default, the AI Assistant queries all search connector indices. To customize which indices are used in the knowledge base, set the **Search connector index pattern** setting on the [AI Assistant Settings](#obs-ai-settings) page. :::{note} -You can specify any index in the **Search connector index pattern** setting, not just search connector indices. +You're not limited to search connector indices in the **Search connector index pattern setting**. You can specify any index pattern. ::: ##### Space awareness From 5eba3ec6e2cb385c6a62d5999c3d83eadaad15eb Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Wed, 18 Jun 2025 12:07:51 -0500 Subject: [PATCH 4/6] update requirements --- solutions/observability/observability-ai-assistant.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/solutions/observability/observability-ai-assistant.md b/solutions/observability/observability-ai-assistant.md index 46b0a13817..f8089be592 100644 --- a/solutions/observability/observability-ai-assistant.md +++ b/solutions/observability/observability-ai-assistant.md @@ -145,8 +145,8 @@ You're not limited to search connector indices in the **Search connector index p ##### Space awareness The **Search connector index pattern** setting is [space](../../deploy-manage/manage-spaces.md) aware. This means you can assign different values for different spaces. For example, a "Developers" space may include an index pattern like `github-*,jira*`, while an "HR" space may include an index pattern like `employees-*`. -##### Custom index requirements -Field names in custom indices have no specific requirements. Any `semantic_text` field is automatically queried. Matching documents are sent to the LLM in full, including all fields. Including or excluding specific fields is not possible. +##### Custom index field name requirements +Field names in custom indices have no specific requirements. Any `semantic_text` field is automatically queried. Documents matching the index pattern are sent to the LLM in full, including all fields. It's not currently possible to include or exclude specific fields. #### Setup process: From d134ef77d381222397aff1bc87025c8a6f5ca796 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl <114418652+mdbirnstiehl@users.noreply.github.com> Date: Tue, 24 Jun 2025 09:08:41 -0500 Subject: [PATCH 5/6] Update solutions/observability/observability-ai-assistant.md Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> --- solutions/observability/observability-ai-assistant.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/observability/observability-ai-assistant.md b/solutions/observability/observability-ai-assistant.md index 1c86c9b8c1..217ede41cc 100644 --- a/solutions/observability/observability-ai-assistant.md +++ b/solutions/observability/observability-ai-assistant.md @@ -132,7 +132,7 @@ To add external data to the knowledge base in {{kib}}: #### Requirements and limitations -- For stack 9.0.0+ or {{serverless-short}}, connectors must be [self-managed](elasticsearch://reference/search-connectors/self-managed-connectors.md) +- For {{stack}} 9.0.0+ or {{serverless-short}}, connectors must be [self-managed](elasticsearch://reference/search-connectors/self-managed-connectors.md). - Manage connectors through the Search Solution in {{kib}} (pre-9.0) or via the [Connector APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-connector) #### Knowledge base data sources From 8526004bdc5c29aef5d9f9d37fb3868e6d963b1e Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl <114418652+mdbirnstiehl@users.noreply.github.com> Date: Tue, 24 Jun 2025 09:08:46 -0500 Subject: [PATCH 6/6] Update solutions/observability/observability-ai-assistant.md Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> --- solutions/observability/observability-ai-assistant.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/observability/observability-ai-assistant.md b/solutions/observability/observability-ai-assistant.md index 217ede41cc..c6e95644ba 100644 --- a/solutions/observability/observability-ai-assistant.md +++ b/solutions/observability/observability-ai-assistant.md @@ -133,7 +133,7 @@ To add external data to the knowledge base in {{kib}}: #### Requirements and limitations - For {{stack}} 9.0.0+ or {{serverless-short}}, connectors must be [self-managed](elasticsearch://reference/search-connectors/self-managed-connectors.md). -- Manage connectors through the Search Solution in {{kib}} (pre-9.0) or via the [Connector APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-connector) +- Manage connectors through the Search Solution in {{kib}} (pre-9.0.0) or with the [Connector APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-connector). #### Knowledge base data sources By default, the AI Assistant queries all search connector indices. To customize which indices are used in the knowledge base, set the **Search connector index pattern** setting on the [AI Assistant Settings](#obs-ai-settings) page.