[8.15] [DOCS] Add known issue to 8.14.3 release notes (#189236) (#189441)

# Backport

This will backport the following commits from `main` to `8.15`:
- [[DOCS] Add known issue to 8.14.3 release notes
(#189236)](#189236)

<!--- Backport version: 9.4.3 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"Colleen
McGinnis","email":"[email protected]"},"sourceCommit":{"committedDate":"2024-07-29T18:46:24Z","message":"[DOCS]
Add known issue to 8.14.3 release notes (#189236)\n\n##
Summary\r\n\r\nFixes
https://github.com/elastic/observability-docs/issues/4090\r\n\r\nRelated
to https://github.com/elastic/kibana/pull/185691\r\n\r\nThis PR adds a
known issue to the 8.14.3 release docs related to\r\nfunction calling
when using the Observability AI Assistant with the\r\nOpenAI
connector.\r\n\r\n### For maintainers\r\n\r\n- [ ] This was checked for
breaking API changes and was
[labeled\r\nappropriately](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)","sha":"518426045db64f14a19b5fae185a4ecf785cef54","branchLabelMapping":{"^v8.16.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:skip","docs","backport:prev-minor","v8.16.0","v8.14.3"],"title":"[DOCS]
Add known issue to 8.14.3 release
notes","number":189236,"url":"https://github.com/elastic/kibana/pull/189236","mergeCommit":{"message":"[DOCS]
Add known issue to 8.14.3 release notes (#189236)\n\n##
Summary\r\n\r\nFixes
https://github.com/elastic/observability-docs/issues/4090\r\n\r\nRelated
to https://github.com/elastic/kibana/pull/185691\r\n\r\nThis PR adds a
known issue to the 8.14.3 release docs related to\r\nfunction calling
when using the Observability AI Assistant with the\r\nOpenAI
connector.\r\n\r\n### For maintainers\r\n\r\n- [ ] This was checked for
breaking API changes and was
[labeled\r\nappropriately](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)","sha":"518426045db64f14a19b5fae185a4ecf785cef54"}},"sourceBranch":"main","suggestedTargetBranches":["8.14"],"targetPullRequestStates":[{"branch":"main","label":"v8.16.0","branchLabelMappingKey":"^v8.16.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/189236","number":189236,"mergeCommit":{"message":"[DOCS]
Add known issue to 8.14.3 release notes (#189236)\n\n##
Summary\r\n\r\nFixes
https://github.com/elastic/observability-docs/issues/4090\r\n\r\nRelated
to https://github.com/elastic/kibana/pull/185691\r\n\r\nThis PR adds a
known issue to the 8.14.3 release docs related to\r\nfunction calling
when using the Observability AI Assistant with the\r\nOpenAI
connector.\r\n\r\n### For maintainers\r\n\r\n- [ ] This was checked for
breaking API changes and was
[labeled\r\nappropriately](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)","sha":"518426045db64f14a19b5fae185a4ecf785cef54"}},{"branch":"8.14","label":"v8.14.3","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

Co-authored-by: Colleen McGinnis <[email protected]>

Author: kibanamachine

docs/CHANGELOG.asciidoc

@@ -99,6 +99,32 @@ The Uptime app is already hidden from Kibana when there is no recent Heartbeat d
 
 The 8.14.3 release includes the following bug fixes.
 
+[float]
+[[known-issues-8.14.3]]
+=== Known issues
+
+[discrete]
+[[known-185691]]
+.When using the Observability AI Assistant with the OpenAI connector, function calling will result in an error
+[%collapsible]
+====
+*Details* +
+In 8.14.3, if you are using the Observability AI Assistant with the OpenAI connector, function calling will result in an error.
+The error message will look similar to this:
+
+[source]
+----
+Error: an error occurred while running the action - Status code: 400. Message: API Error: model_error - Missing required parameter: 'messages[4].function_call.arguments'.
+----
+
+A fix will be available in 8.15. Users on 8.14.3 can get around this error by turning on synthetic function calling in _AI Assistant Settings_:
+
+. In {kib}, go to *Stack Management* → *AI Assistant* → *Observability*
+. Toggle the _Simulate function calling_ option to *On*.
+
+For more information, refer to {kibana-pull}185691[#185691].
+====
+
 [float]
 [[fixes-v8.14.3]]
 === Bug Fixes
@@ -164,7 +190,7 @@ Before you upgrade to 8.14.0, review the breaking changes, then mitigate the imp
 *Details* +
 The advanced setting which hides {esql} from the UI has been renamed from `discover:enableESQL` to `enableESQL`. It is enabled by default and must be switched off to disable {esql} features from your {kib} applications. For more information, refer to ({kibana-pull}182074[#182074]).
 ====
-      
+
 [discrete]
 [[breaking-178879]]
 .The unified search filter builder is Generally Available.
@@ -173,7 +199,7 @@ The advanced setting which hides {esql} from the UI has been renamed from `disco
 *Details* +
 The unified search filter builder (OR / AND) is out of technical preview. For more information, refer to ({kibana-pull}178879[#178879]).
 ====
-      
+
 [discrete]
 [[breaking-178860]]
 .{esql} is Generally Available.
@@ -182,7 +208,7 @@ The unified search filter builder (OR / AND) is out of technical preview. For mo
 *Details* +
 {esql} comes out of technical preview and is generally available. For more information, refer to ({kibana-pull}178860[#178860]).
 ====
-      
+
 [discrete]
 [[breaking-177549]]
 .The region map visualization type is Generally Available in Lens.
@@ -191,7 +217,7 @@ The unified search filter builder (OR / AND) is out of technical preview. For mo
 *Details* +
 The visualization type, region map, comes out of technical preview and is generally available. For more information, refer to ({kibana-pull}177549[#177549]).
 ====
-      
+
 [discrete]
 [[breaking-177089]]
 .UI enhancements to managed tags.
@@ -200,7 +226,7 @@ The visualization type, region map, comes out of technical preview and is genera
 *Details* +
 UI improvements for managed tags. For more information, refer to ({kibana-pull}177089[#177089]).
 ====
-      
+
 [float]
 [[features-8.14.0]]
 === Features
@@ -603,23 +629,23 @@ Before you upgrade to 8.13.0, review the breaking changes, then mitigate the imp
 *Details* +
 The Kafka output no longer supports conditional topics. For more information, refer to ({kibana-pull}176879[#176879]).
 ====
-      
+
 [discrete]
 [[breaking-176443]]
-.Most Fleet installed integrations are now read-only and labelled with a *Managed* tag in the Kibana UI 
+.Most Fleet installed integrations are now read-only and labelled with a *Managed* tag in the Kibana UI
 [%collapsible]
 ====
 *Details* +
 
 Integration content installed by {fleet} is no longer editable. This content is tagged with *Managed* in the {kib} UI, and is Elastic managed. This content cannot be edited or deleted, however managed visualizations, dashboards, and saved searches can be cloned. The clones can be customized.
 
-When cloning a dashboard the cloned panels become entirely independent copies that are unlinked from the original configurations and dependencies. 
+When cloning a dashboard the cloned panels become entirely independent copies that are unlinked from the original configurations and dependencies.
 
 Managed content relating to specific visualization editors such as Lens, TSVB, and Maps, the clones retain the original reference configurations. The same applies to editing any saved searches in a managed visualization.
 
 For more information, refer to ({kibana-pull}172393[#172393]).
 ====
-  
+
 [discrete]
 [[breaking-174674]]
 .Removes `is_nan`, `is_finite`, and `is_infinite` functions from {esql}
@@ -628,7 +654,7 @@ For more information, refer to ({kibana-pull}172393[#172393]).
 *Details* +
 These functions have been removed from {esql} queries as they are not supported. Errors would be thrown when trying to use them. For more information, refer to ({kibana-pull}174674[#174674]).
 ====
-      
+
 [float]
 [[features-8.13.0]]
 === Features
@@ -936,7 +962,7 @@ The 8.12.1 release includes the following enhancements and bug fixes.
 === Enhancements
 
 Elastic Security::
-For the Elastic Security 8.12.1 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_]. 
+For the Elastic Security 8.12.1 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
 Observability::
 * Adds `defer_validation: true` to transforms on creation to stop errors when the destination index doesn't exist yet ({kibana-pull}174463[#174463]).
 
@@ -1019,7 +1045,7 @@ The previous summary transforms summarizing every SLOs won't be used anymore and
 
 Be aware that when installing a new SLO (or after resetting an SLO), we install two transforms (one for the rollup data and one that summarize the rollup data). Do not delete the new `slo-summary-{slo_id}-{slo_revision}` transforms. For more information, refer to ({kibana-pull}172224[#172224]).
 ====
-      
+
 [discrete]
 [[breaking-170635]]
 .A new sub-feature privilege to control user access to the cases settings
@@ -1028,7 +1054,7 @@ Be aware that when installing a new SLO (or after resetting an SLO), we install
 *Details* +
 Roles with at least a sub-feature privilege configured will not have access to the cases setting like they had previously. All roles without a sub-feature privilege configured will not be affected. For more information, refer to ({kibana-pull}170635[#170635]).
 ====
-      
+
 [float]
 [[features-8.12.0]]
 === Features
@@ -1057,11 +1083,11 @@ Machine Learning::
 * Adds E5 model configurations ({kibana-pull}172053[#172053]).
 * Adds the ability to create a categorization anomaly detection job from pattern analysis ({kibana-pull}170567[#170567]).
 * Adds and displays alerts data in the Anomaly Explorer ({kibana-pull}167998[#167998]).
-Observability:: 
+Observability::
 * Adds logic to update flyout highlights ({kibana-pull}172193[#172193]).
 * Adds logic to display highlights in the flyout ({kibana-pull}170650[#170650]).
 * Changes the Custom threshold title to Beta ({kibana-pull}172360[#172360]).
-Security:: 
+Security::
 * Disables the connector parameters field ({kibana-pull}173610[#173610]).
 * Adds a risk engine missing privileges callout ({kibana-pull}171250[#171250]).
 * Asset criticality privileges API ({kibana-pull}172441[#172441]).
@@ -1764,7 +1790,7 @@ If some SLOs have been installed in a prior version at 8.10, they won't work aft
 
 *Removing SLOs before migrating to 8.10*
 
-Use the SLO UI or the SLO delete API to delete all existing SLOs. This takes care of the Saved Object, Transform and rollup data. When all SLOs have been deleted, then delete the residual rollup indices: `.slo-observability.sli-v1*`. Note that this is v1. 
+Use the SLO UI or the SLO delete API to delete all existing SLOs. This takes care of the Saved Object, Transform and rollup data. When all SLOs have been deleted, then delete the residual rollup indices: `.slo-observability.sli-v1*`. Note that this is v1.
 
 *Removing SLOs after migrating to 8.10*