From dc8322a46f51a2e12fa0eafee1dad365e5adffb5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <szabosteve@gmail.com>
Date: Wed, 30 Oct 2024 17:12:53 +0100
Subject: [PATCH] [DOCS] Fine-tunes inference connector and action docs
 (#198345)

---
 docs/management/action-types.asciidoc         |  4 +--
 .../action-types/inference.asciidoc           | 32 ++++++++++++++-----
 2 files changed, 26 insertions(+), 10 deletions(-)

diff --git a/docs/management/action-types.asciidoc b/docs/management/action-types.asciidoc
index 361892e430afd..1357af980d278 100644
--- a/docs/management/action-types.asciidoc
+++ b/docs/management/action-types.asciidoc
@@ -28,9 +28,9 @@ a| <<gemini-action-type,{gemini}>>
 
 | Send a request to {gemini}.
 
-a| <<inference-action-type,{inference}>>
+a| <<inference-action-type,{infer}>>
 
-| Send a request to {inference}.
+| Send a request to {infer}.
 
 a| <<email-action-type,Email>>
 
diff --git a/docs/management/connectors/action-types/inference.asciidoc b/docs/management/connectors/action-types/inference.asciidoc
index 8c7f2840f9c5c..ea8a0be675e18 100644
--- a/docs/management/connectors/action-types/inference.asciidoc
+++ b/docs/management/connectors/action-types/inference.asciidoc
@@ -1,7 +1,7 @@
 [[inference-action-type]]
 == {infer-cap} connector and action
 ++++
-<titleabbrev>{inference}</titleabbrev>
+<titleabbrev>{infer-cap}</titleabbrev>
 ++++
 :frontmatter-description: Add a connector that can send requests to {inference}.
 :frontmatter-tags-products: [kibana] 
@@ -9,7 +9,8 @@
 :frontmatter-tags-user-goals: [configure]
 
 
-The {infer} connector uses the {es} client to send requests to an {infer} service. The connector uses the <<execute-connector-api,run connector API>> to send the request.
+The {infer} connector uses the {es} client to send requests to an {infer} service.
+The connector uses the <<execute-connector-api,run connector API>> to send the request.
 
 [float]
 [[define-inference-ui]]
@@ -19,7 +20,7 @@ You can create connectors in *{stack-manage-app} > {connectors-ui}*. For example
 
 [role="screenshot"]
 image::management/connectors/images/inference-connector.png[{inference} connector]
-// NOTE: This is an autogenerated screenshot. Do not edit it directly.
+
 
 [float]
 [[inference-connector-configuration]]
@@ -44,7 +45,8 @@ while creating or editing the connector in {kib}. For example:
 
 [role="screenshot"]
 image::management/connectors/images/inference-completion-params.png[{infer} params test]
-// NOTE: This is an autogenerated screenshot. Do not edit it directly.
+
+
 [float]
 [[inference-connector-actions]]
 === {infer-cap} connector actions
@@ -56,14 +58,17 @@ The {infer} actions have the following configuration properties. Properties depe
 ==== Completion
 
 The following example performs a completion task on the example question.
+
 Input::
 The text on which you want to perform the {infer} task. For example:
 +
-[source,text]
 --
+[source,text]
+------------------------------------------------------------
 {
   input: 'What is Elastic?'
 }
+------------------------------------------------------------
 --
 
 [float]
@@ -71,18 +76,22 @@ The text on which you want to perform the {infer} task. For example:
 ==== Text embedding
 
 The following example performs a text embedding task.
+
 Input::
 The text on which you want to perform the {infer} task. For example:
 +
-[source,text]
 --
+[source,text]
+------------------------------------------------------------
 {
   input: 'The sky above the port was the color of television tuned to a dead channel.',
   task_settings: {
     input_type: 'ingest'
   }
 }
+------------------------------------------------------------
 --
+
 Input type::
 An optional string that overwrites the connector's default model.
 
@@ -91,16 +100,20 @@ An optional string that overwrites the connector's default model.
 ==== Reranking
 
 The following example performs a reranking task on the example input.
+
 Input::
 The text on which you want to perform the {infer} task. Should be a string array. For example:
 +
-[source,text]
 --
+[source,text]
+------------------------------------------------------------
 {
   input: ['luke', 'like', 'leia', 'chewy', 'r2d2', 'star', 'wars'],
   query: 'star wars main character'
 }
+------------------------------------------------------------
 --
+
 Query::
 The search query text.
 
@@ -109,14 +122,17 @@ The search query text.
 ==== Sparse embedding
 
 The following example performs a sparse embedding task on the example sentence.
+
 Input::
 The text on which you want to perform the {infer} task. For example:
 +
-[source,text]
 --
+[source,text]
+------------------------------------------------------------
 {
   input: 'The sky above the port was the color of television tuned to a dead channel.'
 }
+------------------------------------------------------------
 --
 
 [float]