[{"data":1,"prerenderedAt":603},["ShallowReactive",2],{"navigation_docs":3,"-gateway-data-integrations":160,"-gateway-data-integrations-surround":598},[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":48,"body":162,"description":591,"extension":592,"links":593,"meta":594,"navigation":595,"path":49,"seo":596,"stem":50,"__hash__":597},"docs\u002F2.gateway\u002F5.data-integrations.md",{"type":163,"value":164,"toc":570},"minimark",[165,169,175,180,183,186,190,198,203,206,209,219,223,226,252,255,259,266,269,275,279,282,349,353,358,413,417,422,463,466,475,479,517,520,524,536,540,548,552],[166,167,168],"p",{},"Data Integrations give your applications access to your organization's documents. On each request, Optiak searches the documents an application uses and adds the most relevant passages to the model's context, so answers draw on your own content without you sending whole documents.",[170,171,174],"who-panel",{":applies-to":172,":roles":173},"[\"LLM requests\"]","[\"Organization Admin\", \"Workspace Admin\", \"Project Admin\", \"App Admin\"]","Organization Admins add the document sources and choose which applications can use each one. Organization Admins, Workspace Admins, Project Admins, and App Admins can then turn them on for their application.",[176,177,179],"h2",{"id":178},"why-use-it","Why use it",[166,181,182],{},"Models only know what they were trained on and what you send them. Product documentation, support policies or customer-specific content usually lives in files and workspace tools, out of the model's reach. Data Integrations bring that content into Optiak once and let the Gateway find the relevant parts for each request, so your services don't have to build retrieval themselves.",[166,184,185],{},"Keeping each source in its own Data Integration also lets you control which application uses which content. For example, a support assistant can use the support policies without seeing internal engineering notes.",[176,187,189],{"id":188},"how-it-works","How it works",[166,191,192,193,197],{},"A ",[194,195,196],"strong",{},"Data Integration"," connects one source of documents to Optiak: files you upload, or content Optiak syncs from a tool your organization already uses. Optiak keeps its own copy of the documents and prepares them for retrieval.",[199,200,202],"h3",{"id":201},"retrieval-on-each-request","Retrieval on each request",[166,204,205],{},"Every chat completion or response request becomes a question to your documents. Optiak reads what the user is asking, finds the passages across the application's Data Integrations that speak to it, and places them in the context the model sees. The model answers with your knowledge in front of it, and your application sends nothing extra.",[166,207,208],{},"Retrieval is selective: only passages that are actually relevant make it into the context. When nothing in your documents fits the request, the request reaches the model as it was sent, with no padding.",[166,210,211,212,215,216,218],{},"Retrieval happens after the input checks of ",[213,214,58],"a",{"href":59}," and before the ",[213,217,43],{"href":44}," shapes the final context, so the retrieved knowledge counts toward the same context budget as the rest of the request. It applies to streaming and non-streaming requests.",[199,220,222],{"id":221},"when-an-application-can-use-a-data-integration","When an application can use a Data Integration",[166,224,225],{},"An application can use a Data Integration's documents only when all of these hold:",[227,228,229,236,247],"ul",{},[230,231,232,235],"li",{},[194,233,234],{},"The Data Integration is active."," Inactive ones are kept, but they are never synced or used by applications.",[230,237,238,241,242,246],{},[194,239,240],{},"Its scope includes the application."," The scope says which applications or projects may use it; see ",[213,243,245],{"href":244},"#set-it-up","Set it up",".",[230,248,249],{},[194,250,251],{},"The application has it enabled.",[166,253,254],{},"A request can't add Data Integrations its application doesn't use.",[176,256,258],{"id":257},"sources","Sources",[166,260,261,262,265],{},"Each Data Integration reads from one source. ",[194,263,264],{},"File Upload"," takes files you upload to Optiak; the other sources are connected sources that Optiak syncs from a tool your organization already uses, through an organization-wide connection.",[166,267,268],{},"Connected sources sync when an Organization Admin starts a sync; changes in the source don't reach Optiak until then. Each sync adds new documents, updates changed ones and removes documents that are no longer in the source. Optiak only reads from the source and never changes its content. A Data Integration must be active to sync.",[270,271,274],"callout",{"color":272,"icon":273},"warning","i-lucide-triangle-alert","A new Data Integration for a connected source has no documents until its first sync. Sync it after you create it, or applications won't retrieve anything from it.",[199,276,278],{"id":277},"file-upload","File upload",[166,280,281],{},"Upload files directly to Optiak, with no connection or sync needed. When you create the Data Integration, the files you choose upload when you save it; after that, files you add or delete take effect right away.",[283,284,285,298],"table",{},[286,287,288],"thead",{},[289,290,291,295],"tr",{},[292,293,294],"th",{},"Setting",[292,296,297],{},"Value",[299,300,301,329,339],"tbody",{},[289,302,303,309],{},[304,305,306],"td",{},[194,307,308],{},"File types",[304,310,311,312,316,317,320,321,324,325,328],{},"PDF, Markdown (",[313,314,315],"code",{},".md","), plain text (",[313,318,319],{},".txt","), Word (",[313,322,323],{},".docx","), PowerPoint (",[313,326,327],{},".pptx",")",[289,330,331,336],{},[304,332,333],{},[194,334,335],{},"Files per upload",[304,337,338],{},"Up to 10",[289,340,341,346],{},[304,342,343],{},[194,344,345],{},"File size",[304,347,348],{},"Up to 50 MB per file",[199,350,352],{"id":351},"google-drive","Google Drive",[166,354,355,356,246],{},"Sync the documents in one Google Drive folder. You give the folder ID or the folder URL when you create the Data Integration; Optiak reads the folder through an organization-wide Google Drive connection. To connect an account, see ",[213,357,140],{"href":141},[283,359,360,368],{},[286,361,362],{},[289,363,364,366],{},[292,365,294],{},[292,367,297],{},[299,369,370,380,394,404],{},[289,371,372,377],{},[304,373,374],{},[194,375,376],{},"What is synced",[304,378,379],{},"Files directly inside the folder. Subfolders and files in the trash are not synced.",[289,381,382,386],{},[304,383,384],{},[194,385,308],{},[304,387,388,389,324,391,393],{},"Google Docs, Google Slides, PDF, Markdown, plain text, Word (",[313,390,323],{},[313,392,327],{},"). Other files are skipped.",[289,395,396,401],{},[304,397,398],{},[194,399,400],{},"Folder size",[304,402,403],{},"Up to 100 supported files. A larger folder fails to sync.",[289,405,406,410],{},[304,407,408],{},[194,409,345],{},[304,411,412],{},"Files over 50 MB are skipped.",[199,414,416],{"id":415},"notion","Notion",[166,418,419,420,246],{},"Sync the pages of a Notion workspace. Optiak reads the pages that are shared with its Notion integration, through an organization-wide Notion connection. To connect a workspace and choose the pages to share, see ",[213,421,140],{"href":141},[283,423,424,432],{},[286,425,426],{},[289,427,428,430],{},[292,429,294],{},[292,431,297],{},[299,433,434,443,453],{},[289,435,436,440],{},[304,437,438],{},[194,439,376],{},[304,441,442],{},"The pages shared with the Optiak integration",[289,444,445,450],{},[304,446,447],{},[194,448,449],{},"Number of pages",[304,451,452],{},"Up to 100. If more pages are shared, the sync fails.",[289,454,455,460],{},[304,456,457],{},[194,458,459],{},"Page size",[304,461,462],{},"Pages over 50 MB are skipped.",[176,464,245],{"id":465},"set-it-up",[166,467,468,469,472,473,246],{},"Setting up a Data Integration takes two steps. First, an Organization Admin creates it and chooses its ",[194,470,471],{},"Scope",": which applications or projects may use it. The scope can be the whole organization, selected projects, selected applications, or a mix of projects and applications. Then each of those applications decides whether to turn it on. For who can do each step, see ",[213,474,115],{"href":116},[199,476,478],{"id":477},"in-the-organization","In the organization",[480,481,482,497,510],"ol",{},[230,483,484,485,488,489,492,493,496],{},"In the console, open ",[194,486,487],{},"Company setup",", then ",[194,490,491],{},"Data integrations",", and click ",[194,494,495],{},"Add data integration"," to pick a source from the catalog.",[230,498,499,500,502,503,506,507,509],{},"Give it a name and a ",[194,501,471],{},", and keep ",[194,504,505],{},"Setup active"," turned on. For a connected source, connect the account from the same form; see ",[213,508,140],{"href":141}," for what to prepare in the provider.",[230,511,512,513,516],{},"For File Upload, add the files. For a connected source, click ",[194,514,515],{},"Sync"," on the Data Integration.",[166,518,519],{},"A Data Integration with no scope is kept, but no application can use it yet. When you delete one, no application can use its documents any more.",[199,521,523],{"id":522},"in-the-application","In the application",[166,525,526,527,488,530,532,533,535],{},"In the console, open the application, then ",[194,528,529],{},"Configuration",[194,531,491],{},". ",[194,534,495],{}," lists the Data Integrations whose scope includes the application; add the ones it needs and keep them enabled. Changes apply to the next request.",[176,537,539],{"id":538},"limits-and-behavior","Limits and behavior",[227,541,542,545],{},[230,543,544],{},"A request with no text from the user skips retrieval.",[230,546,547],{},"An application with no enabled Data Integrations skips retrieval for every request.",[176,549,551],{"id":550},"related","Related",[227,553,554,559,564],{},[230,555,556,558],{},[213,557,140],{"href":141},": connect the accounts that connected sources read from.",[230,560,561,563],{},[213,562,43],{"href":44},": how the retrieved passages fit into the context sent to the model.",[230,565,566,569],{},[213,567,568],{"href":29},"Gateway overview",": where Data Integrations act in a request.",{"title":571,"searchDepth":572,"depth":572,"links":573},"",2,[574,575,580,585,589,590],{"id":178,"depth":572,"text":179},{"id":188,"depth":572,"text":189,"children":576},[577,579],{"id":201,"depth":578,"text":202},3,{"id":221,"depth":578,"text":222},{"id":257,"depth":572,"text":258,"children":581},[582,583,584],{"id":277,"depth":578,"text":278},{"id":351,"depth":578,"text":352},{"id":415,"depth":578,"text":416},{"id":465,"depth":572,"text":245,"children":586},[587,588],{"id":477,"depth":578,"text":478},{"id":522,"depth":578,"text":523},{"id":538,"depth":572,"text":539},{"id":550,"depth":572,"text":551},"Add relevant passages from your organization's documents to each request.","md",null,{},{"icon":51},{"title":48,"description":591},"LXU2m8c5QM1m747G7hEBJe-N-wiZPJH0fKJygcMRWt4",[599,601],{"title":43,"path":44,"stem":45,"description":600,"icon":46,"children":-1},"Reduce the input tokens each request sends to the model, and measure the effect before you apply it.",{"title":53,"path":54,"stem":55,"description":602,"icon":56,"children":-1},"Give your applications tools from multiple MCP servers through one endpoint.",1795006122110]