+ |
+ AI Nutrition Facts
+
+
+ Suggested Mappings
+ |
+
+ |
+ Description
+
+
+ Suggested Mappings automates the mapping of a source (ex: data warehouse, event streams, and connections to destination fields, providing you with smart suggestions while allowing you to tweak and perfect each mapping.
+ |
+
+
+ Privacy Ladder Level
+ 1
+ |
+
+
+
+ Feature is Optional
+ Yes
+ |
+
+ Model Type
+ Generative
+ |
+
+
+ Base Model
+ OpenAI - GPT-3.5
+ |
+
+
+ Trust Ingredients
+ |
+
+
+ |
+ Base Model Trained with Customer Data
+ No
+ |
+
+
+ Customer Data is Shared with Model Vendor
+ Yes
+ |
+
+
+ Training Data Anonymized
+ N/A
+ |
+
+
+ Data Deletion
+ Yes
+ |
+
+
+ Human in the Loop
+ Yes
+ |
+
+
+ Data Retention
+ 30 days
+ |
+
+
+ Compliance
+ Logging & Auditing
+ No
+ Guardrails
+ Yes
+ |
+
+
+ Input/Output Consistency
+ No
+ |
+
+
+ Other Resources
+ |
+
+
+
\ No newline at end of file
diff --git a/src/connections/destinations/actions.md b/src/connections/destinations/actions.md
index 9161000ad5..bb8852d078 100644
--- a/src/connections/destinations/actions.md
+++ b/src/connections/destinations/actions.md
@@ -57,7 +57,8 @@ To set up a new Actions-framework destination for the first time:
4. If prompted, select the source you want to connect to the new destination.
5. Enter your credentials. This could be an API Key and secret key, or similar information that allows the destination to connect to your account.
6. Next, choose how you want to set up the destination, and click **Configure Actions**.
- You can choose **Quick Setup** to use the default mappings, or choose **Customized Setup** (if available) to create new mappings and conditions from a blank state. You can always edit these mappings later.
+ * You can choose **Quick Setup** to use the default mappings, or choose **Customized Setup** (if available) to create new mappings and conditions from a blank state. You can always edit these mappings later.
+ * *(Optional)* Click **Suggest Mappings** to get suggested mappings. Learn more about [suggested mappings](#suggested-mappings).
7. Once you're satisfied with your mappings, click **Create Destination**.
> info ""
@@ -188,6 +189,16 @@ If necessary, click **New Mapping** to create a new, blank action.
> info ""
> The required fields for a destination mapping appear automatically. Click the + sign to see optional fields.
+## Suggested mappings
+
+> info ""
+> Suggested mappings is fully available for RETL mappings, and is in public beta for event streams and connections.
+
+Segment offers suggested mappings that automatically propose relevant destination fields for both model columns and payload elements. For example, if your model includes a column or payload field named `transaction_amount`, the feature might suggest mapping it to a destination field like `Amount` or `TransactionValue`. This automation, powered by intelligent autocompletion, matches and identifies near-matching field names to streamline the setup. For more information, see [Segment's suggested mappings blogpost](https://segment.com/blog/ai-assisted-magical-mappings/){:target="_blank”} and the [Suggested Mappings Nutrition Label](/docs/connections/reverse-etl/suggested-mappings-nutrition-facts).
+
+> warning ""
+> Review the suggested mappings for accuracy before finalizing them as the suggestions aren't guaranteed to be 100% accurate.
+
### Coalesce function
The coalesce function takes a primary value and uses it if it is available. If the value isn't available, the function uses the fallback value instead.
diff --git a/src/connections/reverse-etl/setup.md b/src/connections/reverse-etl/setup.md
index 2039d73116..4272485914 100644
--- a/src/connections/reverse-etl/setup.md
+++ b/src/connections/reverse-etl/setup.md
@@ -88,7 +88,7 @@ To create a mapping:
* Deleted records
7. In the **Map fields** section, define how to map the record columns from your model to your destination. Map the fields that come from your source to fields that the destination expects to find. Fields on the destination side depend on the type of Action selected.
* If you’re setting up a Destination Action, some mapping fields might require data to be in the form of an object or array. See the [supported objects and arrays for mapping](/docs/connections/reverse-etl/manage-retl/#supported-object-and-arrays) for more information.
-
+ * _(Optional)_ Use the [Suggested Mappings](#suggested-mappings) feature to identify and match near-matching field names to streamline the field mapping process.
8. In the **Send test record section**, select a test record to preview the fields that you mapped to your destination. When you've verified that the records appear as expected, click **Next**.
9. Enter a name for your mapping. The name initially defaults to the Action's name, for example, `Track Event`, but you can make changes to this default name.
10. Select how often you want Segment to sync your data under **Schedule configuration**.
@@ -196,6 +196,16 @@ To edit your model:
4. Click the **Settings** tab to edit the model name or change the schedule settings.
+### Suggested mappings
+
+> info ""
+> Suggested mappings is fully available for RETL mappings.
+
+Segment offers suggested mappings that automatically propose relevant destination fields for model columns and payload elements. For example, if your model includes a column or payload field named `transaction_amount`, the feature might suggest mapping it to a destination field like `Amount` or `TransactionValue`. This automation, powered by intelligent autocompletion, matches and identifies near-matching field names to streamline the mappings setup process. For more information, see [Segment's suggested mappings blog post](https://segment.com/blog/ai-assisted-magical-mappings/){:target="_blank”} and the [Suggested Mappings Nutrition Facts Label](/docs/connections/reverse-etl/suggested-mappings-nutrition-facts).
+
+> warning ""
+> Review the suggested mappings for accuracy before finalizing them, as Segment can't guarantee all of the suggested mappings are accurate.
+
### Edit your mapping
To edit your mapping:
diff --git a/src/connections/reverse-etl/suggested-mappings-nutrition-facts.md b/src/connections/reverse-etl/suggested-mappings-nutrition-facts.md
new file mode 100644
index 0000000000..ec044c45fa
--- /dev/null
+++ b/src/connections/reverse-etl/suggested-mappings-nutrition-facts.md
@@ -0,0 +1,7 @@
+---
+title: Suggested Mappings Nutrition Facts Label
+---
+
+Twilio’s [AI Nutrition Facts](https://nutrition-facts.ai/){:target="_blank"} provide an overview of the AI feature you’re using, so you can better understand how the AI is working with your data. Suggested Mappings's AI qualities are outlined in the following Nutrition Facts label. For more information, including the glossary regarding the AI Nutrition Facts label, refer to the [AI Nutrition Facts](https://nutrition-facts.ai/){:target="_blank"} page.
+
+{% include content/suggested-mappings-nutrition-facts.html %}
\ No newline at end of file