Browse Source

[DOCS] Expands inference API main page info (#111830)

István Zoltán Szabó 1 year ago
parent
commit
7f67ba9958

BIN
docs/reference/inference/images/inference-landscape.png


+ 20 - 6
docs/reference/inference/inference-apis.asciidoc

@@ -5,14 +5,16 @@
 experimental[]
 
 IMPORTANT: The {infer} APIs enable you to use certain services, such as built-in
-{ml} models (ELSER, E5), models uploaded through Eland, Cohere, OpenAI, Azure, Google AI Studio or
-Hugging Face. For built-in models and models uploaded through Eland, the {infer}
-APIs offer an alternative way to use and manage trained models. However, if you
-do not plan to use the {infer} APIs to use these models or if you want to use
-non-NLP models, use the <<ml-df-trained-models-apis>>.
+{ml} models (ELSER, E5), models uploaded through Eland, Cohere, OpenAI, Azure,
+Google AI Studio or Hugging Face. For built-in models and models uploaded
+through Eland, the {infer} APIs offer an alternative way to use and manage
+trained models. However, if you do not plan to use the {infer} APIs to use these
+models or if you want to use non-NLP models, use the
+<<ml-df-trained-models-apis>>.
 
 The {infer} APIs enable you to create {infer} endpoints and use {ml} models of
-different providers - such as Cohere, OpenAI, or HuggingFace - as a service. Use
+different providers - such as Amazon Bedrock, Anthropic, Azure AI Studio,
+Cohere, Google AI, Mistral, OpenAI, or HuggingFace - as a service. Use
 the following APIs to manage {infer} models and perform {infer}:
 
 * <<delete-inference-api>>
@@ -20,6 +22,18 @@ the following APIs to manage {infer} models and perform {infer}:
 * <<post-inference-api>>
 * <<put-inference-api>>
 
+[[inference-landscape]]
+.A representation of the Elastic inference landscape
+image::images/inference-landscape.png[A representation of the Elastic inference landscape,align="center"]
+
+An {infer} endpoint enables you to use the corresponding {ml} model without
+manual deployment and apply it to your data at ingestion time through
+<<semantic-search-semantic-text, semantic text>>. 
+
+Choose a model from your provider or use ELSER – a retrieval model trained by 
+Elastic –, then create an {infer} endpoint by the <<put-inference-api>>.
+Now use <<semantic-search-semantic-text, semantic text>> to perform
+<<semantic-search, semantic search>> on your data.
 
 include::delete-inference.asciidoc[]
 include::get-inference.asciidoc[]