{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Load Data - load_data","description":"API documentation for Celonis APIs.","siteUrl":"https://developer.celonis.com/","keywords":"celonis developer portal, celonis apis, celonis api reference docs","lang":"en-US","llmstxt":{"hide":false,"description":"Celonis API documentation","sections":[{"title":"API Docs","description":"Available Celonis API Docs","includeFiles":["**/*.md"]},{"title":"API Specs","description":"All Celonis API specifications","includeFiles":["**/openapi.yaml"]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"load-data---load_data","__idx":0},"children":["Load Data - load_data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mode"]},": Both · ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Category"]},": Data Retrieval"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The primary tool for loading data from the knowledge model. It operates in two distinct modes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Intelligent mode"]}," (no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["columns"]},"): The LLM dynamically picks columns, filters, ordering, and limit at runtime."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom mode"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["columns"]}," set): The entire query is pre-configured with the columns, filters, ordering, and limit all defined in the YAML. The LLM does ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," fill any arguments. The only exception is when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["input_schema"]}," is defined. Then the LLM fills the declared input variables, which are substituted into ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${...}"]}," placeholders in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["columns"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ordering"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]},"."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can have multiple ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["load_data"]}," instances in one Process Copilot by using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unique_id"]}," to distinguish between them. You can also mix instances with intelligent and custom configurations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"intelligent-mode","__idx":1},"children":["Intelligent mode"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"- id: load_data\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"custom-mode---static-query","__idx":2},"children":["Custom mode - static query"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The LLM triggers this tool but does not fill any arguments. The query is fully defined:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"- id: load_data  \n  unique_id: get_overdue_invoices  \n  description: >-  \n    Retrieves overdue invoices with vendor, clearing date, and fiscal year.  \n    Use when the user asks about overdue or unpaid invoices.  \n  columns:  \n    - id: INVOICE.INVOICE_VENDOR_NUMBER_AND_NAME  \n    - id: INVOICE.INVOICE_CLEARING_DATE_DAY  \n    - id: INVOICE.INVOICE_FISCAL_YEAR  \n  limit: 100\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"custom-mode--with-ordering-and-filters","__idx":3},"children":["Custom mode — with ordering and filters"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"- id: load_data  \n  unique_id: vendor_summary  \n  description: Retrieves vendor data sorted by name, filtered to fiscal year 2021\\.  \n  columns:  \n    - id: vendors.vendor_name  \n    - id: INVOICE.INVOICE_CLEARING_DATE_DAY  \n    - id: KPI_DAYS_PAYABLE_OUTSTANDING  \n    - pql_template:  \n        pql: '\"BKPF\".\"MANDT\"'  \n        name: Custom PQL Column  \n  filters:  \n    - pql_template:  \n        pql: \"FILTER @fiscal_year_2021;\"  \n        name: Fiscal Year 2021  \n  orderby:  \n    - column:  \n        id: vendors.vendor_name  \n        ascending: true  \n  limit: 50\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"custom-mode--with-input-variables-llm-fills-placeholders","__idx":4},"children":["Custom mode — with input variables (LLM fills placeholders)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["input_schema"]}," is defined, the LLM fills the declared input variables at runtime. These are substituted into ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${...}"]}," placeholders in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["columns"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limits"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"- id: load_data  \n  unique_id: get_invoice_by_id  \n  description: Get invoice details for a specific invoice number.  \n  columns:  \n    - id: INVOICES.INVOICE_NUMBER  \n    - pql_template:  \n        pql: '\"invoices\".\"Invoice Value\"'  \n        name: Invoice Value  \n  filters:  \n    - pql_template:  \n        pql: FILTER \"invoices\".\"Invoice Number\" in ('${invoice_number}')  \n        name: Invoice Number Filter  \n  input_schema:  \n    properties:  \n      invoice_number:  \n        description: The invoice number to look up.\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"custom-mode--multiple-instances-in-one-process-copilot","__idx":5},"children":["Custom mode — multiple instances in one Process Copilot"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"- id: load_data # intelligent mode — LLM picks columns freely\n\n- id: load_data  \n  unique_id: get_overdue_invoices  \n  description: Retrieves overdue invoices with vendor and clearing date.  \n  columns:  \n    - id: INVOICE.INVOICE_VENDOR_NUMBER_AND_NAME  \n    - id: INVOICE.INVOICE_CLEARING_DATE_DAY  \n    - id: INVOICE.INVOICE_FISCAL_YEAR  \n  limit: 100\n\n- id: load_data  \n  unique_id: get_vendor_summary  \n  description: Retrieves a vendor overview with company code.  \n  columns:  \n    - id: INVOICE.INVOICE_VENDOR_NUMBER_AND_NAME  \n    - id: INVOICE.INVOICE_FISCAL_YEAR  \n    - id: INVOICE.INVOICE_COMPANY_CODE_AND_TEXT  \n  limit: 50\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"config-fields","__idx":6},"children":["Config fields"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-tools-load-data.bea344045bb2965274117e6f23c5a525761eb3a280e0343e3a7b6c7bede58218.a6bd5218.png","alt":"mcp-tools-load-data.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Type"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["columns"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["list"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Column IDs or PQL templates. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setting this field automatically activates the Custom Configuration mode ."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["list"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filter IDs or PQL templates (can use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${input}"]}," placeholders)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderby"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["list"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Ordering rules. Each has a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["column"]}," (ID or PQL) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ascending"]}," flag."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["int or string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Max rows returned. Can be a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${variable}"]}," template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["input_schema"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Defines input variables the LLM fills at runtime (for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${...}"]}," placeholders in columns/filters/limit). Without this, the LLM fills ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["no"]}," arguments in the Custom Configuration mode."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each column entry is either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{id: \"...\"}"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{pql\\_template: {pql: \"...\", name: \"...\"}}"]},"."]}]},"headings":[{"value":"Load Data - load_data","id":"load-data---load_data","depth":1},{"value":"Intelligent mode","id":"intelligent-mode","depth":2},{"value":"Custom mode - static query","id":"custom-mode---static-query","depth":2},{"value":"Custom mode — with ordering and filters","id":"custom-mode--with-ordering-and-filters","depth":2},{"value":"Custom mode — with input variables (LLM fills placeholders)","id":"custom-mode--with-input-variables-llm-fills-placeholders","depth":2},{"value":"Custom mode — multiple instances in one Process Copilot","id":"custom-mode--multiple-instances-in-one-process-copilot","depth":2},{"value":"Config fields","id":"config-fields","depth":2}],"frontmatter":{"seo":{"title":"Load Data - load_data"}},"lastModified":"2026-08-26T14:08:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server-asset/tools/load_data","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}