{
  "category": "Our 10 featured functions",
  "display_name": "COPILOT",
  "entry_kind": "built_in_function",
  "eval_api": {
    "method": "POST",
    "url": "https://handbook.dnacalc.com/api/eval"
  },
  "function_id": "FUNC.COPILOT",
  "implementation_state": {
    "answer_bank": null,
    "detail": "Deferred by policy: the answer needs Microsoft's Copilot service. DNA Calc does not run this function yet. Microsoft's page says the function left Excel on 14 September 2026.",
    "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87",
    "in_catalogue": false,
    "state": "deferred",
    "state_label": "Deferred: needs an outside service",
    "summary": "Deferred: needs an outside service",
    "workbook_corpus": null
  },
  "implementations": [],
  "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.COPILOT.json",
  "name": "COPILOT",
  "notes": [],
  "schema": "efh.function-reference/v1",
  "section_order": [
    "what-it-does",
    "try-it",
    "quirks",
    "how-to-implement",
    "version-differences",
    "alternatives"
  ],
  "sections": {
    "alternatives": "\n- Copilot in Excel, the replacement Microsoft names.\n- `TRANSLATE` and `DETECTLANGUAGE` for those two tasks.\n- Paste a useful result as values, so it survives recalculation.\n\n\n",
    "how-to-implement": "\nDNA Calc does not run this function yet, and it is deferred by policy: the answer depends on a back end Microsoft hosted\nand controlled, and has since withdrawn. Reading a file that uses it is still worth doing correctly:\n\n1. **Keep the cached value** on load, as Excel does, and do not recalculate it silently.\n2. **Give `#NAME?` on recalculation**, which is Excel's documented outcome since the withdrawal.\n3. **Offer the formula text** so a user can replace the call.\n\nA new function with this shape would need an AI service, rate limiting, asynchronous calculation and a result whose\nshape can change. It would not be this function.\n\n\n",
    "quirks": "\n- **It was never a fixed mapping.** The model behind it could change, so one formula could give different results at\n  different times. This handbook's method of comparing recorded answers does not apply to such a function.\n- **Rate limits.** Microsoft's announcement gave 100 calls every 10 minutes and up to 300 an hour. One call with a large\n  array counted once; filling across cells counted each cell.\n- **It was a preview.** It was offered through Microsoft's Frontier and Insider programs.\n\n### When the service is unavailable\n\nMicrosoft's page describes the withdrawal itself. Results already calculated stay in workbooks as cached values. Once\nsuch a cell recalculates, it shows `#NAME?`, because Excel no longer knows the function. So a workbook can look intact\nuntil a recalculation reaches it.\n\n\n",
    "sources": "\n- [COPILOT function](https://support.microsoft.com/en-us/excel/functions/copilot-function)\n- [Bring AI to your formulas with the COPILOT function in Excel](https://techcommunity.microsoft.com/blog/microsoft365insiderblog/bring-ai-to-your-formulas-with-the-copilot-function-in-excel/4443487)\n\n",
    "version-differences": "\nMicrosoft's page lists Excel for Microsoft 365 on Windows and Mac, the web app and Excel for iPhone, before the\nwithdrawal of 14 September 2026. No Excel answers for this function are recorded here, so no comparison between Excel builds exists.\n\n\n",
    "what-it-does": "\n`COPILOT` sent a prompt and optional cell data to an AI model and returned its reply in the sheet. Microsoft withdrew\nit: its page says that from 14 September 2026 the function is no longer available in Excel, and points to Copilot in\nExcel, opened from the Copilot icon, instead.\n\n`COPILOT(prompt_part1, [context1], [prompt_part2], [context2], ...)`\n\n- **`prompt_part`** is text describing the task.\n- **`context`** is a cell or range that supplies data.\n\nPrompt parts and context arguments alternate, so a formula can place data between pieces of a prompt:\n\n```\n=COPILOT(\"Classify sentiment\",B2:B100)\n```\n\n\n"
  },
  "signature": {
    "display": "COPILOT(prompt_part1, [context1], [prompt_part2], [context2], ...)",
    "parameters": [
      {
        "description": null,
        "name": "prompt_part1",
        "optional": false,
        "repeats": false
      },
      {
        "description": null,
        "name": "context1",
        "optional": true,
        "repeats": false
      },
      {
        "description": null,
        "name": "prompt_part2",
        "optional": true,
        "repeats": false
      },
      {
        "description": null,
        "name": "context2",
        "optional": true,
        "repeats": true
      }
    ],
    "trailing_repeats": true
  },
  "sources": {
    "metadata": {
      "admission": {
        "label": "deferred",
        "reason": "Deferred by policy: the answer needs Microsoft's Copilot service. DNA Calc does not run this function yet. Microsoft's page says the function left Excel on 14 September 2026."
      },
      "arity": {
        "max": 255,
        "min": 1
      },
      "category": "Our 10 featured functions",
      "classification": {},
      "descriptions": {
        "long": null,
        "short": "Text generated by Copilot from a prompt and optional cell context",
        "short_source": "dna-calc-own"
      },
      "docs": {
        "english_description": "Categorize, summarize, and generate text using Copilot",
        "microsoft_url": "https://support.microsoft.com/en-us/office/copilot-function-5849821b-755d-4030-a38b-9e20be0cbf62"
      },
      "entry_kind": "built_in_function",
      "localized_family_names": null,
      "localized_names": [
        {
          "locale": "ar-SA",
          "name": "COPILOT"
        },
        {
          "locale": "bg-BG",
          "name": "COPILOT"
        },
        {
          "locale": "cs-CZ",
          "name": "COPILOT"
        },
        {
          "locale": "da-DK",
          "name": "COPILOT"
        },
        {
          "locale": "de-DE",
          "name": "COPILOT"
        },
        {
          "locale": "el-GR",
          "name": "COPILOT"
        },
        {
          "locale": "en-AU",
          "name": "COPILOT"
        },
        {
          "locale": "en-GB",
          "name": "COPILOT"
        },
        {
          "locale": "en-US",
          "name": "COPILOT"
        },
        {
          "locale": "es-ES",
          "name": "COPILOT"
        },
        {
          "locale": "et-EE",
          "name": "COPILOT"
        },
        {
          "locale": "fi-FI",
          "name": "COPILOT"
        },
        {
          "locale": "fr-FR",
          "name": "COPILOT"
        },
        {
          "locale": "he-IL",
          "name": "COPILOT"
        },
        {
          "locale": "hr-HR",
          "name": "COPILOT"
        },
        {
          "locale": "hu-HU",
          "name": "COPILOT"
        },
        {
          "locale": "id-ID",
          "name": "COPILOT"
        },
        {
          "locale": "it-IT",
          "name": "COPILOT"
        },
        {
          "locale": "ja-JP",
          "name": "COPILOT"
        },
        {
          "locale": "ko-KR",
          "name": "COPILOT"
        },
        {
          "locale": "lt-LT",
          "name": "„COPILOT”"
        },
        {
          "locale": "lv-LV",
          "name": "COPILOT"
        },
        {
          "locale": "nb-NO",
          "name": "COPILOT"
        },
        {
          "locale": "nl-NL",
          "name": "COPILOT"
        },
        {
          "locale": "pl-PL",
          "name": "COPILOT"
        },
        {
          "locale": "pt-BR",
          "name": "COPILOT"
        },
        {
          "locale": "pt-PT",
          "name": "COPILOT"
        },
        {
          "locale": "ro-RO",
          "name": "COPILOT"
        },
        {
          "locale": "ru-RU",
          "name": "COPILOT"
        },
        {
          "locale": "sk-SK",
          "name": "COPILOT"
        },
        {
          "locale": "sl-SI",
          "name": "Copilot"
        },
        {
          "locale": "sr-Latn-RS",
          "name": "COPILOT"
        },
        {
          "locale": "sv-SE",
          "name": "COPILOT"
        },
        {
          "locale": "th-TH",
          "name": "COPILOT"
        },
        {
          "locale": "tr-TR",
          "name": "COPILOT"
        },
        {
          "locale": "uk-UA",
          "name": "COPILOT"
        },
        {
          "locale": "vi-VN",
          "name": "COPILOT"
        },
        {
          "locale": "zh-CN",
          "name": "COPILOT"
        },
        {
          "locale": "zh-HK",
          "name": "COPILOT"
        },
        {
          "locale": "zh-TW",
          "name": "COPILOT"
        }
      ],
      "signature": {
        "display": "COPILOT(prompt_part1, [context1], [prompt_part2], [context2], ...)",
        "parameters": [
          {
            "description": null,
            "name": "prompt_part1",
            "optional": false,
            "repeats": false
          },
          {
            "description": null,
            "name": "context1",
            "optional": true,
            "repeats": false
          },
          {
            "description": null,
            "name": "prompt_part2",
            "optional": true,
            "repeats": false
          },
          {
            "description": null,
            "name": "context2",
            "optional": true,
            "repeats": true
          }
        ],
        "trailing_repeats": true
      },
      "surface_name": "COPILOT",
      "version_marker": null,
      "xlcall": null
    },
    "microsoft": "https://support.microsoft.com/en-us/office/copilot-function-5849821b-755d-4030-a38b-9e20be0cbf62"
  },
  "try_it": {
    "formula": "=COPILOT(\"Describe these values\",B2:B4)",
    "inputs": {
      "B2": 1,
      "B3": 2,
      "B4": 3
    },
    "note": "This example needs an Excel service or external provider that OneCalc cannot supply in this preview.",
    "preview_status": "refused"
  },
  "url": "https://handbook.dnacalc.com/functions/COPILOT.html",
  "variants": [],
  "versions": []
}