Configure Memory

Use this when the user asks to remove a memory this assistant saved to their Configure profile, or you saved something wrong. Pass id (the memory id returned by a save or deletion preview), or match with a word the memory contains. Every deletion requires confirm: true. Omit confirm or set it to false to preview without deleting. Setting confirm: true permanently deletes the selected memories immediately, including on a first call; the server does not require a prior preview. Preview the selection and obtain the user's approval before sending confirm: true. Pass id or match; with neither, nothing is deleted. It reaches only memories this assistant saved.

configure_profile_forget

Use this when the user explicitly asks to review their Configure profile or get a profile overview, or asks to review a particular category. For personalized help or a specific fact, use configure_profile_search with a concrete query about the current task instead. Do not fetch an overview to prepare for a search or to collect background for an unrelated task. Reuse a relevant result already available. Returns the preferences, facts, projects and decisions the user chose to keep in their Configure profile, with a list of its categories. The overview is a short summary: the name, occupation, bio and interests the user shares, category names, up to 50 top memories, and which assistants saved them. The account's contact details, sign-in details and identifiers are never returned here, and no other app is read at call time; a memory that came from another app the user connected appears only as a memory they kept, listed under the name of the source that saved it. With no arguments it returns the overview; when the user asks to review a category whose id is known (for example "work"), pass box to open that category, or page to continue a long one. Read-only: it changes nothing.

configure_profile_read

Use this when the user explicitly asks you to remember, save, or keep something, or confirms a fact you proposed to save. Saves that one fact to the user's Configure profile so the assistants they connect can use it later. One fact per call, phrased as a short standalone statement about the user. When the user asks to save several facts at once, use one configure_profile_remember_many call with the whole list instead of one call per fact. A fact mentioned in passing is not a request; if it is not clear the user wants it kept, ask first. Never include passwords, keys, payment or health details, government identifiers, identity documents, sensitive personal attributes (race, religion, politics, sexuality, biometrics or genetics), or other people's personal data. The server refuses recognizable card numbers, keys, passwords and government ID numbers; this is a pattern-based backstop, so omit other sensitive facts before calling. Optionally file it under a category with box. Additive: it never deletes or changes existing memories. Tell the user in one line what was saved.

configure_profile_remember

Use this when the user asks to save several facts at once, or approves a list of facts you proposed. Saves each entry as a separate memory in the user's Configure profile, in one call. Send only facts the user asked to save or approved, each a short standalone statement about the user. If the user asks to review first, show the list and wait for their approval before calling. Use configure_profile_remember for a single fact. Accepts 1 to 25 facts per call, up to 1,000 characters each and 20,000 in total; send a longer approved list as several calls. It is not for passwords, keys, payment or health details, government identifiers, identity documents, sensitive personal attributes (race, religion, politics, sexuality, biometrics or genetics), or other people's personal data; the server's pattern checks are a backstop, not a complete filter, so these are left out before calling. Optional box files a fact under a category. Additive: it never changes or deletes existing memories. Returns a result for each entry and counts of saved, already_saved, refused and failed. Report those counts accurately, retry only failed entries, and never say the whole list was saved when some entries were refused or failed.

configure_profile_remember_many

Use this to retrieve relevant saved facts for personalized help, find a specific fact, topic or date range, and before telling the user something is not on file. For personalized help, pass a concrete query about the current task, for example "preferred package manager"; do not use an empty or * query to gather unrelated context. A search does not require an overview first. query is the words to look for; box narrows to one category from the profile overview; source narrows to what one connected assistant saved; from and to bound the date saved. Do not use it to browse the whole profile; configure_profile_read is for an explicit request to review the profile. Read-only. Returns the matching memories with the source and the date each was saved. Memory IDs are omitted; use configure_profile_forget with match to preview a requested deletion. Returns at most limit results (default 10, max 50), most relevant or most recent first, with truncated true when more matched than this page returned; narrow the filters rather than paging through everything.

configure_profile_search