From 2761ea823214a38e6b3131a1be63c3a34c8f845f Mon Sep 17 00:00:00 2001 From: Paul Cornell Date: Fri, 16 Jan 2026 15:04:23 -0800 Subject: [PATCH 1/4] Model settings and configuration for dedicated instance and in-VPC deployments --- business/concepts/models.mdx | 79 ++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 business/concepts/models.mdx diff --git a/business/concepts/models.mdx b/business/concepts/models.mdx new file mode 100644 index 00000000..92d26892 --- /dev/null +++ b/business/concepts/models.mdx @@ -0,0 +1,79 @@ +--- +title: Models +sidebarTitle: Models +--- + + + The following information applies only to dedicated instance and in-VPC deployments of [Unstructured Business](/business/overview). + + +For Unstructured Business dedicated instance and in-VPC deployments, Unstructured requires that you complete special +model configuration steps before you can use any ofthe following features in your Unstructured account: + +- [Partitioning](/ui/partitioning) that uses the **VLM** strategy, or the **Auto** strategy whenever it routes documents or pages to the **VLM** strategy +- [Enrichments](/ui/enriching/overview) +- [Embedding](/ui/embedding) + +Each of these features rely on models that you provide information to Unstructured about. For example, when you have +Unstructured generate embeddings, you must have already configured your Unstructured account with the model's identifier, the model +provider's API key for your account with that provider, and any other miscellaneous settings that the model's provider might also require. + +You must already have an account with the provider of each model that you configure your Unstructured account to use. +Whenever Unstructured uses one of these models, its usage is billed directly to your account with the model's provider. +These third-party charges are not included in your Unstructured account's bill. You are responsible for paying +these third-party bills separately from your Unstructured Business account's bills. If you do not pay these third-party bills +in a timely manner, these Unstructured features might stop working as expected at any time and without any prior notice. + + + The following steps do not apply to **Let's Go**, **Pay-As-You-Go**, or **Business SaaS** accounts. + This is because the costs for using the models that Unstructured provides are already factored into the + pricing models for these account types. + + For Unstructured Business dedicated instance and in-VPC deployments, completing the following steps enables you to + better manage and reduce your overall costs by negotiating lower overall billing rates with Unstructured for its core features, while also + leveraging any separately negotiated volume discounts with the model providers that you want to use. + + +## Add a model to an account + +To have Unstructured use a model, you must first add the model to your Unstructured account, as follows. This procedure +assumes that you have already created an account with the model's provider, generated an API key for your account +with that provider, and obtained any other miscellaneous settings that the model's provider might also require. For +more information, see the model's provider's documentation. + +1. If you are not already signed in, sign in to your Unstructured account. +2. On the sidebar, click your user icon, and then click **Account Settings**. +3. In the top navigation bar, click the **Models** tab. +4. ... + +After you add the model, you must enable it for each Unstructured workspace that wants to use it. +[Learn how](#enable-a-model-for-a-workspace). + +## Enable a model for a workspace + +This procedure assumes that you have already added the model to your Unstructured account. [Learn how](#add-a-model-to-an-account). + +1. 1. If you are not already signed in, sign in to your Unstructured account. +2. On the sidebar, click your user icon, and then click **Account Settings**. +3. In the top navigation bar, click the **Models** tab. +4. ... + +## Update the settings for a model + +After you [add a model](#add-a-model-to-an-account) to your Unstructured account, you can no longer that model's +settings screen to change it. This is by design to prevent users from +accessing sensitive API key strings or other sensitive settings that they might not otherwise be allowed +to access across your organization. + +To update the settings for a model, do the following: + +2. [Add a new collection of settings for the same model](#add-a-model-to-an-account) to your account. +3. [Enable the new collection of settings](#enable-a-model-for-a-workspace) for each Unstructured workspace that wants to use it. +1. [Delete the old model's settings](#delete-a-model) from your Unstructured account. + +## Delete a model + + + + + \ No newline at end of file From b23ae0402d0e0cdba00689ab632013ea88ea707c Mon Sep 17 00:00:00 2001 From: Paul Cornell Date: Tue, 20 Jan 2026 11:27:23 -0800 Subject: [PATCH 2/4] Changed from models to AI providers --- business/concepts/ai-providers.mdx | 88 ++++++++++++++++++++++++++++++ business/concepts/models.mdx | 79 --------------------------- 2 files changed, 88 insertions(+), 79 deletions(-) create mode 100644 business/concepts/ai-providers.mdx delete mode 100644 business/concepts/models.mdx diff --git a/business/concepts/ai-providers.mdx b/business/concepts/ai-providers.mdx new file mode 100644 index 00000000..a4dffa4c --- /dev/null +++ b/business/concepts/ai-providers.mdx @@ -0,0 +1,88 @@ +--- +title: AI providers +--- + + + The following information applies only to dedicated instance and in-VPC deployments of [Unstructured Business](/business/overview). + + +For Unstructured Business dedicated instance and in-VPC deployments, Unstructured requires that you complete special +AI provider configuration steps before you can use any ofthe following features in your Unstructured account: + +- [Partitioning](/ui/partitioning) that uses the **VLM** strategy, or the **Auto** strategy whenever it routes documents or pages to the **VLM** strategy +- [Enrichments](/ui/enriching/overview) +- [Embedding](/ui/embedding) + +Each of these features rely on AI models by AI providers that you give information to Unstructured about. For example, when you have +Unstructured generate embeddings, you must have already configured your Unstructured account with the corresponding AI +provider's API key for your account with that provider, and any other miscellaneous settings that the provider might also require. + +You must already have an account with the AI provider of each model that you configure your Unstructured account to use. +Whenever Unstructured uses one of these models, its usage is billed directly to your account with the model's provider. +These third-party charges are not included in your Unstructured account's bill. You are responsible for paying +these third-party bills separately from your Unstructured Business account's bills. If you do not pay these third-party bills +in a timely manner, these Unstructured features might stop working as expected at any time and without any prior notice. + + + The following steps do not apply to **Let's Go**, **Pay-As-You-Go**, or **Business SaaS** accounts. + This is because the costs for using the models that Unstructured provides are already factored into the + pricing structures for these account types. + + For Unstructured Business dedicated instance and in-VPC deployments, completing the following steps enables you to + better manage and reduce your overall costs by negotiating lower overall billing rates with Unstructured for its core features, while also + leveraging any separately negotiated volume discounts with the AI providers that you want to use. + + +## Enable a provider in your account + +To have Unstructured use an AI model, you must first enable the model's AI provider in your Unstructured account, as follows. This procedure +assumes that you have already created an account with the model's provider, generated an API key for your account +with that provider, and obtained any other miscellaneous settings that the provider might also require. For +more information, see the provider's documentation. + +To enable a provider in your Unstructured account, do the following: + +1. If you are not already signed in, sign in to your Unstructured account. +2. In the top navigation bar, in the organizational account selector, select the name of the organizational account to which you want to add the model. +3. On the sidebar, click your user icon, and then click **Account Settings**. +4. In the top navigation bar, click the **AI Providers** tab. +5. In the list of available providers, next to the target provider's name, click **Configure**. +6. In the **Configure AI Provider** dialog, enter your API key for the provider, along with any other + miscellaneous settings that the provider might also require. +7. In the **Workspaces** drop-down list, select the workspaces that you want to enable the provider for. +8. Click **Save Configuration**. + +## Change the enabled providers for a workspace + +This procedure assumes that you have already enabled the AI provider in your Unstructured account. [Learn how](#enable-a-provider-in-your-account). + +When you [enable a provider in your Unstructured account](##enable-a-provider-in-your-account), you have an initial opportunity to +enable it for each Unstructured workspace that wants to use it. + +To change the list of providers that were previously enabled for a workspace, do the following: + +1. If you are not already signed in, sign in to your Unstructured account. +2. In the top navigation bar, in the organizational account selector, select the name of the organizational account that you want to add the model to. +3. On the sidebar, click your user icon, and then click **Account Settings**. +4. In the top navigation bar, click the **AI Providers** tab. +5. In the list of available workspaces, next to the workspace for which you want to change the enabled providers for, + turn on or off the toggle for each provider that you want to enable or disable for that workspace, respectively. + +## Update the settings for a provider + +After you [enable a provider in your Unstructured account](##enable-a-provider-in-your-account), you can no longer open that provider's +settings screen to make any changes to it. This is by design to prevent users from +accessing sensitive API key strings or other sensitive settings that they might not otherwise be allowed +to access across your organization. + +To update the settings for a provider, do the following: + +1. [Add a new collection of settings for the same provider](#enable-a-provider-in-your-account) in your Unstructured account. +2. [Disable the old provider](#delete-a-model) in your Unstructured account. + +## Disable a provider + + + + + \ No newline at end of file diff --git a/business/concepts/models.mdx b/business/concepts/models.mdx deleted file mode 100644 index 92d26892..00000000 --- a/business/concepts/models.mdx +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Models -sidebarTitle: Models ---- - - - The following information applies only to dedicated instance and in-VPC deployments of [Unstructured Business](/business/overview). - - -For Unstructured Business dedicated instance and in-VPC deployments, Unstructured requires that you complete special -model configuration steps before you can use any ofthe following features in your Unstructured account: - -- [Partitioning](/ui/partitioning) that uses the **VLM** strategy, or the **Auto** strategy whenever it routes documents or pages to the **VLM** strategy -- [Enrichments](/ui/enriching/overview) -- [Embedding](/ui/embedding) - -Each of these features rely on models that you provide information to Unstructured about. For example, when you have -Unstructured generate embeddings, you must have already configured your Unstructured account with the model's identifier, the model -provider's API key for your account with that provider, and any other miscellaneous settings that the model's provider might also require. - -You must already have an account with the provider of each model that you configure your Unstructured account to use. -Whenever Unstructured uses one of these models, its usage is billed directly to your account with the model's provider. -These third-party charges are not included in your Unstructured account's bill. You are responsible for paying -these third-party bills separately from your Unstructured Business account's bills. If you do not pay these third-party bills -in a timely manner, these Unstructured features might stop working as expected at any time and without any prior notice. - - - The following steps do not apply to **Let's Go**, **Pay-As-You-Go**, or **Business SaaS** accounts. - This is because the costs for using the models that Unstructured provides are already factored into the - pricing models for these account types. - - For Unstructured Business dedicated instance and in-VPC deployments, completing the following steps enables you to - better manage and reduce your overall costs by negotiating lower overall billing rates with Unstructured for its core features, while also - leveraging any separately negotiated volume discounts with the model providers that you want to use. - - -## Add a model to an account - -To have Unstructured use a model, you must first add the model to your Unstructured account, as follows. This procedure -assumes that you have already created an account with the model's provider, generated an API key for your account -with that provider, and obtained any other miscellaneous settings that the model's provider might also require. For -more information, see the model's provider's documentation. - -1. If you are not already signed in, sign in to your Unstructured account. -2. On the sidebar, click your user icon, and then click **Account Settings**. -3. In the top navigation bar, click the **Models** tab. -4. ... - -After you add the model, you must enable it for each Unstructured workspace that wants to use it. -[Learn how](#enable-a-model-for-a-workspace). - -## Enable a model for a workspace - -This procedure assumes that you have already added the model to your Unstructured account. [Learn how](#add-a-model-to-an-account). - -1. 1. If you are not already signed in, sign in to your Unstructured account. -2. On the sidebar, click your user icon, and then click **Account Settings**. -3. In the top navigation bar, click the **Models** tab. -4. ... - -## Update the settings for a model - -After you [add a model](#add-a-model-to-an-account) to your Unstructured account, you can no longer that model's -settings screen to change it. This is by design to prevent users from -accessing sensitive API key strings or other sensitive settings that they might not otherwise be allowed -to access across your organization. - -To update the settings for a model, do the following: - -2. [Add a new collection of settings for the same model](#add-a-model-to-an-account) to your account. -3. [Enable the new collection of settings](#enable-a-model-for-a-workspace) for each Unstructured workspace that wants to use it. -1. [Delete the old model's settings](#delete-a-model) from your Unstructured account. - -## Delete a model - - - - - \ No newline at end of file From 074c931d94e49bbe22b2e9ebdebcce9bd7dbb473 Mon Sep 17 00:00:00 2001 From: Paul Cornell Date: Tue, 10 Feb 2026 16:39:35 -0800 Subject: [PATCH 3/4] Added missing steps to AI provider configuration --- business/ai-providers.mdx | 95 ++++++++++++++++++++++++++++++ business/concepts/ai-providers.mdx | 88 --------------------------- docs.json | 3 +- 3 files changed, 97 insertions(+), 89 deletions(-) create mode 100644 business/ai-providers.mdx delete mode 100644 business/concepts/ai-providers.mdx diff --git a/business/ai-providers.mdx b/business/ai-providers.mdx new file mode 100644 index 00000000..c2acac89 --- /dev/null +++ b/business/ai-providers.mdx @@ -0,0 +1,95 @@ +--- +title: AI providers +--- + + + The following information applies only to **dedicated instance** and **in-VPC** deployments of [Unstructured Business](/business/overview). + + +For Unstructured Business **dedicated instance** and **in-VPC** deployments, Unstructured requires that you complete special +AI provider configuration steps before you can use any of the following features in your Unstructured account: + +- [Partitioning](/ui/partitioning) that uses the **VLM** strategy, or the **Auto** strategy whenever it routes documents or pages to the **VLM** strategy +- [Enrichments](/ui/enriching/overview) +- [Structured data extraction](/ui/data-extractor) +- [Embedding](/ui/embedding) + +Each of these features rely on AI models by AI providers that you give information to Unstructured about. For example, when you have +Unstructured generate embeddings, you must have already configured your Unstructured account with the corresponding AI +provider's access credentials for your account with that AI provider, and any other miscellaneous settings that the AI provider might also require. + +You must already have an account with the AI provider of each model that you configure your Unstructured account to use. +Whenever Unstructured uses one of these models, its usage is billed directly to your account with the model's AI provider. +These third-party charges are not included in your Unstructured account's bill. You are responsible for paying +these third-party bills separately from your Unstructured account's bills. If you do not pay these third-party bills +in a timely manner, these Unstructured features might stop working as expected at any time and without any prior notice. + + + The following steps do not apply to **Let's Go**, **Pay-As-You-Go**, or **Business SaaS** accounts. + This is because the costs for using the models that Unstructured provides are already factored into the + pricing structures for these account types. + + For Unstructured Business **dedicated instance** and **in-VPC** deployments, completing the following steps enables you to + better manage and reduce your overall costs by negotiating lower overall billing rates with Unstructured for its core features, while also + leveraging any separately negotiated volume discounts with the AI providers that you want to use. + + +## Configure an AI provider + +To have Unstructured use an AI model, you must first configure the model's AI provider for each target Unstructured +[workspace](/ui/account/workspaces) within each corresponding Unstructured [organizational account](/ui/account/organizations) in +your **dedicated instance** or **in-VPC** deployment, as follows. + +This procedure assumes that you have already created an account with the model's AI provider, generated access credentials for your account +with that AI provider, and obtained any other miscellaneous settings that the AI provider might also require. For +more information, see the AI provider's documentation. + +To configure an AI provider for a workspace, do the following: + +1. If you are not already signed in, sign in to your Unstructured account. +2. In the top navigation bar, in the organizational account selector, select the name of the organizational account to which + the target workspace belongs. +3. Next to the organizational account selector, click the workspace selector, and then select the name of the target workspace. +4. In the workspace navigation bar, click the **AI Providers** tab. +5. In the list of available AI providers, next to the target AI provider's name, click **Configure**. +6. In the **Configure AI Provider** dialog, enter your access credentials for the AI provider, along with any other + miscellaneous settings that the AI provider might also require. To get these settings, see your AI provider's documentation. +7. Click **Save Configuration**. + +The configured AI provider is now ready to be used by all workflows in this workspace. + +## Update an AI provider's configuration + +After you [configure an AI provider](#configure-an-ai-provider), you can no longer open that AI provider's +settings screen to make any changes to it. This is by design to prevent users from +accessing sensitive access credentials strings or other sensitive settings that they might not otherwise be allowed +to access across your organization. + +To update the settings for an AI provider, do the following: + +1. [Delete the target AI provider's current configuration](#delete-an-ai-provider's-configuration). +2. [Configure the target AI provider again](#configure-an-ai-provider). + +## Delete an AI provider's configuration + + + After you delete an AI provider's configuration, any workflows in the selected workspace that rely on this AI provider + might produce unexpected results or stop working altogether. + + +To delete an AI provider's configuration, do the following: + +1. If you are not already signed in, sign in to your Unstructured account. +2. In the top navigation bar, in the organizational account selector, select the name of the organizational account to which + the workspace with the target AI provider's configuration belongs. +3. Next to the organizational account selector, click the workspace selector, and then select the name of the target workspace. +4. In the workspace navigation bar, click the **AI Providers** tab. +5. In the list of AI providers, next to the target AI provider's name, click the ellipsis (three dots) icon. +6. Click **Delete Configuration**. +7. To confirm the deletion, click **Delete Configuration**. + +You can [configure the target AI provider again](#configure-an-ai-provider) at any time. + +## No API support for AI provider management + +You cannot use the Unstructured API to manage AI providers. You can manage AI providers only through the Unstructured UI. \ No newline at end of file diff --git a/business/concepts/ai-providers.mdx b/business/concepts/ai-providers.mdx deleted file mode 100644 index a4dffa4c..00000000 --- a/business/concepts/ai-providers.mdx +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: AI providers ---- - - - The following information applies only to dedicated instance and in-VPC deployments of [Unstructured Business](/business/overview). - - -For Unstructured Business dedicated instance and in-VPC deployments, Unstructured requires that you complete special -AI provider configuration steps before you can use any ofthe following features in your Unstructured account: - -- [Partitioning](/ui/partitioning) that uses the **VLM** strategy, or the **Auto** strategy whenever it routes documents or pages to the **VLM** strategy -- [Enrichments](/ui/enriching/overview) -- [Embedding](/ui/embedding) - -Each of these features rely on AI models by AI providers that you give information to Unstructured about. For example, when you have -Unstructured generate embeddings, you must have already configured your Unstructured account with the corresponding AI -provider's API key for your account with that provider, and any other miscellaneous settings that the provider might also require. - -You must already have an account with the AI provider of each model that you configure your Unstructured account to use. -Whenever Unstructured uses one of these models, its usage is billed directly to your account with the model's provider. -These third-party charges are not included in your Unstructured account's bill. You are responsible for paying -these third-party bills separately from your Unstructured Business account's bills. If you do not pay these third-party bills -in a timely manner, these Unstructured features might stop working as expected at any time and without any prior notice. - - - The following steps do not apply to **Let's Go**, **Pay-As-You-Go**, or **Business SaaS** accounts. - This is because the costs for using the models that Unstructured provides are already factored into the - pricing structures for these account types. - - For Unstructured Business dedicated instance and in-VPC deployments, completing the following steps enables you to - better manage and reduce your overall costs by negotiating lower overall billing rates with Unstructured for its core features, while also - leveraging any separately negotiated volume discounts with the AI providers that you want to use. - - -## Enable a provider in your account - -To have Unstructured use an AI model, you must first enable the model's AI provider in your Unstructured account, as follows. This procedure -assumes that you have already created an account with the model's provider, generated an API key for your account -with that provider, and obtained any other miscellaneous settings that the provider might also require. For -more information, see the provider's documentation. - -To enable a provider in your Unstructured account, do the following: - -1. If you are not already signed in, sign in to your Unstructured account. -2. In the top navigation bar, in the organizational account selector, select the name of the organizational account to which you want to add the model. -3. On the sidebar, click your user icon, and then click **Account Settings**. -4. In the top navigation bar, click the **AI Providers** tab. -5. In the list of available providers, next to the target provider's name, click **Configure**. -6. In the **Configure AI Provider** dialog, enter your API key for the provider, along with any other - miscellaneous settings that the provider might also require. -7. In the **Workspaces** drop-down list, select the workspaces that you want to enable the provider for. -8. Click **Save Configuration**. - -## Change the enabled providers for a workspace - -This procedure assumes that you have already enabled the AI provider in your Unstructured account. [Learn how](#enable-a-provider-in-your-account). - -When you [enable a provider in your Unstructured account](##enable-a-provider-in-your-account), you have an initial opportunity to -enable it for each Unstructured workspace that wants to use it. - -To change the list of providers that were previously enabled for a workspace, do the following: - -1. If you are not already signed in, sign in to your Unstructured account. -2. In the top navigation bar, in the organizational account selector, select the name of the organizational account that you want to add the model to. -3. On the sidebar, click your user icon, and then click **Account Settings**. -4. In the top navigation bar, click the **AI Providers** tab. -5. In the list of available workspaces, next to the workspace for which you want to change the enabled providers for, - turn on or off the toggle for each provider that you want to enable or disable for that workspace, respectively. - -## Update the settings for a provider - -After you [enable a provider in your Unstructured account](##enable-a-provider-in-your-account), you can no longer open that provider's -settings screen to make any changes to it. This is by design to prevent users from -accessing sensitive API key strings or other sensitive settings that they might not otherwise be allowed -to access across your organization. - -To update the settings for a provider, do the following: - -1. [Add a new collection of settings for the same provider](#enable-a-provider-in-your-account) in your Unstructured account. -2. [Disable the old provider](#delete-a-model) in your Unstructured account. - -## Disable a provider - - - - - \ No newline at end of file diff --git a/docs.json b/docs.json index 560fc477..62251f89 100644 --- a/docs.json +++ b/docs.json @@ -322,7 +322,8 @@ { "group": "Business", "pages": [ - "business/overview" + "business/overview", + "business/ai-providers" ] }, { From 701d85273e0abbdd91a55e3fbc1939e02f6a858b Mon Sep 17 00:00:00 2001 From: Paul-Cornell Date: Mon, 23 Feb 2026 07:54:43 -0800 Subject: [PATCH 4/4] Apply suggestions from code review --- business/ai-providers.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/business/ai-providers.mdx b/business/ai-providers.mdx index c2acac89..c27bd101 100644 --- a/business/ai-providers.mdx +++ b/business/ai-providers.mdx @@ -47,8 +47,7 @@ more information, see the AI provider's documentation. To configure an AI provider for a workspace, do the following: 1. If you are not already signed in, sign in to your Unstructured account. -2. In the top navigation bar, in the organizational account selector, select the name of the organizational account to which - the target workspace belongs. +2. In the top navigation bar, in the organizational account selector, select the name of the organizational account to which the target workspace belongs. 3. Next to the organizational account selector, click the workspace selector, and then select the name of the target workspace. 4. In the workspace navigation bar, click the **AI Providers** tab. 5. In the list of available AI providers, next to the target AI provider's name, click **Configure**.