Reorder content in ext ai reference

geldata · Feb 21, 2025 · 88e8bb9 · 88e8bb9
1 parent c66ead2
commit 88e8bb9
Showing 1 changed file with 43 additions and 44 deletions.
diff --git a/docs/ai/extai.rst b/docs/ai/extai.rst
@@ -93,13 +93,11 @@ Enables management of API configurations for AI API providers.
     :width: 100%
 
 
-Built-in resources
-==================
 
 .. _ref_ai_extai_reference_index:
 
 Index
------
+=====
 
 The ``ext::ai::index`` creates a deferred semantic similarity index of an
 expression on a type.
@@ -137,45 +135,6 @@ Parameters:
 * ``truncate_to_max``: bool (Default: False)
 
 
-.. _ref_ai_extai_reference_embedding_models:
-
-Embedding models
-----------------
-
-OpenAI (`documentation <https://platform.openai.com/docs/guides/embeddings/embedding-models>`__)
-
-* ``text-embedding-3-small``
-* ``text-embedding-3-large``
-* ``text-embedding-ada-002``
-
-Mistral (`documentation <https://docs.mistral.ai/capabilities/embeddings/#mistral-embeddings-api>`__)
-
-* ``mistral-embed``
-
-
-.. _ref_ai_extai_reference_text_generation_models:
-
-Text generation models
-----------------------
-
-OpenAI (`documentation <https://platform.openai.com/docs/guides/text-generation>`__)
-
-* ``gpt-3.5-turbo``
-* ``gpt-4-turbo-preview``
-
-Mistral (`documentation <https://docs.mistral.ai/getting-started/models/>`__)
-
-* ``mistral-small-latest``
-* ``mistral-medium-latest``
-* ``mistral-large-latest``
-
-Anthropic (`documentation <https://docs.anthropic.com/claude/docs/models-overview>`__)
-
-* ``claude-3-haiku-20240307``
-* ``claude-3-sonnet-20240229``
-* ``claude-3-opus-20240229``
-
-
 Functions
 =========
 
@@ -272,8 +231,8 @@ Functions
         }
 
 
-Types
-=====
+Scalar and Object Types
+=======================
 
 Provider Configuration Types
 ----------------------------
@@ -350,6 +309,45 @@ Example provider configuration:
 Model Types
 -----------
 
+.. _ref_ai_extai_reference_embedding_models:
+
+Embedding models
+^^^^^^^^^^^^^^^^
+
+OpenAI (`documentation <https://platform.openai.com/docs/guides/embeddings/embedding-models>`__)
+
+* ``text-embedding-3-small``
+* ``text-embedding-3-large``
+* ``text-embedding-ada-002``
+
+Mistral (`documentation <https://docs.mistral.ai/capabilities/embeddings/#mistral-embeddings-api>`__)
+
+* ``mistral-embed``
+
+
+.. _ref_ai_extai_reference_text_generation_models:
+
+Text generation models
+^^^^^^^^^^^^^^^^^^^^^^
+
+OpenAI (`documentation <https://platform.openai.com/docs/guides/text-generation>`__)
+
+* ``gpt-3.5-turbo``
+* ``gpt-4-turbo-preview``
+
+Mistral (`documentation <https://docs.mistral.ai/getting-started/models/>`__)
+
+* ``mistral-small-latest``
+* ``mistral-medium-latest``
+* ``mistral-large-latest``
+
+Anthropic (`documentation <https://docs.anthropic.com/claude/docs/models-overview>`__)
+
+* ``claude-3-haiku-20240307``
+* ``claude-3-sonnet-20240229``
+* ``claude-3-opus-20240229``
+
+
 .. list-table::
     :class: funcoptable
 
@@ -385,6 +383,7 @@ Model Types
     * ``embedding_model_supports_shortening`` - Input shortening support flag
 
 
+
 ---------
 
 .. eql:type:: ext::ai::TextGenerationModel