Below are the end-to-end procedures required to deploy Glob.AI OS for Version 2026-03.
See also the version updates for the main platform components.
No manual steps required for this Hot Fix.
The following environment variables should be removed from all API and Console containers:
- GX_GAM_REMOVE_ABANDONED_TIMEOUT
- GX_DEFAULT_REMOVE_ABANDONED_TIMEOUT
If these variables are defined at the infrastructure level, they should be removed so that the application defaults can take effect.
Once removed, the application will use the new default timeout value of 1000 seconds. Note that some environments may still have custom values configured (historically, 120 seconds was used in certain environments), so the current behavior may vary depending on each environment's configuration.
Go to the platform Console → System → System Modules and press Update or Reinstall on “Security Configuration” as appropiate.
Follow these steps to update LLM use by the public Agent "Iris retrieve tools":
- Get a GlobAI OS API token:
- In Console go to Organization: "AI Studio Public Repo" and Project "Default".
- Console → API Tokens → Create new API token $GLOB.AI OS_APITOKEN
- Run this cURL, change the URL and API Token:
curl --location --request PUT '/v2/agents/8c433643-a790-4359-...' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ' \
--data '{
"agentDefinition": {
"id": "8c433643-a790-4359-9c35-60973d89aa93",
"name": "Iris_retrieve_tools",
"accessScope": "public",
"publicName": "com.globant.geai.iris_retrieve_tools",
"description": "Retrieve a list of tools that can be used to built Agents",
"agentData": {
"models":
{
"name": "gpt-5.4"
},
{
"name": "gpt-5.4-mini"
},
{
"name": "gpt-5.3-codex"
},
{
"name": "gemini-3.1-flash-lite-preview"
},
{
"name": "gemini-3.1-pro-preview"
}
,
"resourcePools":
{
"name": "library",
"tools": [
{
"name": "retrieve_tools_get"
},
{
"name": "retrieve_agent_list_get"
}
}
],
"prompt": {
"context": "",
"instructions": "\n- #Overview: You are an..."
},
"llmConfig": {
"maxRuns": 5,
"maxTokens": 16000,
"sampling": {
"temperature": 0.1
}
}
}
}
}
All steps below must be performed in the Glob.AI OS Console for the ENVIRONMENT environment.
Ensure the following modules are installed:
| Module |
Revision |
| [Provider 1] |
[Rev] |
| [Provider 2] |
[Rev] |
Once installed, update the Creation Timestamp of the version: 2 cost revision for each of the following models:
| Provider |
Model |
| [Provider] |
[model-name] |
| [Provider] |
[model-name] |
How to update the timestamp for each model
- Go to AI Settings → AI Models in the left panel.
- Search for the model name and click it.
- Open the AI Model Cost tab.
- Locate the cost revision containing version: 2.
- Click Update and set the Creation Timestamp to: DATE
- Click Confirm.
- Verify that the updated revision is marked as Active.
- Repeat for all N models listed above.
This procedure corrects costs for past requests that were calculated incorrectly.
Scope
- Models: all N models listed in Step 1
- Period: DATE → current date
- Go to:
Console → System → Metadata → Request Utils → Request Cost Recalculation
- Set:
- From: DATE
- To: current date
- In Request AIModel Name, enter one model from the list above.
Important:
- Enter only the model name
- Do NOT include:
- provider prefix
- slashes (/)
Sample: claude-opus-4-6, not anthropic/claude-opus-4-6.
- Click: EXECUTE COST RECALCULATION (SUBMIT)
- Monitor progress in: System → Operation Logs (runs as a background thread)
Repeat steps 3–5 for all N models.
Execute Stage 2 only after all Stage 1 recalculations have completed.
1. Go to: Console → System → Metadata → Request Utils → Reprocess Requests and Load Summary Table
2. Click: Load a Specific Period
3. Set:
- Start date: DATE
- End date: current date
4. Click: REPROCESS REQUESTS (SUBMIT)
5. Monitor progress in System → Operation Logs (runs as a background thread)
Update the base agent templates definition to fix issues related to the applied models.
- Go to Superadmin options → System → Parameters.
- Find the parameter called BASE_AGENT_DEFINITIONS_FOR_PROJECTS.
- If it exists, delete it.
- Go to Superadmin options → System → Modules.
- Update or reinstall the System module.
- Even if it appears up to date, make sure to reinstall it.
- Go again to Superadmin options → System → Paameters.
- Find the parameter called BASE_AGENT_DEFINITIONS_FOR_PROJECTS and verify that it was recreated after the System module update/reinstallation.
- Apply a light change to the BASE_AGENT_DEFINITIONS_FOR_PROJECTS parameter using the Update action to fix a deprecated model reference:
- Replace:
xai/grok-4-1-fast-non-reasoning
- With:
xai/grok-4.20-0309-non-reasoning
- Confirm and save the changes.
- Go to Superadmin options → System → Modules.
- Update the Security Configuration module.
- If it was not automatically updated, perform the update manually.
- To verify the expected behavior:
- Go to Superadmin options → Organizations.
- Check whether the CREATE NEW button is visible.
- If the CREATE NEW button is not visible:
- Reinstall the Security Configuration module.
- Add EnvVars for the Console container:
- GLOBAI_OS_URL with the correct URL value for the Glob.AI OS frontend.
Sample: https://os.glob.ai This EnvVar is needed to redirect users from the Console menu “Glob.AI OS”.
- PLATFORM_BRANDING_NAME with the value Glob.AI OS, used in email templates, the Console, menus, etc.
1. Update System Module
- Go to Console → SUPERADMIN OPTIONS → System → System Modules.
- Update the System module (rev: 37 or higher).
- It generates a system parameter named GAM_PERMISSION_ROL_SETTINGS, where the current configuration for roles and their menu access is stored.
- It also generates a system parameter named GAMMENUSETTINGS, where the current configuration of menu items and their access permissions is stored.
VALIDATION:
If the installation or update process is executed again for the Security Configuration or The Station modules, the permissions will be regenerated.
2. Branding Update
Installing the System module at revision 33 updates all email templates.
- Go to Console → SUPERADMIN OPTIONS → System → Parameters.
- Update the following parameter to reference the new frontend:
- GX_AISTUDIO_URL with the correct URL value for the Glob.AI OS frontend. sample: https://os.glob.ai
- This value is referenced in the Trial Project Welcome email.
- For validation: Parameter PLATFORM_BRANDING_NAME is where the platform name is stored. It must be defined as the result of the System module installation/update with the value Glob.AI OS (It can be overridden if it was defined as an EnvVar in the pre-deployment step).
To fix possible problems related to platform name variable substitution:
- MAIL_SUBJECT_TEMPLATE_INVITATION_v2 must contain the following value: You've been invited to join %1 Glob.AI OS!
- MAIL_SUBJECT_TEMPLATE_INVITATION must be equal to the v2 value (to keep compatibility): You've been invited to join %1 Glob.AI OS!
- MAIL_BODY_TEMPLATE_INVITATION must be defined as: MAIL_BODY_TEMPLATE_INVITATION must be defined as:
<head>
<meta name="viewport"
content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0,user-scalable=no" />
</head>
<body>
<table width="85%" style="max-width: 720px; margin: 0 auto; text-align: center;">
<tr>
<th style="margin: 0 auto; padding:26px; border-radius: 15px; background-color: #1A1D20; text-align: center;">
<br>
<img alt="Ready" src="https://www.genexus.com/media/images/ico-ready.png">
<br><br>
<h1 style="color:#fff; font-family: Arial, Helvetica, sans-serif; font-size: 24px;">
You've been invited to join Glob.AI OS
</h1>
<br>
<p style="color:#fff; font-family: Arial, Helvetica, sans-serif; font-weight: normal; line-height: 26px; font-size: 17px;">
Glob.AI OS is the backbone that connects companies with LLMs in a monitored and cost-effective way,
providing agility to embrace the power of Generative AI.
</p>
<br><br>
<a href="#{LinkUrl}"
target="_blank"
style="text-decoration:none; background-color:#25c2a0;color: white;padding: 15px 45px;border: none;border-radius: 10px;cursor: pointer;font-size: 20px;text-align: center;">
<span style="color:white !important">Join</span>
</a>
<br>
<br>
<p style="color:#fff; font-family: Arial, Helvetica, sans-serif; font-weight: normal; line-height: 26px; font-size: 14px; border-radius: 10px; background-color: #24272A; padding:10px;">
To log in to your project, please use the same email address associated with your current account.
details<!--<br> Find your project details through the "My Projects" page -->.
</p>
<br>
<br>
<p style="color:#fff; font-family: Arial, Helvetica, sans-serif; font-weight: normal; font-size: 14px;">
<a style="color:#fff; font-family: Arial, Helvetica, sans-serif; font-weight: normal; font-size: 14px;"
title="About Globant"
href="https://www.globant.com/about"
target="_blank">
About Globant
</a>
</p>
</th>
</tr>
<tr>
<th style="text-align: center;">
<br><br>
<p style="color:#999; font-family: Arial, Helvetica, sans-serif; font-weight: normal; font-size: 14px;">
Glob.AI OS
</p>
<p style="color:#999; font-family: Arial, Helvetica, sans-serif; font-weight: normal; font-size: 14px;">
This message was automatically generated, please do not reply.
</p>
</th>
</tr>
</table>
</body>
</html>
- SMTP_SENDER_NAME must be set as: Glob.AI OS
3. Create GAM Application for Glob.AI OS
- Go to Console → SUPERADMIN OPTIONS → System → System Modules.
- Update the Security Configuration module to the latest available version.
- If no update suggestion is available for the module, reinstall it.
Note:
If you are unable to update this module, refer to the Appendix for the manual steps required to create the application.
4. Integrations Update to Support Icons
- Go to Console → SUPERADMIN OPTIONS → System → System Modules.
- Update the following modules:
- The Lab Public Components (rev: 55 or higher)
- The Lab Tools: Google Drive Tools (rev: 6 or higher)
- The Lab Tools: Sharepoint Tools (rev: 3 or higher)
5. Parameters Needed for Terms & Conditions
- Go to Console → System → Parameters.
- Check whether a parameter named ENVIRONMENT_SETTINGS exists.
- If it does not exist, create it with the following JSON values.
Note:
The following JSON configuration examples show different Terms & Conditions scenarios depending on the environment.
installationType is only a descriptive label and is not a functional value.
{
"environment": {
"installationType": "saas",
"termsAndConditionsGroups":
{
"scope": "environment",
"acceptanceRules": {
"acceptanceScope": "organization",
"requiresAcceptance": true
},
"terms": [
{
"language": "english",
"language-iso639-1": "en",
"name": "Platform Terms and Conditions",
"url": "https://www.globant.com/enterprise-ai/terms-of-use"
},
{
"language": "spanish",
"language-iso639-1": "es",
"name": "Términos y Condiciones de la Plataforma",
"url": "https://www.globant.com/es/enterprise-ai/condiciones-de-uso"
},
{
"language": "portuguese",
"language-iso639-1": "pt",
"name": "Termos e Condições da Plataforma",
"url": "https://www.globant.com/pt-br/enterprise-ai/termo-de-uso"
}
}
]
}
}
{
"environment": {
"installationType": "client",
"termsAndConditionsGroups":
{
"scope": "environment",
"acceptanceRules": {
"acceptanceScope": "environment",
"requiresAcceptance": true
},
"terms": [
{
"language": "english",
"language-iso639-1": "en",
"name": "Platform Terms and Conditions",
"url": "https://www.globant.com/enterprise-ai/terms-of-use"
},
{
"language": "spanish",
"language-iso639-1": "es",
"name": "Términos y Condiciones de la Plataforma",
"url": "https://www.globant.com/es/enterprise-ai/condiciones-de-uso"
},
{
"language": "portuguese",
"language-iso639-1": "pt",
"name": "Termos e Condições da Plataforma",
"url": "https://www.globant.com/pt-br/enterprise-ai/termo-de-uso"
}
}
]
}
}
> **Note:**
> To disable the Terms and Conditions popup, use the following configuration.
6. Modules that Support the Discover Section
- Go to Console → SUPERADMIN OPTIONS → System → System Modules.
- Make sure the following modules are installed and updated:
- The Station Public Components (rev: 1 or higher)
- The Station (rev: 35 or higher)
7. SMTP Parameters / Secrets
- To configure or update the SMTP service, at least one secret must be defined in the cloud provider:
- SMTP_SERVER_PASSWORD with the correct value for the environment.
- Other non-sensitive values related to the SMTP module can be stored as System Parameters.
8. Flows Module
- If the Fluent Lab (Flows) module is installed and an update is available, apply it (rev: 5).
9. Update Glob.AI OS Menu Structure
To update the Glob.AI OS menu structure and avoid issues where super-admin users cannot see menu options:
1. Go to Console → SUPERADMIN OPTIONS → System → Parameters.
2. Filter by the parameter GAM_MENU_SETTINGS.
3. Update the parameter and paste the JSON into the Value S field.
{"id":"#HomeMS","name":"Home","description":"Home (My Space)","option":true,"permissionName":"Basic_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"10","idMemberHub":"9"},{"id":"#Discover","name":"Discover","description":"Discover","option":false,"permissionName":"Basic_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"12","idMemberHub":"9","subMenu":[{"id":"#Solutions","name":"Solutions","description":"Solutions","option":true,"permissionName":"Basic_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"13","idMemberHub":"9"},{"id":"#MySpace","name":"My Space","description":"My Space","option":true,"permissionName":"Basic_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"96","idMemberHub":"9"},{"id":"#MyFavorites","name":"My Favorites","description":"My Favorites","option":true,"permissionName":"Basic_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"15","idMemberHub":"9"},{"id":"#MyCollections","name":"My Collections","description":"My Collections","option":true,"permissionName":"Basic_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"16","idMemberHub":"9"},{"id":"#MyCreations","name":"My Creations","description":"My Creations","option":true,"permissionName":"Creations_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"14","idMemberHub":"9"}},{"id":"#Build","name":"Build","description":"Build","option":false,"permissionName":"Build_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"18","idMemberHub":"9","subMenu":{"id":"#Agents","name":"Agents","description":"Agents","option":true,"permissionName":"Agents_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"19","idMemberHub":"9"},{"id":"#AgenticProcesses","name":"Agentic Processes","description":"Agentic Processes","option":true,"permissionName":"Agentic_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"20","idMemberHub":"9"},{"id":"#Flows","name":"Flows","description":"Flows","option":true,"permissionName":"Flows_Access","icon":"","linkTarget":"","link":"","optionAvailable":"saia.fluentlab","idExternal":"21","idMemberHub":"9"},{"id":"#Integrations","name":"Integrations","description":"Integrations","option":true,"permissionName":"Integrations_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"22","idMemberHub":"9"}},{"id":"#Run","name":"Run","description":"Run","option":true,"permissionName":"Basic_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"11","idMemberHub":"9"},{"id":"#MManage","name":"Manage","description":"Manage","option":false,"permissionName":"M_Manage_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"30","idMemberHub":"9","subMenu":{"id":"#M_Solutions","name":"Solutions","description":"Solutions","option":true,"permissionName":"M_Solutions_Access","icon":"","linkTarget":"","link":"","optionAvailable":"geai.ai-station","idExternal":"31","idMemberHub":"9"},{"id":"#Console","name":"Console","description":"Console","option":true,"permissionName":"Console_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"95","idMemberHub":"9"}},{"id":"#AIModels","name":"AI Models","description":"AI Models","option":false,"permissionName":"AI_Models_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"35","idMemberHub":"33","subMenu":{"id":"#Models","name":"Models","description":"Models","option":true,"permissionName":"Models_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"36","idMemberHub":"33"}},{"id":"#Integrations","name":"Integrations","description":"Integrations","option":false,"permissionName":"M_Integrations_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"46","idMemberHub":"44","subMenu":{"id":"#IntegrationTools","name":"Integration Agent Tools","description":"Integration Agent Tools","option":true,"permissionName":"Integration_AT_Access","icon":"","linkTarget":"","link":"","optionAvailable":"","idExternal":"47","idMemberHub":"44"}}]
1. [MANUAL] Create GAM Application for Glob.AI OS
- Go to Console → SUPERADMIN OPTIONS → Security
(only available to GAM Administrator users).
- In the GAM Administration screen, go to Applications.
- Click ADD to create a new application.
- Include the following details:
- Section “General”
- ID and GUID are generated automatically.
- Name = Glob.AI OS
- Description = Backoffice Glob.AI OS
- Version = 1.0.0
- Company = Globant
- Local Logout Object (specify an object or a URL) = admin
- Leave the remaining fields empty.
- Section “Configuration”
- Tab: “OAuth Authentication”
- Client ID = "JzNe4adcdAa16lE0dxNVLL6aszPULaSJLWP3T5q7"
- Client Secret = “Auto-defined secret” (if not added, a random one is generated)
- Allow OAuth 2.0 (authorization code flow in /oauth/gam)? = ✅
- Allowed user scopes - User data = ✅
- Allowed user scopes - User additional data = ✅
- Allowed user scopes - User roles = ✅
- Local login URL = "/saiachatlogin"
- Callback URLs = "https://os.beta.saia.ai/auth;http://localhost:5200/auth;http://localhost:5201/auth" <Set the specific URLs depending on the environment. >
- Custom callback URL? = ✅
- State parameter name = "state"
- Disable Single Logout (SLO)? = ✅
- Allow OAuth 2.0 (password grant flow in /oauth/gam/v2.0)? = ✅
- Allowed user scopes (SSO REST, Mini App, API key, password grant flow) - User data = ✅
- Allowed user scopes (SSO REST, Mini App, API key, password grant flow) - User roles = ✅
Set the specific URLs according to the environment.
- Tab: “Authorization”
- Without additional configuration, leave as is.
- Tab: “SSO REST”
- Without additional configuration, leave as is.
- Tab: “STS”
- Without additional configuration, leave as is.
- Tab: “Mini App”
- Without additional configuration, leave as is.
- Tab: “API Key”
- Without additional configuration, leave as is.
- Tab: “Environment”
- Is HTTPS? = ✅
- Host = "console.beta.saia.ai" <Set the real one for the environment. >
- Package = "com.piamiddleware"
- Tab: “Languages”
- Without additional configuration, leave as is.