[{"data":1,"prerenderedAt":505},["ShallowReactive",2],{"navigation_docs":3,"-administration-connections-data-sources-connections":160,"-administration-connections-data-sources-connections-surround":500},[4,21,62,82,103,149],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":20},"Get Started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,15],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":16,"path":17,"stem":18,"icon":19},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-lucide-play-circle",false,{"title":22,"icon":23,"path":24,"stem":25,"children":26,"page":20},"Gateway","i-lucide-network","\u002Fgateway","2.gateway",[27,32,37,42,47,52,57],{"title":28,"path":29,"stem":30,"icon":31},"Overview","\u002Fgateway\u002Foverview","2.gateway\u002F1.overview","i-lucide-waypoints",{"title":33,"path":34,"stem":35,"icon":36},"Models and Routing","\u002Fgateway\u002Fmodels-and-routing","2.gateway\u002F2.models-and-routing","i-lucide-brain",{"title":38,"path":39,"stem":40,"icon":41},"Smart Router","\u002Fgateway\u002Fsmart-routing","2.gateway\u002F3.smart-routing","i-lucide-route",{"title":43,"path":44,"stem":45,"icon":46},"Context Engine","\u002Fgateway\u002Fcontext-engine","2.gateway\u002F4.context-engine","i-product-context-engine",{"title":48,"path":49,"stem":50,"icon":51},"Data Integrations","\u002Fgateway\u002Fdata-integrations","2.gateway\u002F5.data-integrations","i-lucide-database",{"title":53,"path":54,"stem":55,"icon":56},"Tools","\u002Fgateway\u002Ftools","2.gateway\u002F6.tools","i-lucide-wrench",{"title":58,"path":59,"stem":60,"icon":61},"Guardrails","\u002Fgateway\u002Fguardrails","2.gateway\u002F7.guardrails","i-lucide-shield-alert",{"title":63,"icon":64,"path":65,"stem":66,"children":67,"page":20},"Compliance","i-lucide-shield-check","\u002Fcompliance","3.compliance",[68,72,77],{"title":69,"path":70,"stem":71,"icon":64},"Data Governance","\u002Fcompliance\u002Fdata-governance","3.compliance\u002F01.data-governance",{"title":73,"path":74,"stem":75,"icon":76},"Network Access","\u002Fcompliance\u002Fnetwork-access","3.compliance\u002F02.network-access","i-lucide-lock",{"title":78,"path":79,"stem":80,"icon":81},"Audit Logs","\u002Fcompliance\u002Faudit-logs","3.compliance\u002F03.audit-logs","i-lucide-scroll-text",{"title":83,"icon":84,"path":85,"stem":86,"children":87,"page":20},"Observability","i-lucide-eye","\u002Fobservability","4.observability",[88,93,98],{"title":89,"path":90,"stem":91,"icon":92},"Organization","\u002Fobservability\u002Forganization","4.observability\u002F1.organization","i-lucide-building-2",{"title":94,"path":95,"stem":96,"icon":97},"Application","\u002Fobservability\u002Fapplication","4.observability\u002F2.application","i-lucide-activity",{"title":99,"path":100,"stem":101,"icon":102},"Metrics","\u002Fobservability\u002Fmetrics","4.observability\u002F3.metrics","i-lucide-bar-chart-2",{"title":104,"icon":105,"path":106,"stem":107,"children":108,"page":20},"Administration","i-lucide-settings","\u002Fadministration","5.administration",[109,114,119,129,144],{"title":110,"path":111,"stem":112,"icon":113},"Organization and Projects","\u002Fadministration\u002Forganizations-and-projects","5.administration\u002F1.organizations-and-projects","i-lucide-box",{"title":115,"path":116,"stem":117,"icon":118},"Members and Access","\u002Fadministration\u002Fmembers-and-access","5.administration\u002F2.members-and-access","i-lucide-shield-user",{"title":120,"path":121,"stem":122,"children":123,"icon":76},"Authentication","\u002Fadministration\u002Fauthentication","5.administration\u002F3.authentication",[124],{"title":125,"path":126,"stem":127,"icon":128},"Connect Model APIs","\u002Fadministration\u002Fauthentication\u002Fconnect-model-apis","5.administration\u002F3.authentication\u002F31.connect-model-apis","i-lucide-cpu",{"title":130,"path":131,"stem":132,"children":133,"icon":143},"Connections","\u002Fadministration\u002Fconnections","5.administration\u002F4.connections",[134,139],{"title":135,"path":136,"stem":137,"icon":138},"Connect MCP Servers","\u002Fadministration\u002Fconnections\u002Fmcp-connections","5.administration\u002F4.connections\u002F42.mcp-connections","i-lucide-plug",{"title":140,"path":141,"stem":142,"icon":51},"Connect Data Sources","\u002Fadministration\u002Fconnections\u002Fdata-sources-connections","5.administration\u002F4.connections\u002F43.data-sources-connections","i-lucide-link",{"title":145,"path":146,"stem":147,"icon":148},"Budgets","\u002Fadministration\u002Fbudgets","5.administration\u002F5.budgets","i-lucide-wallet",{"title":150,"icon":151,"path":152,"stem":153,"children":154,"page":20},"Reference","i-lucide-book-open","\u002Freference","6.reference",[155],{"title":156,"path":157,"stem":158,"icon":159},"Using the API","\u002Freference\u002Fapi-usage","6.reference\u002F1.api-usage","i-lucide-terminal-square",{"id":161,"title":140,"body":162,"description":493,"extension":494,"links":495,"meta":496,"navigation":497,"path":141,"seo":498,"stem":142,"__hash__":499},"docs\u002F5.administration\u002F4.connections\u002F43.data-sources-connections.md",{"type":163,"value":164,"toc":483},"minimark",[165,169,175,180,183,186,189,203,207,228,232,400,404,410,425,429,462,466],[166,167,168],"p",{},"Connect an external source account or upload files so an organization Data Integration can sync documents. An Organization Admin connects the source account. Applications can retrieve its synced documents without a separate sign-in.",[170,171,174],"who-panel",{":applies-to":172,":roles":173},"[\"LLM requests\"]","[\"Organization Admin\"]","Organization Admins authorize the source account and choose which applications can use the Data Integration.",[176,177,179],"h2",{"id":178},"how-connections-work","How connections work",[166,181,182],{},"An Organization Admin connects an external source or uploads files through the Data Integration form. For external sources, the Data Integration and its assigned applications share the authorized account. Optiak reads source content during a sync and does not change the source files or pages.",[166,184,185],{},"Source access depends on the provider. For example, Google Drive reads files from one selected folder, while Notion reads pages shared with the Optiak integration in the authorized workspace. The Data Integration's scope determines which applications may use the setup, and each application must enable it before its requests can retrieve documents.",[166,187,188],{},"The following diagram illustrates the process of connecting data sources and retrieving information. The upper lane shows source content being prepared and indexed; the lower shows an application question retrieving matching passages, passing them to the model, and returning an answer.",[190,191],"data-source-flow",{":database":192,":preparation":193,":requestSteps":194,":sources":195,"caption":196,"indexTitle":197,"queryDescription":198,"queryLabel":199,"requestTitle":200,"resultsDescription":201,"resultsLabel":202},"{\"icon\":\"i-lucide-database\",\"label\":\"Vector database\",\"description\":\"Stores document vectors\"}","{\"icon\":\"i-lucide-scan-text\",\"label\":\"Prepare chunks\",\"description\":\"Split and embed\"}","[{\"icon\":\"i-lucide-message-circle\",\"label\":\"Application question\"},{\"icon\":\"i-lucide-network\",\"label\":\"Optiak Gateway\",\"brand\":true},{\"icon\":\"i-lucide-files\",\"label\":\"Relevant passages\",\"description\":\"Added to model context\"},{\"icon\":\"i-lucide-cpu\",\"label\":\"LLM provider\"},{\"icon\":\"i-lucide-message-square\",\"label\":\"Answer to application\"}]","[{\"icon\":\"i-lucide-files\",\"label\":\"Uploaded files\"},{\"icon\":\"i-logos-google-drive\",\"label\":\"Google Drive folder\"},{\"icon\":\"i-simple-icons-notion\",\"label\":\"Notion shared pages\"}]","Documents are indexed after upload or sync; relevant passages are retrieved for each request.","Index documents","The Gateway sends the question to the index.","Vector query","Answer a question","Matching content returns to model context.","Retrieved passages",[176,204,206],{"id":205},"before-you-connect","Before you connect",[208,209,210,214,217,220],"ul",{},[211,212,213],"li",{},"Use an Organization Admin account to create Data Integrations and manage their connections.",[211,215,216],{},"For an external source, have access to the account and content you want to sync. For File Upload, have the files ready.",[211,218,219],{},"Confirm your organization permits connecting the external account to Optiak; obtain approval if required.",[211,221,222,223,227],{},"Decide which projects or applications should access the documents, then set the Data Integration's ",[224,225,226],"strong",{},"Scope"," accordingly.",[176,229,231],{"id":230},"available-connections","Available connections",[233,234,236,316,365],"accordion",{"type":235},"multiple",[237,238,241,247,250,253,308],"accordion-item",{"icon":239,"label":240},"i-logos-google-drive","Google Drive",[166,242,243,246],{},[224,244,245],{},"Before you begin:"," Use a Google account that can access the folder you want to sync, and have the folder ID or URL ready.",[166,248,249],{},"Optiak uses Google OAuth to connect the account authorized by an Organization Admin. Every application using this Data Integration shares that account's access, so the account must be able to open the selected folder. Optiak syncs supported files directly inside that folder, not its subfolders.",[166,251,252],{},"To connect the account and set up the folder:",[254,255,256,274,284,291,301],"ol",{},[211,257,258,259,262,263,266,267,270,271,273],{},"In the console, open ",[224,260,261],{},"Company setup"," → ",[224,264,265],{},"Data integrations",", select ",[224,268,269],{},"Add data integration",", then choose ",[224,272,240],{},".",[211,275,276,277,266,280,283],{},"In ",[224,278,279],{},"Connection",[224,281,282],{},"Connect with Google Drive",". In the authorization window, choose the Google account and approve access.",[211,285,286,287,290],{},"Enter a ",[224,288,289],{},"Folder ID"," or paste the folder URL. Optiak stores the folder ID for this Data Integration.",[211,292,293,294,296,297,300],{},"Set a name and ",[224,295,226],{},", keep ",[224,298,299],{},"Setup active"," turned on, and add the Data Integration.",[211,302,303,304,307],{},"In the Data Integrations list, select ",[224,305,306],{},"Sync",". The row shows the sync status and last sync time.",[166,309,310,311,315],{},"See ",[312,313,48],"a",{"href":314},"\u002Fgateway\u002Fdata-integrations#google-drive"," for supported file types and sync limits.",[237,317,320,323,326,359],{"icon":318,"label":319},"i-simple-icons-notion","Notion",[166,321,322],{},"Optiak connects to Notion with OAuth using an account authorized by an Organization Admin. Every application using this Data Integration shares that account's access to the workspace, limited to pages shared with the Optiak integration.",[166,324,325],{},"Use a Notion account that can access the workspace and pages you want Optiak to read. To connect the workspace and choose the pages to sync:",[254,327,328,338,346,349,355],{},[211,329,258,330,262,332,266,334,270,336,273],{},[224,331,261],{},[224,333,265],{},[224,335,269],{},[224,337,319],{},[211,339,276,340,266,342,345],{},[224,341,279],{},[224,343,344],{},"Connect with Notion",". In the authorization window, sign in to the Notion account and approve access to the intended workspace.",[211,347,348],{},"In Notion, share the pages you want Optiak to read with its integration.",[211,350,293,351,296,353,300],{},[224,352,226],{},[224,354,299],{},[211,356,303,357,307],{},[224,358,306],{},[166,360,310,361,364],{},[312,362,48],{"href":363},"\u002Fgateway\u002Fdata-integrations#notion"," for sync limits.",[237,366,369,372,393],{"icon":367,"label":368},"i-lucide-upload-cloud","File Upload",[166,370,371],{},"File Upload needs no external account, authentication, or connection. You upload files directly to Optiak.",[254,373,374,384,387],{},[211,375,258,376,262,378,266,380,270,382,273],{},[224,377,261],{},[224,379,265],{},[224,381,269],{},[224,383,368],{},[211,385,386],{},"Choose the files in the setup form. They upload when you add the Data Integration.",[211,388,293,389,296,391,300],{},[224,390,226],{},[224,392,299],{},[166,394,395,396,399],{},"When editing an existing Data Integration, file uploads and deletions take effect immediately. See ",[312,397,48],{"href":398},"\u002Fgateway\u002Fdata-integrations#file-upload"," for supported file types and upload limits.",[176,401,403],{"id":402},"after-you-connect","After you connect",[166,405,406,407,409],{},"Connected sources sync when an Organization Admin starts a sync. Each sync adds new documents, updates changed ones, and removes documents no longer available from the source, such as files no longer in a selected Google Drive folder or pages no longer shared with the Notion integration. Source changes reach applications after the next sync. File uploads do not need a sync; added or deleted files take effect immediately. To sync a connected source again, select ",[224,408,306],{}," on the Data Integration.",[166,411,412,413,415,416,262,419,421,422,424],{},"Set the ",[224,414,226],{}," to include the projects or applications that need the documents. Application admins then open the application's ",[224,417,418],{},"Configuration",[224,420,265],{}," and enable the setup. See ",[312,423,48],{"href":49}," for how retrieval works.",[176,426,428],{"id":427},"troubleshooting","Troubleshooting",[208,430,431,437,447,456],{},[211,432,433,436],{},[224,434,435],{},"Connection required:"," the connection was removed. Edit the Data Integration and connect the source account again. Reactivate the setup if it was deactivated, then sync it.",[211,438,439,442,443,446],{},[224,440,441],{},"Needs reconnect:"," the provider rejected the saved authorization. Edit the Data Integration, select ",[224,444,445],{},"Reconnect",", and authorize the account again.",[211,448,449,452,453,455],{},[224,450,451],{},"Sync failed:"," check that the setup is active, the Google Drive folder ID is correct, or the intended Notion pages are shared with the integration. Reconnect if needed, then select ",[224,454,306],{}," again.",[211,457,458,461],{},[224,459,460],{},"Syncing:"," a sync is already running. Wait for it to finish before starting another one.",[176,463,465],{"id":464},"related","Related",[208,467,468,473,478],{},[211,469,470,472],{},[312,471,130],{"href":131},": how organization connections are shared.",[211,474,475,477],{},[312,476,48],{"href":49},": configure sources, scope, and application access.",[211,479,480,482],{},[312,481,115],{"href":116},": organization roles and permissions.",{"title":484,"searchDepth":485,"depth":485,"links":486},"",2,[487,488,489,490,491,492],{"id":178,"depth":485,"text":179},{"id":205,"depth":485,"text":206},{"id":230,"depth":485,"text":231},{"id":402,"depth":485,"text":403},{"id":427,"depth":485,"text":428},{"id":464,"depth":485,"text":465},"Manage source access and file uploads for organization Data Integrations.","md",null,{},{"icon":51},{"title":140,"description":493},"mFnADZiiMfSzDwicMZDb1c8Jk4Qhri5xiLDJDeqFTes",[501,503],{"title":135,"path":136,"stem":137,"description":502,"icon":138,"children":-1},"Prepare provider identities and choose which MCP tools applications can use.",{"title":145,"path":146,"stem":147,"description":504,"icon":148,"children":-1},"Set daily, weekly, or monthly API spend limits for your organization, projects, applications, and API keys.",1795006123685]