A contract is the saved list of what one actor may do. Each line on it is a
switch. A switch that is on is a grant: a yes you give ahead of time.
This page lists Recued's own switches. Packs add their own. On the Contracts
page, a pack switch shows the words its pack wrote.
This page is made from the same words the Contracts page shows. So the two
always say the same thing.
#Three kinds of switch
- AI tools. An AI app, or your own chat, calls these by name. Recipes do not.
- Operations. These are the steps a recipe can take. Some AI tools check one
before they act.
- Data switches. These say which of your data an AI or a recipe may read.
Turning an operation off stops an AI from using it on its own. A recipe you allow
on that contract can still run it as a step. To stop that too, turn the recipe
off. See Grants and approvals.
An AI tool often needs more than its own switch. Say you turn on work.create.
It still adds no task until core.work-entity.task.create is on too.
A contract you make for an AI app starts with every switch off. So turn on each
tool you want, and then the switches it needs. On the Contracts page, they are
listed under each tool. You can turn them on right there. The tables below list
them too.
Each tool says what else it needs.
| Switch |
What it does |
account.search |
Search CRM accounts. Searches the companies copied from your CRM. To search the CRM itself, the search switch of that CRM must be on too. |
calendar.create |
Add a calendar event. Adds an event to your calendar. Needs core.data.calendar.create. |
calendar.search |
Search your calendar. Finds events by title, place or who is coming. Needs data.calendar. |
calendar.update |
Change a calendar event. Changes an event on your calendar. Needs core.data.calendar.update. |
contact.read |
Read the details of a contact. Reads the title, birthday, address and relationship of one contact. Needs data.contact. |
contact.search |
Search your contacts. Finds people in your contacts by name, email, phone, company or nickname. Needs data.contact for your own contacts. To search the CRM itself, the search switch of that CRM must be on too. |
contact.write |
Add or change a contact. Adds a contact, or changes a contact's name, phone, company, birthday or anniversary. You approve each one. Needs core.contact.write and data.contact. A contact's relationship and privacy marks stay yours to set, in Contacts. |
deal.search |
Search CRM deals. Searches the deals copied from your CRM. Needs data.contact to show the contact on a deal. To search the CRM itself, the search switch of that CRM must be on too. |
Each tool says what else it needs.
| Switch |
What it does |
document.read |
Read a document. Reads the text of a file, like an email attachment or a stored PDF. Needs data.file. Also needs core.storage.data-file-read for a plain text file and core.storage.file.read-temp for a document it converts. To convert a document, the MarkItDown or Docling pack must be installed, with its convert switch on. |
document.search |
Search document contents. Finds words inside saved files and attachments, with excerpts and file links. Needs data.file. Also needs core.storage.data-file-read to read text and verify saved matches and core.storage.file.read-temp to read converted documents. Uses installed MarkItDown or Docling when conversion is needed. Shows files it could not search. |
enrichment.search |
Search worked-out facts. Finds facts Recued worked out about records, like a score or a summary. Each kind of fact also needs its own switch on the Entities tab. |
episode.record |
Record your day. Records what you did or skipped on a day, in your words, as your history. Needs core.situation.record. Naming an item from your agenda also needs the read switch for that kind of item. |
file.search |
Search your files. Finds files in your connected folders. Needs data.file. |
mail.read |
Read an email. Reads one email in full and lists its attachments. Needs data.mail. Also needs data.file to list attachments. |
mail.search |
Search your mail. Searches your mail by subject, sender, words or date. Needs data.mail. |
Each tool says what else it needs.
| Switch |
What it does |
memory.forget |
Forget a saved fact. Forgets a fact the AI saved earlier. You can bring it back. Needs core.memory.write. |
memory.relations |
Look up how to save a fact about someone. Tells an AI how to save a fact about a person or a thing, like "Mia is Dana's daughter". Then one fact is saved the same way each time. Needs core.memory.write. |
memory.search |
Search your memory. Finds facts and notes saved in your memory. Needs core.memory.read. |
memory.write |
Save to your memory. Saves a fact to your memory. You can see it and undo it. Needs core.memory.write. |
recipe.run |
Run a recipe. Runs one of your recipes. Each step of the recipe needs its own switch here, unless the recipe is on under Recipes. |
recipe.schedule |
Schedule a recipe. Sets a recipe to run later or on a timer. Needs core.schedule.recipe. Only you can schedule, from your own chat. An AI app that connects with a key cannot. |
recipe.stop |
Stop a recipe. Stops a recipe run that the same conversation started. |
schedule.list |
Read scheduled requests. Lists saved requests and their timing. Needs core.schedule.prompt. |
schedule.pause |
Pause a scheduled request. Stops future and queued occurrences. A turn already running can finish. Needs core.schedule.prompt. |
schedule.remove |
Remove a scheduled request. Removes future and queued occurrences. The conversation and its history remain. Needs core.schedule.prompt. |
Each tool says what else it needs.
| Switch |
What it does |
schedule.resume |
Resume a scheduled request. Starts future occurrences of a paused request. Needs core.schedule.prompt. |
schedule.run_prompt |
Schedule an AI request. Runs a saved request later in its own conversation. Needs core.schedule.prompt. |
schedule.update |
Edit a scheduled request. Changes the saved request or its timing. Needs core.schedule.prompt. |
situation.query |
Ask what is going on. Gets a short, ranked picture of what is going on around a time. Needs core.situation.read. Each kind of item in the picture also needs its own read switch and data switch. |
work.create |
Add a task, note or more. Adds a task, note, commitment, project or thing you own. Needs core.work-entity.task.create to add tasks, core.work-entity.note.create to add notes, core.work-entity.commitment.create to add commitments, core.work-entity.project.create to add projects and core.work-entity.asset.create to add things you own. |
work.read |
Read a task, note or more. Reads one task, note, commitment, project, booking or thing you own in full. Needs core.work-entity.read. Also needs data.task for tasks, data.note for notes, data.commitment for commitments, data.project for projects, data.booking for bookings and data.asset for things you own. |
Each tool says what else it needs.
| Switch |
What it does |
work.search |
Search tasks, notes and more. Finds tasks, notes, commitments, projects, bookings and things you own. Needs core.work-entity.read. Also needs data.task for tasks, data.note for notes, data.commitment for commitments, data.project for projects, data.booking for bookings and data.asset for things you own. |
work.type |
Look up a type of thing you own. Tells an AI which dates and reminders a type of thing has, such as a passport, before it adds one. Needs core.work-entity.asset.create. |
work.update |
Change a task, note or more. Changes a task, note, commitment, project or thing you own, or ticks a task off. Needs core.work-entity.task.update to change tasks, core.work-entity.note.update to change notes, core.work-entity.commitment.update to change commitments, core.work-entity.project.update to change projects, core.work-entity.asset.update to change things you own and core.work-entity.task.mark-done to tick a task off. |
#Operations
Recipes use these as steps. Some AI tools check one before they act. They are
grouped below by what they reach, the same way the Contracts page groups them.
#Mail
| Switch |
What it does |
core.mail.body-read |
Read the full text of an email. Reads the whole text of one email. |
core.mail.delete |
Delete an email. Deletes one email from your mail account and from your server. |
core.mail.draft.create |
Save a new draft. Saves a new email draft on your server. Nothing is sent. |
core.mail.draft.delete |
Delete a saved draft. Deletes an email draft saved on your server. |
core.mail.draft.read |
Read a saved draft. Reads an email draft saved on your server. |
core.mail.draft.save-to-mailbox |
Put a draft in your mailbox. Copies a saved draft into the Drafts folder of your mail account. You can finish it in your mail app. |
core.mail.draft.update |
Change a saved draft. Changes an email draft saved on your server. |
core.mail.email.get |
Read one stored email. Reads one email from a mailbox stored on your server, by its id. |
core.mail.email.list |
List stored emails. Lists emails from a mailbox, picked by sender, folder, date and more. |
core.mail.email.search |
Search stored emails. Searches the words in the emails stored on your server. |
core.mail.fact.get |
Read one mail fact. Reads one thing Recued found in your mail, like a parcel or a bill, and the facts behind it. |
core.mail.fact.list |
List mail facts. Lists the parcels, orders and bills Recued found in your mail, newest first. |
core.mail.flag |
Flag an email. Stars or flags one email, or takes the flag off. |
core.mail.get |
Read one email. Reads one email from the copy of your mail on your server. |
#Mail, part 2
| Switch |
What it does |
core.mail.mark |
Mark an email read or unread. Marks one email read or unread, in your mail account and on your server. |
core.mail.move |
Move an email to a folder. Files one email into another folder or label. |
core.mail.notify-booking-visitor |
Email the visitor of a booking. Tells the person behind a booking that it changed. Recued finds their address itself, so the recipe never sees it. |
core.mail.send |
Send an email. Sends an email from one of your mail accounts. |
core.mail.sent.reconcile |
Check that an email really went. Asks your mail provider whether an email Recued sent really left, and records the answer. |
core.mail.thread-read |
Read an email thread. Puts every email in one thread together, oldest first. |
#Calendar
| Switch |
What it does |
core.data.calendar.create |
Create a calendar event. Adds an event to one of your calendars. Needed by calendar.create. |
core.data.calendar.delete |
Delete a calendar event. Deletes an event from one of your calendars. |
core.data.calendar.get |
Read one calendar event. Reads one event from the copy of your calendar on your server. |
core.data.calendar.list |
List calendar events. Lists events from one calendar, or from all of them, in time order. |
core.data.calendar.rsvp |
Answer an invitation. Says yes, no or maybe to a meeting invitation, for you. |
core.data.calendar.search |
Search calendar events. Searches the titles, notes and places of your events. |
core.data.calendar.stat |
Check a calendar event. Checks whether an event exists and reads its time and status, without the details. |
core.data.calendar.update |
Change a calendar event. Changes an event on one of your calendars. Needed by calendar.update. |
| Switch |
What it does |
core.contact.business-context |
See the business links of a contact. Counts the deals, tasks, meetings, bookings and projects linked to one contact. It uses no AI. |
core.contact.engagements.read |
See your history with a contact. Lets an AI read the emails, meetings and other contact you have had with one person. |
core.contact.resolve |
Find a contact. Finds a contact from an email, a phone number, a nickname or an account on another site. |
core.contact.upsert |
Add or update a contact. Adds a contact, or updates the one with the same email. |
core.contact.write |
Change your contacts. Lets an AI add a contact, or change a contact's name, phone, company, birthday or anniversary. Each change waits for your yes, unless you let it run without asking, and then counts as yours. Needed by contact.write. |
#Files
| Switch |
What it does |
core.storage.csv.columns |
Read spreadsheet columns. Reads the column names of a CSV file. |
core.storage.csv.filter |
Save matching spreadsheet rows. Saves the rows of a CSV file that match into a new file. |
core.storage.csv.inspect |
Inspect a spreadsheet. Reads column names, row counts and a small sample from a CSV file. Saves nothing. |
core.storage.csv.rows |
Search a spreadsheet. Returns the rows of a CSV file that match, and saves nothing. |
core.storage.csv.stats |
Sum up a spreadsheet. Counts the rows of a CSV file and sums up each column. |
core.storage.csv.transform |
Create a spreadsheet from other files. Filters, joins, compares or sums up CSV files and saves a new file. The source files stay the same. |
core.storage.data-file-read |
Read a received file. Reads a file your server received, like an email attachment. Needed by document.search to read text and verify saved matches, and by document.read for a plain text file. |
core.storage.file.delete |
Delete a file. Deletes one file from a connected folder. |
core.storage.file.fetch-remote |
Fetch files from connected apps. Lets Recued fetch what is in a file from a connected app, like a cloud drive. It applies to the whole server. |
core.storage.file.folders |
List your folders. Lists your connected folders, and whether a file can be saved into each one. |
core.storage.file.get |
Read one stored file. Reads one file stored on your server, by its id. |
core.storage.file.list |
List files. Lists the files in a connected folder. |
#Files, part 2
| Switch |
What it does |
core.storage.file.move |
Move a file. Moves a file to another place. |
core.storage.file.persist |
Keep a file a step made. Keeps a file that a recipe step made, so it is not thrown away when the run ends. |
core.storage.file.put-ref |
Copy a file into a folder. Writes a stored file into a named place in a connected folder. |
core.storage.file.read |
Read a file. Reads what is in one file in a connected folder. |
core.storage.file.read-temp |
Read a file a step made. Reads a file that an earlier step in the same run made. Needed by document.search to read converted documents, and by document.read for a document it converts. |
core.storage.file.render-markdown-template |
Fill in a document template. Fills a Markdown template with a few set values, like a name and a date. |
core.storage.file.save-to-folder |
Save a file into a folder. Saves a stored file, like an email attachment, into the folder you named. |
core.storage.file.set-scan-status |
Record a virus scan result. Marks a received file as clean or flagged, after a virus scan. |
core.storage.file.stat |
Check a file. Checks whether a file exists and reads its size and date, without what is in it. |
core.storage.file.write |
Write a file. Saves a file into a connected folder. |
core.storage.ics.read |
Read a calendar file. Reads a calendar file, like an emailed invitation, and saves nothing. |
#Shared store
| Switch |
What it does |
core.storage.shared.compare-and-set |
Save a value only if unchanged. Saves a value only if nobody changed it since it was read. |
core.storage.shared.delete |
Delete a value. Deletes one saved value. |
core.storage.shared.delete-prefix |
Delete values by name. Deletes every saved value whose name starts the same way. |
core.storage.shared.list |
List values. Lists the saved values whose names start the same way. |
core.storage.shared.patch |
Change part of a value. Changes some fields of a saved value and leaves the rest. |
core.storage.shared.read |
Read a value. Reads one saved value by its name. |
core.storage.shared.search |
Search values. Searches the words in saved values. |
core.storage.shared.write |
Save a value. Saves a value under a name in the shared store, where recipes keep notes between runs. |
#Memory
| Switch |
What it does |
core.memory.annotation.create |
Add a note to a record. Sticks a small labelled fact onto a record, like a contact or an email. |
core.memory.annotation.delete |
Remove notes from records. Removes the labelled facts that this recipe stuck onto records. |
core.memory.annotation.list |
List notes on records. Lists the labelled facts stuck onto records. |
core.memory.annotation.search |
Search notes on records. Searches the words in the labelled facts stuck onto records. |
core.memory.link.create |
Link two records. Records that two things belong together, like an email and the contact who sent it. |
core.memory.link.delete |
Remove links. Removes the links between records that match, whoever made them. |
core.memory.link.list |
List links. Lists the links between records. |
core.memory.read |
Read your memory. Lets an AI search the facts and notes saved in your memory. Needed by memory.search. |
core.memory.timeline.read |
Read the timeline of a record. Lists everything about one person or thing in date order: mail, events, notes and more. |
core.memory.write |
Save to your memory. Lets an AI save a fact to your memory, or forget one it saved. You see each one and can undo it. Needed by memory.relations, memory.write and memory.forget. |
#Audit trail
| Switch |
What it does |
core.audit.read |
Read run history. Lets an AI read what your recipes did, and when. |
#Enrichments
| Switch |
What it does |
core.data.enrichment.describe |
See which facts exist. Lets an AI see the kinds of facts Recued works out, and what each one holds. |
core.data.enrichment.list |
List worked-out facts. Lists the facts Recued worked out about records, newest first. |
core.data.enrichment.read |
Read worked-out facts. Lets an AI read the facts Recued worked out about a record. |
core.data.enrichment.upsert |
Save a worked-out fact. Saves a fact Recued worked out about a record, like a score or a summary. |
core.data.enrichment.vector-search |
Search facts by meaning. Lets an AI find worked-out facts that mean something close to what it asks. |
#Tasks & notes
| Switch |
What it does |
core.work-entity.asset.create |
Add a thing you own. Adds a thing you keep track of, like a car or a device, and where its facts came from. Needed by work.type, and by work.create to add things you own. |
core.work-entity.asset.delete |
Delete a thing you own. Deletes a thing you keep track of, with its readings. |
core.work-entity.asset.observe |
Record a reading. Lets a recipe record a reading, like a meter value, for a thing you own. It records only what you allowed. |
core.work-entity.asset.update |
Change a thing you own. Changes the facts about a thing you keep track of. Needed by work.update to change things you own. |
core.work-entity.booking.create |
Create a booking. Adds a booking: who the customer is, when it is, and what it is worth. |
core.work-entity.booking.delete |
Delete a booking. Deletes a booking. |
core.work-entity.booking.update |
Change a booking. Changes a booking, which is also how a booking is cancelled or finished. |
core.work-entity.commitment.cancel |
Cancel a commitment. Marks a commitment as cancelled. |
core.work-entity.commitment.create |
Create a commitment. Adds a commitment: a promise you made, or one made to you. Needed by work.create to add commitments. |
core.work-entity.commitment.fulfill |
Mark a commitment kept. Marks a commitment as kept. |
core.work-entity.commitment.propose |
Suggest a commitment. Suggests a commitment for you to check. It is only added once you say yes. |
#Tasks & notes, part 2
| Switch |
What it does |
core.work-entity.commitment.update |
Change a commitment. Changes the details of a commitment. Needed by work.update to change commitments. |
core.work-entity.customer-account-payment.apply |
Record a customer payment. After you check it, records a payment from a customer across the invoices it pays. |
core.work-entity.customer-account-payment.correct |
Correct a customer payment. After you check it, corrects or cancels how a payment was split across invoices. |
core.work-entity.customer-invoice.credit |
Credit a customer invoice. After you check it, records a credit on an invoice and lowers what is still owed. |
core.work-entity.customer-invoice.credit.correct |
Correct an invoice credit. After you check it, undoes a credit on an invoice and can add a new one in its place. |
core.work-entity.customer-payment.correct |
Correct an invoice payment. After you check it, corrects or cancels one payment and fixes what the invoice still owes. |
core.work-entity.customer-refund.apply |
Record a customer refund. After you check it, records a refund to a customer. |
core.work-entity.customer-refund.correct |
Correct a customer refund. After you check it, undoes a wrong refund record and can add a new one in its place. |
core.work-entity.get |
Read one task, note or more. Lets a recipe read one item, like a task or a note, by its id. |
core.work-entity.list |
List tasks, notes and more. Lets a recipe list the items of one kind: tasks, notes, commitments, projects, bookings or things you own. |
#Tasks & notes, part 3
| Switch |
What it does |
core.work-entity.note.create |
Create a note. Adds a note. It goes on your server unless the recipe picks a connected app. Needed by work.create to add notes. |
core.work-entity.note.delete |
Delete a note. Deletes a note. |
core.work-entity.note.update |
Change a note. Changes the fields of a note. Needed by work.update to change notes. |
core.work-entity.project.archive |
Archive a project. Moves a project to the archive. |
core.work-entity.project.create |
Create a project. Adds a project. It goes on your server unless the recipe picks a connected app. Needed by work.create to add projects. |
core.work-entity.project.update |
Change a project. Changes the fields of a project. Needed by work.update to change projects. |
core.work-entity.quote-completion.review |
Close or reopen a finished job. After you approve, closes the task for work the customer accepted, or reopens it for changes. |
core.work-entity.quote-signoff.release |
Release an accepted quote. After you approve, turns an accepted quote into a task and an invoice. |
core.work-entity.read |
Read tasks, notes and more. Lets an AI read and search your tasks, notes, commitments, projects, bookings and things you own. Each kind also needs its own data switch. Needed by work.search and work.read. |
core.work-entity.task.create |
Create a task. Adds a task. It goes on your server unless the recipe picks a connected app. Needed by work.create to add tasks. |
core.work-entity.task.delete |
Delete a task. Deletes a task. |
#Tasks & notes, part 4
| Switch |
What it does |
core.work-entity.task.mark-done |
Mark a task done. Ticks a task off as done. Needed by work.update to tick a task off. |
core.work-entity.task.mark-reminder-fired |
Mark a reminder task as sent. Marks a reminder kept as a task as sent, so it is no longer due. |
core.work-entity.task.update |
Change a task. Changes the fields of a task. Needed by work.update to change tasks. |
| Switch |
What it does |
core.data.form-response.get |
Read one form answer. Reads one answer to a form that you accepted. |
core.data.form-response.list |
List form answers. Lists the answers to your forms that you accepted. |
core.data.form-response.set-state |
Move a form answer along. Marks a form answer as in review, accepted, declined or a no-show. |
#Webhooks
| Switch |
What it does |
core.webhook.event.get |
Read a webhook message. Lets the recipe a webhook started read the message that started it. |
#Peers
| Switch |
What it does |
core.peer.ask |
Ask the owner of another server. Puts one question to the owner of another Recued server, then waits for the answer. |
core.peer.receive-answer |
Take answers from a peer. Lets the answer to a question you sent come back from that server. |
core.peer.receive-ask |
Take questions from a peer. Lets another Recued server put a question to you. You see it and choose the answer. |
core.storage.exchange.status |
Check a question sent to a peer. Checks what happened to a question you sent to another server. |
#Selling
| Switch |
What it does |
core.customer.status |
Let a customer check their access. Lets a customer see the state of their own access. |
core.seller.customer-access.close |
End the access of a customer. Ends the access of a customer. |
core.seller.customer-access.extend |
Extend the access of a customer. Gives a customer more time. |
core.seller.customer-access.issue |
Give a customer access. Gives a paying customer access, or gives them more time. |
core.seller.customer-access.swap-tier |
Move a customer to another tier. Moves a customer to another price tier. |
core.seller.offer.attach-fulfillment |
Link an offer to its recipe. Links an offer to the recipe that delivers it. |
core.seller.offer.ensure |
Set up a draft offer. Sets up a draft of something to sell. It cannot make the offer live. |
core.seller.offer.get |
Read an offer. Reads one of your offers. |
core.seller.offer.list |
List offers. Lists your offers. |
core.seller.order.attach-artifact |
Attach what was delivered. Attaches the finished work the customer paid for to the order. |
core.seller.order.attach-payment |
Link a checkout to an order. Links the checkout of your payment provider to an order, which then waits for payment. |
core.seller.order.confirm-payment |
Confirm an order was paid. Marks an order as paid. Nothing else can. |
core.seller.order.confirm-refund |
Confirm an order was refunded. Marks an order as refunded. Nothing else can. |
#Selling, part 2
| Switch |
What it does |
core.seller.order.confirm-renewal-payment |
Confirm a renewal was paid. Marks the order for one renewal as paid, one order for each billing period. |
core.seller.order.get |
Read an order. Reads one order. |
core.seller.order.link-customer |
Link an order to a customer. Links a paid order to the customer who got access. |
core.seller.order.link-work-entity |
Link an order to a task. Links an order to the task or commitment for the work. |
core.seller.order.list |
List orders. Lists your orders. |
core.seller.order.open |
Open an order. Opens an order for one purchase of an offer. |
core.seller.order.quote |
Price an order. Sets the price of an order that is not paid yet. |
core.seller.order.transition |
Move an order along. Moves an order to its next step, like delivering, complete or cancelled. |
core.seller.tier.get |
Read a price tier. Reads one of your price tiers. |
core.seller.tier.list |
List price tiers. Lists your price tiers. |
#Notifications
| Switch |
What it does |
core.notification.recipe-callback |
Nudge a connected AI app. Tells an AI app that an answer it asked for may have changed. The app must ask again to see anything. A contract for an AI app cannot get this. |
core.notification.send |
Send you a notification. Sends a message to you on the channels you set up, like Slack, Telegram or email. It cannot reach anyone else. |
core.preapproval.request |
Ask you to approve a future run. Puts a planned recipe run or a saved draft in front of you to approve. It cannot approve anything itself. |
core.reminder.create |
Set a reminder. Sets a reminder for you. Recued sends it once, at the time chosen. |
#Conversation history
| Switch |
What it does |
core.recall.search |
Search past conversations. Lets your own chat find what was said in earlier conversations. An AI app cannot use it. |
#Reminders
| Switch |
What it does |
core.reminder.cancel |
Cancel a reminder. Cancels a reminder still to come, so it never goes off. |
core.reminder.list |
List your reminders. Lists the reminders still to come, soonest first. |
core.reminder.update |
Change a reminder. Changes the words or the time of a reminder still to come. |
#Situations
| Switch |
What it does |
core.situation.prefetch |
Look ahead before each chat turn. Lets Recued add a short picture of what is going on to your chat before the AI answers. |
core.situation.read |
Read what is going on. Reads a short, ranked picture of what is going on around a time. Each kind of item also needs its own switches. Needed by situation.query. |
core.situation.record |
Record your day. Lets an AI record what you did or skipped on a day, in your words. Each day it records waits for your yes. Needed by episode.record. |
#AI models
A contract for an AI app cannot get these.
| Switch |
What it does |
core.ai.classify |
Sort into a category. Asks your AI model which category, from a list the recipe gives, fits some text best. |
core.ai.compare |
Compare two things. Asks your AI model how two pieces of data differ and where they match. |
core.ai.embed |
Turn text into numbers for search. Asks your AI model for numbers that stand for what some text means. Search by meaning uses them. |
core.ai.extract |
Pull out fields. Asks your AI model to pull named fields, like a date or an amount, out of free text. |
core.ai.generate |
Draft text. Asks your AI model to write a draft, like an email or an agenda, from data the recipe gives. |
core.ai.prompt |
Ask your AI model anything. Sends the recipe’s own question to your AI model and returns the answer. It cannot search the web. |
core.ai.rewrite |
Rewrite text. Asks your AI model to rewrite text in another style. |
core.ai.score |
Score against a list. Asks your AI model to score data against a list of points. |
core.ai.sentiment |
Read the mood of text. Asks your AI model whether text sounds positive, neutral or negative. |
core.ai.summarize |
Summarize. Asks your AI model for a short summary and the key points of a long text. |
core.ai.translate |
Translate. Asks your AI model to put text into another language. |
#Browser
| Switch |
What it does |
core.dom.act |
Act on web pages. Reads, types, clicks and sends forms on web pages in your browser, through the Browser Bridge. It does several steps at once, across tabs. A click or a sent form cannot be undone. |
core.dom.click |
Click on a web page. Clicks a link or a button, or presses a key, on a web page in your browser. It goes through the Browser Bridge. A click or a key can send, post or delete, and cannot be undone. |
core.dom.download |
Save a file from a web page. Saves a file a web page in your browser links to, such as a PDF, among your files. It goes through the Browser Bridge and fetches the file as the page would, signed in as you are. |
core.dom.inspect |
See a whole web page. Reads a web page open in your browser, with its links, buttons and form fields, through the Browser Bridge. Password and card fields come back empty. |
core.dom.open |
Open a web page. Opens a web page in a new tab of your browser, through the Browser Bridge. The page is asked for as you, signed in, and the address can carry data to that site. |
core.dom.read |
Read from a web page. Reads text from a web page open in your browser, through the Browser Bridge. |
core.dom.screenshot |
Take a screenshot of a web page. Takes a picture of a web page open in your browser, through the Browser Bridge. The Bridge brings its tab to the front for a moment. The picture shows the page as you see it. Needs "Allow screenshots" in the Bridge's side panel. |
#Browser, part 2
| Switch |
What it does |
core.dom.scroll |
Scroll a web page. Scrolls a web page in your browser a screen at a time. It goes through the Browser Bridge, so what loads as you scroll shows. Changes nothing on the page. |
core.dom.table |
Read a table on a web page. Reads a table on a web page open in your browser as rows of text, through the Browser Bridge. Password and card fields come back empty. |
core.dom.tabs |
See your open tabs. Lists the tabs open in your browser on a site, with their titles, through the Browser Bridge. It can list the ones showing an address. |
core.dom.wait |
Wait for a web page. Waits until part of a web page open in your browser shows or goes, through the Browser Bridge. Changes nothing on the page. |
core.dom.write |
Type into a web page. Types into a web page open in your browser, through the Browser Bridge. |
#Schedules
| Switch |
What it does |
core.schedule.prompt |
Scheduled prompts. Lets your own chat create and manage scheduled AI requests. Needed by schedule.run_prompt, schedule.list, schedule.update, schedule.pause, schedule.resume and schedule.remove. |
core.schedule.recipe |
Schedule recipes. Lets your own chat set a recipe to run later or on a timer. An AI app cannot schedule recipes. Needed by recipe.schedule. |
#Triggers
A contract for an AI app cannot get these.
| Switch |
What it does |
core.watch.http |
Watch a web page. Starts a recipe when a web page changes. |
core.watch.time |
Run only at set times. Lets a recipe run only on chosen days or hours. |
core.watch.time-relative |
Run before or after a date. Starts a recipe when the time comes near a date on a record, like a day before a meeting. |
#Web addresses
| Switch |
What it does |
core.http.download |
Download a file from a web address. Your server downloads a file from a public web address and keeps it among your files. It takes files up to 25 MB, to read or use from there. Nothing of yours is sent with it. |
core.http.get |
Get a web address. Your server fetches a public web address and answers what the site sent: its status, type and text, or JSON. Nothing of yours is sent with it, and only public addresses are fetched, never one on your own network. |
core.http.read |
Read a web address. Your server fetches a public web page and answers its text, as you would read it. Nothing of yours is sent, so a page that needs you signed in is read in your browser instead. |
#Recipes
| Switch |
What it does |
core.kitchen.draft.get |
Read Kitchen draft source. Reads source from a draft created through this connection. |
core.kitchen.draft.import |
Import source into Kitchen. Adds recipe or pack source as a draft for you to review. It does not install or run it. |
core.kitchen.draft.list |
List Kitchen drafts. Lists drafts created through this connection without returning their source. |
core.kitchen.draft.update |
Update Kitchen draft source. Saves edited source to a draft created through this connection, checking its revision. It does not install or run it. |
core.work-entity.approval-workflow.continue |
Carry on a job a customer accepted. After you approve, finishes a task, keeps a commitment or starts a saved recipe that a customer accepted. |
#Data switches
An AI or a recipe can read only the data whose switch is on.
| Switch |
What it does |
data.mail |
Your mail. Lets an AI or a recipe read the copy of your mail on your server. Needed by mail.search and mail.read. |
data.calendar |
Your calendar. Lets an AI or a recipe read your calendar events. Needed by calendar.search. |
data.file |
Your files. Lets an AI or a recipe read your stored files, like email attachments and files in your folders. Needed by mail.read to list attachments, and by document.search, document.read and file.search. |
data.contact |
Your contacts. Lets an AI or a recipe read your contacts. Needed by contact.search for your own contacts, and by contact.read and contact.write, and by deal.search to show the contact on a deal. |
data.task |
Your tasks. Lets an AI or a recipe read your tasks. Needed by work.search and work.read for tasks. |
data.note |
Your notes. Lets an AI or a recipe read your notes. Needed by work.search and work.read for notes. |
data.commitment |
Your commitments. Lets an AI or a recipe read your commitments: promises you made, or ones made to you. Needed by work.search and work.read for commitments. |
data.project |
Your projects. Lets an AI or a recipe read your projects. Needed by work.search and work.read for projects. |
data.booking |
Your bookings. Lets an AI or a recipe read your bookings. Needed by work.search and work.read for bookings. |
#Data switches, part 2
An AI or a recipe can read only the data whose switch is on.
| Switch |
What it does |
data.asset |
Things you own. Lets an AI or a recipe read the things you keep track of, like a car or a device. Needed by work.search and work.read for things you own. |
data.form_response |
Form answers. Lets an AI or a recipe read the answers to your forms. |
data.webhook |
Webhook messages. Lets an AI or a recipe read the messages other websites sent to your server. |
data.episode |
Past episodes. Lets an AI see past times you did something: when, where and with whom. It sees them only inside a situation. |
data.occasion |
Occasions. Lets an AI see the things that come back each year, like a birthday dinner. It sees them only inside a situation. |