アプリケーションテンプレート¶

Application templates (app templates) are comprehensive, end-to-end "recipes" designed to accelerate the development and operation of Generative and Predictive AI use cases. These templates include all necessary assets, with customizable components, enabling teams to quickly implement tailored AI solutions. They cover three core elements: AI logic, app logic, and infrastructure as code to manage resources, providing a ready-to-use foundation for all three. Most Application Templates are freely available to all users, but some require access to specific features, like GenAI or Time Series, for full functionality. Additionally, certain templates are only available with premium SKUs, such as the SAP integration SKU.

The officially supported templates available in DataRobot are:

• Agentic Starter
• ガード付きRAGアシスタント
• 予測アシスタント
• 予測コンテンツジェネレーター
• 予測AIスターター
• データと会話するエージェント
• Talk to My Docs Agent

This guide provides instructions for making DataRobot-built application templates available for self-managed users running DataRobot in air-gapped environments (no internet access). It's intended for organizations with internal air-gapped GitHub/GitLab.

The officially supported DataRobot templates are installed at the same time DataRobot is installed, so there is no need to run migrations or other scripts to get started with them.

Add templates to the gallery¶

You can download and .zip /.tar the available templates to your organization's gallery using the URLs for each template repository below. Verify the URL is pointing to the right release branch, e.g., release/11.1.

• ガード付きRAGアシスタント

• 予測アシスタント

• 予測コンテンツジェネレーター

• Predictive AI Starter

• Talk to My Data Agent

• Talk to My Docs Agent

A list of all required dependencies are provided in each template's requirements.txt file.

Below are two methods for adding templates to the Gallery, allowing users to discover them easily in the product experience: via terminal or via UI.

Via the terminal¶

To add an app template, you'll need an org admin API token and the template details. Then, you can upload the template using a cURL request like this:

curl --location '<YOUR-HOST>/api/v2/applicationTemplates/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN>' \
--data '{"name": "SAP Integration Template", "description": "A template for enabling users to rapidly integrate with SAP", "tags": ["genai", "sap"], "repository": {"url": "https://github.com/datarobot/SapIntegration", "tag": "11.1", "isPublic": true}}' \
--form 'readme=@"path/to/readme/file"' \
--form 'media=@"path/to/media.gif"' 

Note that this is an example and the information about the template (e.g., URL, names, descriptions, etc.) may be stored elsewhere.

The media is optional and can be added later. All templates come with some media (usually an animated .gif) and it is important because it's part of a "hook" for getting users curious and excited about the template. To add media to a template (if you didn't add it on-create), run:

curl --location '<YOUR-HOST>/api/v2/applicationTemplates/<TEMPLATE-ID>/media/' \
--header 'Authorization: Bearer <TOKEN>' \
--form 'file=@"<PATH-TO-YOUR-FILE>"' 

Via the UI¶

To add templates using the UI, follow these steps:

1. Become an Org Admin. First, ensure that you are an Org Admin. You can assign this role in the user administration panel by navigating to Users > Membership and updating your role. |

   

2. Disable Public Templates. If your environment is air-gapped, you need to disable public templates because they point to public repositories that aren't accessible in air-gapped environments. Set the eng config DISABLED_APP_TEMPLATES value to [‘*’]. This action hides the DataRobot-built templates from the gallery.

   

3. Add Templates to Internal Repository. Use the compressed (.tar/.zip) files for the templates, which were brought into your environment during the install. Upload these files to your internal air-gapped GitHub/GitLab repository.

4. Add templates to the gallery: In the DataRobot Application Gallery, click "Add Template".

   

5. Configure templates in the gallery: Configure the following based on information in the table below.

   

Redirect built-in templates to an internal git mirror¶

If your environment has an internal git server (for example, a self-hosted GitLab or GitHub Enterprise instance) that mirrors the datarobot-community GitHub organization, you can set the APPLICATION_TEMPLATE_GIT_BASE_URL environment variable to automatically redirect all built-in template clones to your mirror. This is simpler than disabling and manually re-adding each template.

Add the variable to your Helm values file under core.config_env_vars and run helm upgrade:

core:
  config_env_vars:
    APPLICATION_TEMPLATE_GIT_BASE_URL: https://gitlab.corp.example.com/datarobot-community 

When this variable is set, any template whose repository URL begins with https://github.com/datarobot-community/ is automatically rewritten before the codespace clone is initiated. 例：

Only URLs that start with https://github.com/datarobot-community/ are rewritten. Templates pointing to other organizations are unaffected.

Remove DataRobot-supported templates¶

You can remove some or all officially supported templates from an environment before or during install. You may want to do this, for example, because a template requires a function your organization did not purchase (e.g.,GenAI or time series). To remove an officially supported DataRobot template from the list of available templates, add:

export DISABLED_APP_TEMPLATES='["<id-of-template-here>", "<id-of-other-template>"]' 

To remove all global templates you can define:

export DISABLED_APP_TEMPLATES='["*"]' 

Additional information¶

• Repository Structure: Each template repository contains a requirements.txt file that lists the necessary dependency pins. These are included to facilitate security and compatibility approvals, ensuring that all required components are correctly identified for your environment.
• Repository Packaging: All repositories is provided as compressed files (tarred/zipped) and brought into your environment during the DataRobot installation process. This ensures that the entire package is ready for deployment in environments with restricted internet access.
• Template Gallery: The template gallery is configured to prevent links to public GitHub repositories. This ensures there are no broken links or inaccessible content in air-gapped environments, providing a seamless experience.

Performance considerations¶

• Application Resource Bundle: Consider increasing the Application Resource Bundle Size with more CPU and Memory for large dataset processing. The default Bundle size is XL. For dataset bigger than 200 MB with Talk to My Data Agent Application, consider using the Remote Registry option with Spark SQL query.
• Application Replicas: Consider increasing Replicas of Applications to support concurrent users. Consider enabling session affinity with multiple replicas, so that each user's request can go to the specific replica.
• Custom Model Scaling: LLM performance can vary from model to model. LLM inference time is typically around 20 to 25 seconds with GPT models. Consider tuning the Autoscaling settings of the Custom Model if latency is high to wait for the LLM response.

Agentic Starter template information¶

The following sections apply to the Agentic Starter application template.

Troubleshoot the Agentic Starter template¶

The Agentic Starter application template is pulled from GitHub repositories at runtime rather than bundled with the DataRobot release. DataRobot 11.6 and later use a soft_pin approach to lock each self-managed release to a known compatible template version, so users receive a stable experience instead of the main branch, which may drift and become incompatible. Each new DataRobot release is automatically soft-pinned to its corresponding template version (for example, 11.7 to ~=11.7.0, 11.8 to ~=11.8.0, and so on), so no manual documentation or configuration updates are required when upgrading. Support for the soft_pin configuration field is available starting from DataRobot 11.4. DataRobot 11.3 does not support soft_pin; on 11.3 you must pin the template by setting tag to a specific compatible tag (for example 11.6.0) instead.

Fix a broken Agentic Starter template¶

Because the template is fetched from GitHub at runtime, the main branch may introduce dependencies on newer uv interfaces, execution environments, or features that are not present in older DataRobot versions. Starting from 11.6, every DataRobot release automatically soft-pins the Agentic Starter application template to the corresponding template version (11.6 to ~=11.6.0, 11.7 to ~=11.7.0, etc.). In this way, the template stays compatible without manual intervention. DataRobot 11.4 and 11.5 also support soft_pin when you manually add or replace a template. If a DataRobot version falls behind, the pinned template version may no longer match the platform capabilities.

Applicable to DataRobot 11.3, 11.4, or 11.5¶

If the default Agentic Starter application template stops working on DataRobot 11.3, 11.4, or 11.5, replace it with a compatible version pinned to the last known stable release. Use the configuration that matches your DataRobot version:

• DataRobot 11.3: soft_pin is not supported. Set tag to a specific compatible tag (for example 11.6.0) instead of using soft_pin. See the compatibility matrix for the recommended tag.
• DataRobot 11.4 or 11.5: Use soft_pin: ~=11.6.0. The soft_pin field tells DataRobot to pull the latest tag of 11.6.x series.

Follow the steps corresponding to your DataRobot version below to set the soft_pin field.

1. Disable the default Agentic Starter application template by adding its ID to DISABLED_APP_TEMPLATES:

   export DISABLED_APP_TEMPLATES='["69090966c601dbd8c8514516"]' 
   

2. Add a compatible replacement template. Use one of the following configurations.

   On DataRobot 11.3 (use a fixed tag; soft_pin is not supported):

   tags: [genai, new]
   repository:
     url: https://github.com/datarobot-community/datarobot-agent-application
     branch: main
     tag: "11.6.0"   # latest 11.3-compatible tag; no soft_pin on 11.3
     is_public: True
   ports:
     - port: 5173
       description: Frontend - VITE
     - port: 8080
       description: Web - FastAPI
     - port: 8842
       description: Agent Workflow - Multi-agent Framework
   en:
     name: Agentic Starter (stable)
     description: >-
       A production-ready template for building and deploying multi-agent applications.
       It includes a FastAPI backend, a React frontend, and a built-in MCP server.
       The example multi-agent template illustrates 2 agents that handle content creation tasks,
       including planning and writing blog posts.
       Requirements: GenAI, MLOps
     readme: >-
       - **Multi-agent workflows:** Build sophisticated agentic systems with popular frameworks.
       - **Modern stack:** FastAPI backend and React frontend.
       - **MCP integration:** Built-in Model Context Protocol (MCP) server for tool interoperability.
       - **Dev to prod:** Local development/testing and one-command deployment to DataRobot.
       - **Minimal setup:** Start quickly with sane defaults and low boilerplate.
       - **Enterprise security:** Aligned with DataRobot security and governance standards.
       - **LLM choice:** Swap LLMs from supported providers via DataRobot's LLM Gateway, use a deployed LLM custom model, or use your own provider credentials.
       - **Tooling:** CLI, task runners, and developer utilities for efficient workflows.
       - **Extensible agents:** Add custom tools, logic, and workflows.
       - **MLOps integration:** Host, monitor, and govern with DataRobot MLOps.
       With **Agentic Starter**, you get a solid foundation to ship agentic applications
       without rebuilding infrastructure from scratch.
   image:
     file_path: agent-application.gif
   is_premium: False 
   

   On DataRobot 11.4 or 11.5 (use soft_pin):

   tags: [genai, new]
   repository:
     url: https://github.com/datarobot-community/datarobot-agent-application
     branch: main
     tag: main
     soft_pin: ~=11.6.0  # last known compatible version
     is_public: True
   ports:
     - port: 5173
       description: Frontend - VITE
     - port: 8080
       description: Web - FastAPI
     - port: 8842
       description: Agent Workflow - Multi-agent Framework
   en:
     name: Agentic Starter (stable)
     description: >-
       A production-ready template for building and deploying multi-agent applications.
       It includes a FastAPI backend, a React frontend, and a built-in MCP server.
       The example multi-agent template illustrates 2 agents that handle content creation tasks,
       including planning and writing blog posts.
       Requirements: GenAI, MLOps
     readme: >-
       - **Multi-agent workflows:** Build sophisticated agentic systems with popular frameworks.
       - **Modern stack:** FastAPI backend and React frontend.
       - **MCP integration:** Built-in Model Context Protocol (MCP) server for tool interoperability.
       - **Dev to prod:** Local development/testing and one-command deployment to DataRobot.
       - **Minimal setup:** Start quickly with sane defaults and low boilerplate.
       - **Enterprise security:** Aligned with DataRobot security and governance standards.
       - **LLM choice:** Swap LLMs from supported providers via DataRobot's LLM Gateway, use a deployed LLM custom model, or use your own provider credentials.
       - **Tooling:** CLI, task runners, and developer utilities for efficient workflows.
       - **Extensible agents:** Add custom tools, logic, and workflows.
       - **MLOps integration:** Host, monitor, and govern with DataRobot MLOps.
       With **Agentic Starter**, you get a solid foundation to ship agentic applications
       without rebuilding infrastructure from scratch.
   image:
     file_path: agent-application.gif
   is_premium: False 
   

   備考

   The template name is changed to "(stable)" to distinguish it from the default template.

Use the latest experimental Agentic Starter template¶

Applicable to DataRobot 11.6 or later¶

Administrators or field engineers who want the latest main version of the Agentic Starter application template can add it as a new template entry with the soft-pin removed.

Add a new template with the following configuration:

tags: [genai, new]
repository:
  url: https://github.com/datarobot-community/datarobot-agent-application
  branch: main
  tag: main
  soft_pin: null  # soft_pin is removed to pull main
  is_public: True
ports:
  - port: 5173
    description: Frontend - VITE
  - port: 8080
    description: Web - FastAPI
  - port: 8842
    description: Agent Workflow - Multi-agent Framework
en:
  name: Agentic Starter (experimental)
  description: >-
    A production-ready template for building and deploying multi-agent applications.
    It includes a FastAPI backend, a React frontend, and a built-in MCP server.
    The example multi-agent template illustrates 2 agents that handle content creation tasks,
    including planning and writing blog posts.
    Requirements: GenAI, MLOps
  readme: >-
    - **Multi-agent workflows:** Build sophisticated agentic systems with popular frameworks.
    - **Modern stack:** FastAPI backend and React frontend.
    - **MCP integration:** Built-in Model Context Protocol (MCP) server for tool interoperability.
    - **Dev to prod:** Local development/testing and one-command deployment to DataRobot.
    - **Minimal setup:** Start quickly with sane defaults and low boilerplate.
    - **Enterprise security:** Aligned with DataRobot security and governance standards.
    - **LLM choice:** Swap LLMs from supported providers via DataRobot's LLM Gateway, use a deployed LLM custom model, or use your own provider credentials.
    - **Tooling:** CLI, task runners, and developer utilities for efficient workflows.
    - **Extensible agents:** Add custom tools, logic, and workflows.
    - **MLOps integration:** Host, monitor, and govern with DataRobot MLOps.
    With **Agentic Starter**, you get a solid foundation to ship agentic applications
    without rebuilding infrastructure from scratch.
image:
  file_path: agent-application.gif
is_premium: False 

Agentic Starter template compatibility matrix¶

Known issues¶

• Execution environment version: The Agentic Starter application template pins an execution environment version that may not exist in self-managed installations. In this case, the template falls back to the latest available version.
• uv interface: The uv package manager does not have a stable interface. The Agentic Starter application template may use uv features released after version 0.9.0 (such as exclude-dependencies), which may not work on DataRobot 11.3 or earlier, which bundles an older uv version. If you encounter uv-related errors, use the pinned stable template instead.