Advanced Prompt Management

Product Guides Platform
,
1

A Marfeel Copilot+ 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

Prominent AI models like GPT-3.5, GPT-4, Llama, Anthropic, Mixtral, or 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.

Marfeel Copilot offers a Suggestion Management system to assist organizations in creating, iterating, and sharing AI Suggestions for enhanced editing processes.

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 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

There are family of Suggestions that might need input parameters to properly execute. Some 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 might be an input parameter
  2. Articles summary: There might be cases where you want to add a summary of another article you wrote. In these cases you’ll want to 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 variables are available in the context:

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

Sample Suggestions

Find below some 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.

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

A user can:

  1. Create as many Suggestions as he/she needs.
  2. Disable personal Suggestions to not see it in any placement.
2

From Staging to Platform