Configure AI model providers (OpenAI, Azure OpenAI, Ollama) and cloud storage.
Admin › Settings › Connections
To use AI models, first configure connections to LLM providers. Connect multiple providers simultaneously so users can pick from various models.
Configure LLM providers, cloud accounts, and storage in Admin > Settings > Connections
AI Provider
Manage connections to all LLM providers (OpenAI, Azure OpenAI, Azure AI Foundry, Vertex AI, etc.) in a single AI Provider section. Each connection is listed under AI Provider Connection Management, and you can configure multiple connections at once to balance load or expose a variety of models.
1
Add connection
Click the + button in AI Provider Connection Management and select the provider type.
2
Enter connection info
In the connection modal, enter API Base URL and API Key.
3
Verify connection
After saving, verify the model list auto-refreshes.
OpenAI
Azure OpenAI
Azure AI Foundry
Vertex AI
Setting
Description
API Base URL
https://api.openai.com/v1
API Key
Key from OpenAI (sk-...)
Prefix ID
Model ID prefix (optional — prevents collision in multi-connection)
Model IDs
Manual specification (auto-fetched if blank)
Setting
Description
API Base URL
https://{resource}.openai.azure.com/
API Key
Key from Azure Portal
API Version
API version (required, e.g., 2024-02-15-preview)
Prefix ID
Model ID prefix (optional)
Model IDs
Manual specification of deployed model names
Setting
Description
API Base URL
https://{project}.{region}.models.ai.azure.com/
API Key
Key from Azure AI Foundry
API Version
API version (default: 2024-05-01-preview)
Prefix ID
Model ID prefix (optional)
Model IDs
Manual (auto-fetched on Verify Connection if blank)
Azure OpenAI vs Azure AI Foundry
Azure OpenAI
Azure AI Foundry
Endpoint format
{url}/openai/deployments/{model}/...
{url}/openai/v1/...
Model identifier
Deployment name
Model ID
Auth (both take an API Key)
Sent as api-key + Authorization: Bearer
Sent as Authorization: Bearer only
Use
OpenAI-only models on Azure
Diverse models on Azure AI (OpenAI + OSS)
Azure OpenAI manages models per deployment; Azure AI Foundry accesses them directly from the model catalog. If you already use Azure OpenAI, Azure AI Foundry isn’t separately required — add it when you need OSS or Azure AI Foundry-only models.
Setting
Description
Project ID
Google Cloud project ID (required)
Location
Region (default: us-central1)
Auth
Global GCP Key or Custom Service Account JSON
Available models are auto-displayed on Verify Connection.
Common Connection Settings
Each connection has these common features:
Feature
Description
Verify Connection
Test API access via the verify button in the settings modal
Prefix ID
Distinguish models with {prefix}.{model} form when names collide across connections
Activate/Deactivate
Per-connection toggle to pause without deleting
Model IDs
When manually specified, only those models are exposed. Auto-fetched if blank
Adding multiple connections to the same provider auto-merges model lists. For example, adding 2 Azure OpenAI connections (US/Korea regions) shows models from both regions. Use Prefix ID to distinguish.
Ollama API Connection
Connect to a local or internal server Ollama instance.
Setting
Description
Example
Base URL
Ollama server address
http://localhost:11434
Add multiple servers to load-balance. Ollama provides complete data privacy without external network.Turn on the Ollama API switch to add connections. Each added connection row then shows two icon buttons on the right. While the switch is off, no connection rows appear at all.
Click the Manage (down arrow) icon on a connection row to open the Manage Ollama modal. It manages the models installed on that connection’s Ollama server directly.
Feature
Description
Pull a model from Ollama.com
Enter a model tag (e.g. llama3:latest) to download. Up to 3 concurrent downloads
Update all models
Icon button next to the pull input (tooltip Update All Models) — updates all installed Ollama models at once
Delete a model
Pick one of the installed models and delete it
Create a model
Enter a model tag and a Modelfile definition (JSON) to derive a new model from an existing one
Upload a GGUF model
Appears only after clicking Show in the Experimental section. Upload a GGUF in file mode or download from a URL
This modal opens per connection row — it manages only the server whose button you clicked. With several Ollama servers, click the button on the row for the server you want to manage.
Pulling and deleting models changes the Ollama server itself. Other connections and services sharing that server see the change immediately.
Direct Connections
Beyond admin-configured connections, allow users to connect directly to LLMs with personal API keys.
Setting
Description
Default
Allow direct connections
Allow per-user personal API connections
Enabled
When enabled, users can add OpenAI-compatible APIs in Personal Settings > Connections.
Direct connections support OpenAI-compatible APIs only (Ollama unsupported). The user’s API server must have CORS correctly configured.
Cloud Accounts
Configure global cloud service accounts. Service Account Keys set here serve as fallback when individual features (TTS, STT, images) lack separate keys.
Provider
Settings
Google Cloud
Service Account Key (JSON)
Leaving Service Account Key empty uses Application Default Credentials (ADC).
Google Workspace Integration
Allow users to use Gmail sending, calendar event creation, and Drive document creation from chat. Each capability is controlled by an individual toggle, and actual use requires both a per-user Google OAuth connection and group permissions. For safety, all defaults are disabled.
Toggle
Scope
Review requirement
Gmail integration
gmail.send
Sensitive scope — requires Google App verification
Calendar integration
calendar.events
Restricted scope — requires CASA Tier 2 security audit
Drive integration
drive
Restricted scope — requires CASA Tier 2 security audit
Gmail, Calendar, and Drive fall under Google’s sensitive and restricted scopes. Complete App verification or CASA review before production deployment for these to work correctly.
Usage flow
Turning on the toggle is only the start — each user must also finish their connection before it works in chat.
1
Attach Google tools in chat
Once connected, Gmail · Google Calendar · Google Drive tools attach as chips in the chat input.
Google tools attached in the chat input
2
Ask in natural language
Within the attached tool scopes, users ask in natural language and the agent queries or acts on the relevant Google service to respond.
Calendar lookup Q&A
Image Attachment Mode
Configure how images attached to chats are processed and stored.
Setting
Description
Default
Image Upload Mode
Base64 Inline or Cloud Storage
Base64 Inline
Storage Provider
Local, AWS S3, Azure Blob, Google Cloud Storage
Local
AWS S3
Azure Blob
Google Cloud Storage
Setting
Description
Bucket Name
S3 bucket name
Region
AWS region
Endpoint URL
Custom Endpoint (optional)
Access Key ID
Auth key ID
Secret Access Key
Secret key
Key Prefix
File path prefix (optional)
Setting
Description
Storage Endpoint
Azure Blob Storage Endpoint
Container Name
Container name
Storage Key
Auth key
Setting
Description
Bucket Name
GCS bucket name
Authentication
Global Google Cloud Key or Custom Key
Shared Storage (file uploads)
Configure storage location for uploaded files like documents and PDFs. Same storage provider options as Image Attachment Mode.
Setting
Description
Default
File Storage Provider
Local, AWS S3, Azure Blob, Google Cloud Storage
Local
After changing storage settings, always verify connection state with the Test button.
Related Pages
Models
Activate/deactivate connected models and configure Workspace models
Documents
Embedding engine and RAG pipeline settings
Code Gateway
LLM proxy settings for coding tools
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"en/admin/settings/connections","slug":"/en/admin/settings/connections","pageMetadata":{"title":"Connections","description":"Configure AI model providers (OpenAI, Azure OpenAI, Ollama) and cloud storage.","href":"/en/admin/settings/connections"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Configure AI model providers (OpenAI, Azure OpenAI, Ollama) and cloud storage.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Accordion,Card,Columns,Frame,Heading,Info,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Card)_missingMdxReference(`Card`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:`Admin › Settings › Connections`}),`\n`,_jsx(_components.p,{children:`To use AI models, first configure connections to LLM providers. Connect multiple providers simultaneously so users can pick from various models.`}),`\n`,_jsx(Frame,{caption:`Configure LLM providers, cloud accounts, and storage in Admin > Settings > Connections`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/settings-connections-full.png?fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=190ea4ee467cd3770931fcea2ff972c9`,alt:`Connections settings tab`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/admin/settings-connections-full.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/settings-connections-full.png?w=280\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=e03bfe8745b5b9182c5a11687867fe7a 280w, https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/settings-connections-full.png?w=560\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=8b7aec7edf8d031c7162f57af97f8b50 560w, https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/settings-connections-full.png?w=840\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=08ac4a1983bebc74fe2baa8cf9d9220b 840w, https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/settings-connections-full.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=f185c16f6318fdec25abd15ec37b0918 1100w, https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/settings-connections-full.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=d9ececa515fec45a6e68863cb2fb9ca7 1650w, https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/settings-connections-full.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=21f45ce2f2511fd8c67190a19b13b4e7 2500w`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`ai-provider`,children:`AI Provider`}),`\n`,_jsxs(_components.p,{children:[`Manage connections to all LLM providers (OpenAI, Azure OpenAI, Azure AI Foundry, Vertex AI, etc.) in a single `,_jsx(_components.strong,{children:`AI Provider`}),` section. Each connection is listed under `,_jsx(_components.strong,{children:`AI Provider Connection Management`}),`, and you can configure multiple connections at once to balance load or expose a variety of models.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Add connection`,children:_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`+`}),` button in `,_jsx(_components.strong,{children:`AI Provider Connection Management`}),` and select the provider type.`]})}),_jsx(Step,{title:`Enter connection info`,children:_jsx(_components.p,{children:`In the connection modal, enter API Base URL and API Key.`})}),_jsx(Step,{title:`Verify connection`,children:_jsx(_components.p,{children:`After saving, verify the model list auto-refreshes.`})})]}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`OpenAI`,id:`openai`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Base URL`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://api.openai.com/v1`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Key`})}),_jsxs(_components.td,{children:[`Key from OpenAI (`,_jsx(_components.code,{children:`sk-...`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Prefix ID`})}),_jsx(_components.td,{children:`Model ID prefix (optional — prevents collision in multi-connection)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Model IDs`})}),_jsx(_components.td,{children:`Manual specification (auto-fetched if blank)`})]})]})]})}),_jsx(Tab,{title:`Azure OpenAI`,id:`azure-openai`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Base URL`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://{resource}.openai.azure.com/`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Key`})}),_jsx(_components.td,{children:`Key from Azure Portal`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Version`})}),_jsxs(_components.td,{children:[`API version (required, e.g., `,_jsx(_components.code,{children:`2024-02-15-preview`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Prefix ID`})}),_jsx(_components.td,{children:`Model ID prefix (optional)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Model IDs`})}),_jsx(_components.td,{children:`Manual specification of deployed model names`})]})]})]})}),_jsxs(Tab,{title:`Azure AI Foundry`,id:`azure-ai-foundry`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Base URL`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://{project}.{region}.models.ai.azure.com/`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Key`})}),_jsx(_components.td,{children:`Key from Azure AI Foundry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Version`})}),_jsxs(_components.td,{children:[`API version (default: `,_jsx(_components.code,{children:`2024-05-01-preview`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Prefix ID`})}),_jsx(_components.td,{children:`Model ID prefix (optional)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Model IDs`})}),_jsx(_components.td,{children:`Manual (auto-fetched on Verify Connection if blank)`})]})]})]}),_jsxs(Accordion,{title:`Azure OpenAI vs Azure AI Foundry`,id:`azure-openai-vs-azure-ai-foundry`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:`Azure OpenAI`}),_jsx(_components.th,{children:`Azure AI Foundry`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Endpoint format`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{url}/openai/deployments/{model}/...`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{url}/openai/v1/...`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Model identifier`})}),_jsx(_components.td,{children:`Deployment name`}),_jsx(_components.td,{children:`Model ID`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Auth`}),` (both take an API Key)`]}),_jsxs(_components.td,{children:[`Sent as `,_jsx(_components.code,{children:`api-key`}),` + `,_jsx(_components.code,{children:`Authorization: Bearer`})]}),_jsxs(_components.td,{children:[`Sent as `,_jsx(_components.code,{children:`Authorization: Bearer`}),` only`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Use`})}),_jsx(_components.td,{children:`OpenAI-only models on Azure`}),_jsx(_components.td,{children:`Diverse models on Azure AI (OpenAI + OSS)`})]})]})]}),_jsxs(_components.p,{children:[`Azure OpenAI manages models `,_jsx(_components.strong,{children:`per deployment`}),`; Azure AI Foundry accesses them directly from the `,_jsx(_components.strong,{children:`model catalog`}),`. If you already use Azure OpenAI, `,_jsx(_components.strong,{children:`Azure AI Foundry isn’t separately required`}),` — add it when you need OSS or Azure AI Foundry-only models.`]})]})]}),_jsxs(Tab,{title:`Vertex AI`,id:`vertex-ai`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Project ID`})}),_jsx(_components.td,{children:`Google Cloud project ID (required)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Location`})}),_jsxs(_components.td,{children:[`Region (default: `,_jsx(_components.code,{children:`us-central1`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Auth`})}),_jsx(_components.td,{children:`Global GCP Key or Custom Service Account JSON`})]})]})]}),_jsx(_components.p,{children:`Available models are auto-displayed on Verify Connection.`})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`common-connection-settings`,children:`Common Connection Settings`}),`\n`,_jsx(_components.p,{children:`Each connection has these common features:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Feature`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Verify Connection`})}),_jsx(_components.td,{children:`Test API access via the verify button in the settings modal`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Prefix ID`})}),_jsxs(_components.td,{children:[`Distinguish models with `,_jsx(_components.code,{children:`{prefix}.{model}`}),` form when names collide across connections`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Activate/Deactivate`})}),_jsx(_components.td,{children:`Per-connection toggle to pause without deleting`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Model IDs`})}),_jsx(_components.td,{children:`When manually specified, only those models are exposed. Auto-fetched if blank`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Adding `,_jsx(_components.strong,{children:`multiple connections`}),` to the same provider auto-merges model lists. For example, adding 2 Azure OpenAI connections (US/Korea regions) shows models from both regions. Use `,_jsx(_components.strong,{children:`Prefix ID`}),` to distinguish.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`ollama-api-connection`,children:`Ollama API Connection`}),`\n`,_jsx(_components.p,{children:`Connect to a local or internal server Ollama instance.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Example`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Base URL`})}),_jsx(_components.td,{children:`Ollama server address`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`http://localhost:11434`})})]})})]}),`\n`,_jsx(_components.p,{children:`Add multiple servers to load-balance. Ollama provides complete data privacy without external network.`}),`\n`,_jsxs(_components.p,{children:[`Turn on the `,_jsx(_components.code,{children:`Ollama API`}),` switch to add connections. Each added `,_jsx(_components.strong,{children:`connection row then shows two icon buttons on the right`}),`. While the switch is off, no connection rows appear at all.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Icon`}),_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Opens`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Down arrow`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Manage`})}),_jsxs(_components.td,{children:[`Ollama model management modal (`,_jsx(_components.a,{href:`#ollama-model-management`,children:`below`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gear`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Configure`})}),_jsx(_components.td,{children:`Connection edit modal (URL, key, enable)`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`ollama-model-management`,children:`Ollama Model Management`}),`\n`,_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`Manage (down arrow) icon`}),` on a connection row to open the `,_jsx(_components.code,{children:`Manage Ollama`}),` modal. It manages the models installed on that connection’s Ollama server directly.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Feature`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Pull a model from Ollama.com`})}),_jsxs(_components.td,{children:[`Enter a model tag (e.g. `,_jsx(_components.code,{children:`llama3:latest`}),`) to download. Up to `,_jsx(_components.strong,{children:`3 concurrent`}),` downloads`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Update all models`})}),_jsxs(_components.td,{children:[`Icon button next to the pull input (tooltip `,_jsx(_components.code,{children:`Update All Models`}),`) — updates all installed Ollama models at once`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Delete a model`})}),_jsx(_components.td,{children:`Pick one of the installed models and delete it`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Create a model`})}),_jsx(_components.td,{children:`Enter a model tag and a Modelfile definition (JSON) to derive a new model from an existing one`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Upload a GGUF model`})}),_jsxs(_components.td,{children:[`Appears only after clicking `,_jsx(_components.strong,{children:`Show`}),` in the `,_jsx(_components.code,{children:`Experimental`}),` section. Upload a GGUF in file mode or download from a URL`]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This modal opens `,_jsx(_components.strong,{children:`per connection row`}),` — it manages only the server whose button you clicked. With several Ollama servers, click the button on the row for the server you want to manage.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Pulling and deleting models changes the `,_jsx(_components.strong,{children:`Ollama server itself`}),`. Other connections and services sharing that server see the change immediately.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`direct-connections`,children:`Direct Connections`}),`\n`,_jsxs(_components.p,{children:[`Beyond admin-configured connections, allow `,_jsx(_components.strong,{children:`users to connect directly to LLMs with personal API keys`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Default`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Allow direct connections`})}),_jsx(_components.td,{children:`Allow per-user personal API connections`}),_jsx(_components.td,{style:{textAlign:`center`},children:`Enabled`})]})})]}),`\n`,_jsxs(_components.p,{children:[`When enabled, users can add OpenAI-compatible APIs in `,_jsx(_components.strong,{children:`Personal Settings > Connections`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Direct connections support `,_jsx(_components.strong,{children:`OpenAI-compatible APIs only`}),` (Ollama unsupported). The user’s API server must have CORS correctly configured.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`cloud-accounts`,children:`Cloud Accounts`}),`\n`,_jsx(_components.p,{children:`Configure global cloud service accounts. Service Account Keys set here serve as fallback when individual features (TTS, STT, images) lack separate keys.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Provider`}),_jsx(_components.th,{children:`Settings`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Google Cloud`})}),_jsx(_components.td,{children:`Service Account Key (JSON)`})]})})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Leaving Service Account Key empty uses Application Default Credentials (ADC).`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`google-workspace-integration`,children:`Google Workspace Integration`}),`\n`,_jsxs(_components.p,{children:[`Allow users to use `,_jsx(_components.strong,{children:`Gmail sending, calendar event creation, and Drive document creation`}),` from chat. Each capability is controlled by an individual toggle, and actual use requires both a `,_jsx(_components.strong,{children:`per-user Google OAuth connection`}),` and `,_jsx(_components.strong,{children:`group permissions`}),`. For safety, all defaults are disabled.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Toggle`}),_jsx(_components.th,{children:`Scope`}),_jsx(_components.th,{children:`Review requirement`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Gmail integration`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`gmail.send`})}),_jsx(_components.td,{children:`Sensitive scope — requires Google App verification`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Calendar integration`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`calendar.events`})}),_jsx(_components.td,{children:`Restricted scope — requires CASA Tier 2 security audit`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Drive integration`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`drive`})}),_jsx(_components.td,{children:`Restricted scope — requires CASA Tier 2 security audit`})]})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Gmail, Calendar, and Drive fall under Google’s sensitive and restricted scopes. Complete App verification or CASA review before production deployment for these to work correctly.`})}),`\n`,_jsx(Heading,{level:`3`,id:`usage-flow`,children:`Usage flow`}),`\n`,_jsx(_components.p,{children:`Turning on the toggle is only the start — each user must also finish their connection before it works in chat.`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[\"Admin: toggle ON\"] --> B[\"User: Google OAuth connect\"]\n B --> C[\"Attach tools in chat\"]\n C --> D[\"Ask in natural language\"]`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Attach Google tools in chat`,children:[_jsxs(_components.p,{children:[`Once connected, `,_jsx(_components.strong,{children:`Gmail · Google Calendar · Google Drive`}),` tools attach as chips in the chat input.`]}),_jsx(Frame,{caption:`Google tools attached in the chat input`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-attach.png?fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=d716fe23a0029724cf1a93222e855ff9`,alt:`Gmail, Google Calendar, and Google Drive tools attached as chips in the chat input`,\"data-og-width\":`4500`,width:`4500`,\"data-og-height\":`2700`,height:`2700`,\"data-path\":`images/admin/google-workspace-attach.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-attach.png?w=280\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=97750ef1c8f6d9b8eb3062b963657d4b 280w, https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-attach.png?w=560\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=a1cbfd41a8d902967b7b3475e40fb208 560w, https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-attach.png?w=840\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=4eb548b552ed69375f91c69f2fb7a82a 840w, https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-attach.png?w=1100\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=2d93af85abac1c83181ebe68b47b5827 1100w, https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-attach.png?w=1650\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=7a0066820b0d7219b0fe54a49a45a7a7 1650w, https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-attach.png?w=2500\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=c8486430f620b07c05d3cac261b7a92c 2500w`})})]}),_jsxs(Step,{title:`Ask in natural language`,children:[_jsx(_components.p,{children:`Within the attached tool scopes, users ask in natural language and the agent queries or acts on the relevant Google service to respond.`}),_jsx(Frame,{caption:`Calendar lookup Q\u0026A`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-answer.png?fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=a97f0579ae0ec9464fe535cf02d2981e`,alt:`The agent looks up the calendar to answer a question about today's schedule`,\"data-og-width\":`4500`,width:`4500`,\"data-og-height\":`2700`,height:`2700`,\"data-path\":`images/admin/google-workspace-answer.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-answer.png?w=280\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=80ed53ee8c36c9685872929f47467052 280w, https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-answer.png?w=560\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=5b876f55b8b8cc7ae8136ad1958614fa 560w, https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-answer.png?w=840\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=46cf0392579ace4e4f9d0252713edbfc 840w, https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-answer.png?w=1100\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=58cd59ca4d8fa6aded296f02e5777865 1100w, https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-answer.png?w=1650\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=40365b16cb4a64b5126f2ed778747df7 1650w, https://mintcdn.com/cloocus/4H2vVXhPjOITz4vh/images/admin/google-workspace-answer.png?w=2500\u0026fit=max\u0026auto=format\u0026n=4H2vVXhPjOITz4vh\u0026q=85\u0026s=8957e090e2ef23193cc7160885bc4a63 2500w`})})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`image-attachment-mode`,children:`Image Attachment Mode`}),`\n`,_jsx(_components.p,{children:`Configure how images attached to chats are processed and stored.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Image Upload Mode`})}),_jsx(_components.td,{children:`Base64 Inline or Cloud Storage`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Base64 Inline`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Storage Provider`})}),_jsx(_components.td,{children:`Local, AWS S3, Azure Blob, Google Cloud Storage`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Local`})})]})]})]}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`AWS S3`,id:`aws-s3`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Bucket Name`})}),_jsx(_components.td,{children:`S3 bucket name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Region`})}),_jsx(_components.td,{children:`AWS region`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Endpoint URL`})}),_jsx(_components.td,{children:`Custom Endpoint (optional)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Access Key ID`})}),_jsx(_components.td,{children:`Auth key ID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Secret Access Key`})}),_jsx(_components.td,{children:`Secret key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Key Prefix`})}),_jsx(_components.td,{children:`File path prefix (optional)`})]})]})]})}),_jsx(Tab,{title:`Azure Blob`,id:`azure-blob`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Storage Endpoint`})}),_jsx(_components.td,{children:`Azure Blob Storage Endpoint`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Container Name`})}),_jsx(_components.td,{children:`Container name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Storage Key`})}),_jsx(_components.td,{children:`Auth key`})]})]})]})}),_jsx(Tab,{title:`Google Cloud Storage`,id:`google-cloud-storage`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Bucket Name`})}),_jsx(_components.td,{children:`GCS bucket name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Authentication`})}),_jsx(_components.td,{children:`Global Google Cloud Key or Custom Key`})]})]})]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`shared-storage-file-uploads`,children:`Shared Storage (file uploads)`}),`\n`,_jsx(_components.p,{children:`Configure storage location for uploaded files like documents and PDFs. Same storage provider options as Image Attachment Mode.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`File Storage Provider`})}),_jsx(_components.td,{children:`Local, AWS S3, Azure Blob, Google Cloud Storage`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Local`})})]})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`After changing storage settings, always verify connection state with the `,_jsx(_components.strong,{children:`Test`}),` button.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`related-pages`,children:`Related Pages`}),`\n`,_jsxs(Columns,{cols:3,children:[_jsx(Card,{title:`Models`,icon:`robot`,href:`/en/admin/settings/models`,children:_jsx(_components.p,{children:`Activate/deactivate connected models and configure Workspace models`})}),_jsx(Card,{title:`Documents`,icon:`file-lines`,href:`/en/admin/settings/documents`,children:_jsx(_components.p,{children:`Embedding engine and RAG pipeline settings`})}),_jsx(Card,{title:`Code Gateway`,icon:`code`,href:`/en/admin/code-gateway`,children:_jsx(_components.p,{children:`LLM proxy settings for coding tools`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Connections","description":"Configure AI model providers (OpenAI, Azure OpenAI, Ollama) and cloud storage.","href":"/en/admin/settings/connections"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"AI Provider","slug":"ai-provider","depth":2,"children":[{"title":"Common Connection Settings","slug":"common-connection-settings","depth":3,"children":[]}]},{"title":"Ollama API Connection","slug":"ollama-api-connection","depth":2,"children":[{"title":"Ollama Model Management","slug":"ollama-model-management","depth":3,"children":[]}]},{"title":"Direct Connections","slug":"direct-connections","depth":2,"children":[]},{"title":"Cloud Accounts","slug":"cloud-accounts","depth":2,"children":[]},{"title":"Google Workspace Integration","slug":"google-workspace-integration","depth":2,"children":[{"title":"Usage flow","slug":"usage-flow","depth":3,"children":[]}]},{"title":"Image Attachment Mode","slug":"image-attachment-mode","depth":2,"children":[]},{"title":"Shared Storage (file uploads)","slug":"shared-storage-file-uploads","depth":2,"children":[]},{"title":"Related Pages","slug":"related-pages","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"Connections - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/admin/settings/connections","matchLevel":1},"en":{"href":"/en/admin/settings/connections","matchLevel":0}}},"lastModified":"2026-08-21T07:39:12.792Z","originalFileLocation":"en/admin/settings/connections.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Configure AI model providers (OpenAI, Azure OpenAI, Ollama) and cloud storage.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connections - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"Configure AI model providers (OpenAI, Azure OpenAI, Ollama) and cloud storage.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/en/admin/settings/connections\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=General+%26+Connections\u0026amp;title=Connections\u0026amp;description=Configure+AI+model+providers+%28OpenAI%2C+Azure+OpenAI%2C+Ollama%29+and+cloud+storage.\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=9f186cd110197e4512548b7c741323f0496f4039a6afc35eba200d0cf54ae190\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Connections - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Configure AI model providers (OpenAI, Azure OpenAI, Ollama) and cloud storage.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=General+%26+Connections\u0026amp;title=Connections\u0026amp;description=Configure+AI+model+providers+%28OpenAI%2C+Azure+OpenAI%2C+Ollama%29+and+cloud+storage.\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=9f186cd110197e4512548b7c741323f0496f4039a6afc35eba200d0cf54ae190\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/en/admin/settings/connections\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/admin/settings/connections.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/admin/settings/connections\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/admin/settings/connections\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/admin/settings/connections\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/en/admin/settings/connections#webpage\",\"url\":\"https://docs.cloosphere.ai/en/admin/settings/connections\",\"name\":\"Connections\",\"description\":\"Configure AI model providers (OpenAI, Azure OpenAI, Ollama) and cloud storage.\",\"dateModified\":\"2026-08-21T07:39:12.792Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/en/admin/settings/connections#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/en/admin/settings/connections#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Settings\",\"item\":\"https://docs.cloosphere.ai/en/admin/settings/general\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"General \u0026 Connections\",\"item\":\"https://docs.cloosphere.ai/en/admin/settings/general\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Connections\",\"item\":\"https://docs.cloosphere.ai/en/admin/settings/connections\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/en/admin/settings/connections#article\",\"headline\":\"Connections\",\"name\":\"Connections\",\"description\":\"Configure AI model providers (OpenAI, Azure OpenAI, Ollama) and cloud storage.\",\"url\":\"https://docs.cloosphere.ai/en/admin/settings/connections\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/en/admin/settings/connections#webpage\"},\"dateModified\":\"2026-08-21T07:39:12.792Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/admin/settings/connections.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"pages":[{"title":"ko","href":"/ko/admin/settings/connections"}]},{"language":"en","tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/en"}]},{"tab":"Chat","icon":"comments","pages":[{"title":"Chat","href":"/en/chat/overview"}]},{"tab":"Workspace","icon":"briefcase","pages":[{"title":"Workspace","href":"/en/workspace/overview"}]},{"tab":"Collaboration","icon":"users","pages":[{"title":"Collaboration","href":"/en/collaboration/overview"}]},{"tab":"Automation","icon":"clock","pages":[{"title":"Automation","href":"/en/automation/overview"}]},{"tab":"Admin","icon":"gear","groups":[{"group":"Admin","pages":[{"title":"Admin Panel","href":"/en/admin/overview"}]},{"group":"Users","pages":[{"title":"User Management","href":"/en/admin/users"},{"title":"Groups \u0026 Permissions","href":"/en/admin/groups"},{"title":"Organization Management","href":"/en/admin/organizations"},{"title":"Inquiries","href":"/en/admin/inquiries"}]},{"group":"Settings","pages":[{"group":"General \u0026 Connections","expanded":false,"pages":[{"title":"General","description":"Manage authentication, feature enablement, and other system-wide defaults.","href":"/en/admin/settings/general"},{"title":"Connections","href":"/en/admin/settings/connections"},{"title":"Models","description":"Manage model list, set token limits and pricing, import/export presets","href":"/en/admin/settings/models"},{"title":"Marketplace","href":"/en/admin/settings/marketplace"}]},{"group":"Knowledge \u0026 Documents","expanded":false,"pages":[{"title":"Documents","href":"/en/admin/settings/documents"},{"title":"Document Templates","href":"/en/admin/settings/document-templates"},{"title":"Search Engine","href":"/en/admin/settings/search-engine"},{"title":"Web Search","href":"/en/admin/settings/web-search"}]},{"group":"AI Features \u0026 Safety","expanded":false,"pages":[{"title":"Guardrails","href":"/en/admin/settings/guardrails"},{"title":"Code Execution","href":"/en/admin/settings/code-execution"},{"title":"Code Gateway","href":"/en/admin/code-gateway"},{"title":"Audio","href":"/en/admin/settings/audio"},{"title":"Images","href":"/en/admin/settings/images"}]},{"group":"UI \u0026 Channels","expanded":false,"pages":[{"title":"Interface","href":"/en/admin/settings/interface"},{"title":"Branding","href":"/en/admin/settings/branding"},{"title":"Channels","href":"/en/admin/notifications"},{"title":"Microsoft Teams Bot","href":"/en/admin/teams-bot"},{"title":"Embed Widgets","href":"/en/admin/settings/embed-widgets"}]},{"group":"Data \u0026 Operations","expanded":false,"pages":[{"title":"Data Retention","href":"/en/admin/settings/data-retention"},{"title":"Memory","href":"/en/admin/settings/memory"},{"title":"Monitoring","href":"/en/admin/settings/monitoring"},{"title":"Database","href":"/en/admin/settings/database"},{"title":"Encryption","href":"/en/admin/settings/encryption"},{"title":"License","href":"/en/admin/settings/license"}]}]}]},{"tab":"Monitoring","icon":"chart-line","pages":[{"title":"Monitoring","href":"/en/monitoring/overview"}]},{"tab":"Resources","icon":"screwdriver-wrench","pages":[{"title":"Resources","href":"/en/admin/deployment-checklist"}]}]}]},"basePath":"","title":"Connections - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}