Marfeel Copilot AI Suggestion prompt management

Marfeel Copilot+ lets organizations create, iterate, and share custom AI Suggestions through a dedicated prompt management system. Each AI Suggestion consists of the following parts:

1. Name: The designated title under which the Suggestion will be displayed.
2. Placement: The specific locations where the Suggestion will appear — options are the following:
   • Sidebar tab: for document-level Suggestions to appear on the sidebar. A phase tab needs to be chosen between Ideation, Editing or Distribution.
   • Ask AI for selection-level Suggestions.
   • Article detail.
3. Visibility: Only available to Copilot managers. Enables organizations to expand the reach of a particular Suggestion across all Copilot users within the organization.
4. Model: Limited to Marfeel admins, facilitates the selection of the appropriate LLM model.
5. User prompt: The prompt itself that describes what to do and how.
6. Custom fields: Marfeel Copilot+ enables users to execute Parametrized Suggestions. These defined parameters will be asked to users during execution.

Custom User prompts

Marfeel Copilot offers a Suggestion Management system to assist organizations in creating, iterating, and sharing AI Suggestions for enhanced editing processes. Prominent AI models like GPT-3.5, GPT-4, Llama, Anthropic, Mixtral, and Google Gemini operate using text prompts that users input, prompting the models to generate subsequent text. Crafting effective prompts is crucial for optimizing model responses and task completion.

These are some simple prompt examples:

1. Rewrite for simplicity: Rewrite with brevity, as concise as possible, avoiding redundancy keeping the fundamental meaning.
2. Correct spelling and grammar: Correct spelling and grammar of the following text with the minimum changes.
3. Title alternatives: Give me alternative catchy titles.
4. Summary: Make a 40-word maximum summary that keeps the main topics.

Prompts 1, 2, and 3 need a contextual text selection, while prompt 4 requires the entire article to facilitate a summarization of its contents.

The Marfeel Suggestion Manager System uses Trimou, a Mustache template engine that enables adding dynamism into prompts. The suggestions system makes two variables available within the context for customization:

1. {{selection}} to expand the selected text
2. {{article}} to expand the whole article text

Before executing the Suggestion, the variables are resolved.

Parametrized Suggestions

Some Suggestions need input parameters to execute properly. Two common examples:

1. Rewrite for paper: When adapting an article for a printed version the page layout has hard restrictions on the number of characters. This number of characters is an input parameter.
2. Articles summary: There are cases where you want to add a summary of another article you wrote. In these cases you find and select an article and then summarize it.

Using Custom Fields you can declare input parameters that will be requested from users upon AI Suggestion execution. The provided values are made available on the Mustache context as variables.

Available variables in User Prompt

These Mustache template variables are available in the prompt context:

1. {{selection}} with the selected text
2. {{article}} with the whole article text
3. {{title}} article title
4. {{language}} with the article detected language falling back to the account language
5. {{today}} today’s date

Sample Suggestions

Below are simplified working examples of custom AI Suggestions:

Rewrite for simplicity

• Display in Ask AI: Selection
• Custom field: -
• User Prompt:

Rewrite the provided text with brevity, as concise as possible, avoiding redundancy keeping the fundamental meaning. Text: {{selection}}

Correct spelling and grammar

• Display in Ask AI: Selection
• Custom field: -
• User Prompt:

Correct spelling and grammar of the following text with the minimum changes. Text: {{selection}}

Title alternatives

• Display in Ask AI: Selection
• Custom field: -
• User Prompt:

Give me 3 alternative catchy titles for "{{selection}}"

Summary

• Display in Sidebar: Editing
• Custom field: -
• User Prompt:

Make a 40-word maximum summary that keeps the main topics for the following article. {{article}}

Rewrite for paper

• Display in Ask AI : New block
• Custom field Num characters with field key numChars
• User Prompt:

Rewrite the article provided below to use exactly {{customFields.numChars}} characters. Make the minimum changes:
{{article}}

Articles summary

• Display in Ask AI : New block
• Custom field Num characters with field key numChars
• User Prompt:

Write a short and concise one paragraph summary for each article provided.

{{#customFields.articles}}
Article {{iter.index}}:
"{{{title}}} — {{{body}}}"
{{/customFields.articles}}

Organization-level Suggestions management

AI Suggestions can have All Organization or Team visibility and can be enabled or disabled.

Users with Copilot Manager role can:

1. Change the visibility of a Suggestion to Organization so it’s widely viewable to all users in the organization.
2. Alternatively, these users can switch the visibility of a Suggestion to any existing team.

Tip: You can create prompts for different teams and organize them by sections. This way, your editors will only see the prompts they need to use. Check our guide on how to manage groups using Teams.

3. Disable an organization-wide Suggestion so users don’t see it.
4. Disable a Marfeel Suggestion so users don’t see it.

A user can:

1. Create as many Suggestions as needed.
2. Disable personal Suggestions to hide them from any placement.

What variables are available in a Marfeel Copilot AI Suggestion prompt?

Five Mustache template variables are available: {{selection}} for the selected text, {{article}} for the full article text, {{title}} for the article title, {{language}} for the detected article language (falling back to account language), and {{today}} for the current date.

How do parametrized Suggestions work in Marfeel Copilot+?

Parametrized Suggestions use Custom Fields to declare input parameters that are requested from users at execution time. The provided values become available as Mustache context variables (e.g., {{customFields.numChars}}) inside the User Prompt.

How can a Copilot Manager share AI Suggestions across an organization?

Users with the Copilot Manager role can change a Suggestion’s visibility to Organization (visible to all users) or to any existing team. They can also disable organization-wide or Marfeel-provided Suggestions so users don’t see them.