opensearch-docs-cn/_ml-commons-plugin/index.md

26 lines
2.0 KiB
Markdown
Raw Normal View History

---
layout: default
title: About ML Commons
nav_order: 1
has_children: false
has_toc: false
nav_exclude: true
---
# ML Commons plugin
ML Commons for OpenSearch eases the development of machine learning features by providing a set of common machine learning (ML) algorithms through transport and REST API calls. Those calls choose the right nodes and resources for each ML request and monitors ML tasks to ensure uptime. This allows you to leverage existing open-source ML algorithms and reduce the effort required to develop new ML features.
Interaction with the ML Commons plugin occurs through either the [REST API]({{site.url}}{{site.baseurl}}/ml-commons-plugin/api) or [`ad`]({{site.url}}{{site.baseurl}}/search-plugins/sql/ppl/functions#ad) and [`kmeans`]({{site.url}}{{site.baseurl}}/search-plugins/sql/ppl/functions#kmeans) Piped Processing Language (PPL) commands.
Add model access control documentation for ML Commons (#4223) * Add model access control documentation for ML Commons Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Remove permissions for delete API Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Add copy buttons Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Updated model-level APIs Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Add delete model Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Reworded role-related text Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Implemented tech review comments Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Rewording Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Remove experimental warning Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Register a model group in note format Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Implement tech review comments Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Resolved Vale comments Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Remove space Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Apply suggestions from code review Co-authored-by: Chris Moore <107723039+cwillum@users.noreply.github.com> Signed-off-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> * Implemented doc review feedback Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Implemented editorial comments Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Apply suggestions from code review Co-authored-by: Melissa Vagi <vagimeli@amazon.com> Signed-off-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> * Add more editorial comments Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Add more editorial comments Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Fix links Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Fix more links Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> --------- Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> Signed-off-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Co-authored-by: Chris Moore <107723039+cwillum@users.noreply.github.com> Co-authored-by: Melissa Vagi <vagimeli@amazon.com>
2023-06-19 15:25:13 -04:00
Models [trained]({{site.url}}{{site.baseurl}}/ml-commons-plugin/api#training-the-model) through the ML Commons plugin support model-based algorithms such as k-means. After you've trained a model enough so that it meets your precision requirements, you can apply the model to [predict]({{site.url}}{{site.baseurl}}/ml-commons-plugin/api#predict) new data safely.
Should you not want to use a model, you can use the [Train and Predict]({{site.url}}{{site.baseurl}}/ml-commons-plugin/api#train-and-predict) API to test your model without having to evaluate the model's performance.
Ml commons (#5017) * Adding ML Node to cluster settings page Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> * Removed Permissions and Cluster Settings from index; added roles to model access control Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> * Referenced code sample was for local connector not external Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> * Updated ML index page to refrence the order to get started with ML Commons. Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> * Fixing style errors. Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> * Update _ml-commons-plugin/cluster-settings.md Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/extensibility/connectors.md Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> --------- Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Co-authored-by: Nathan Bower <nbower@amazon.com>
2023-09-21 14:44:19 -04:00
## Using ML Commons
Ml commons (#5017) * Adding ML Node to cluster settings page Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> * Removed Permissions and Cluster Settings from index; added roles to model access control Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> * Referenced code sample was for local connector not external Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> * Updated ML index page to refrence the order to get started with ML Commons. Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> * Fixing style errors. Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> * Update _ml-commons-plugin/cluster-settings.md Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/extensibility/connectors.md Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> * Update _ml-commons-plugin/index.md Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> --------- Signed-off-by: David Tippett <17506770+dtaivpp@users.noreply.github.com> Signed-off-by: David Tippett <Dtaivpp@gmail.com> Co-authored-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Co-authored-by: Nathan Bower <nbower@amazon.com>
2023-09-21 14:44:19 -04:00
1. Ensure that you've appropriately set the cluster settings described in [Cluster Settings]({{site.url}}{{site.baseurl}}/ml-commons-plugin/cluster-settings/).
2. Set up model access as described in [Model Access Control]({{site.url}}{{site.baseurl}}/ml-commons-plugin/model-access-control/).
3. Start using models:
- [ML Framework]({{site.url}}{{site.baseurl}}/ml-commons-plugin/ml-framework/) allows you to run models within OpenSearch.
- [ML Extensibility]({{site.url}}{{site.baseurl}}/ml-commons-plugin/extensibility/index/) allows you to access remote models.