Skip to main content
Context references let you point Sofie to a specific attachment or selected Sofie item inside your message. Type [[ in the chat input to open a picker, then choose the item you want to mention. Use references when a message includes several sources and you need Sofie to focus on the right one at the right moment.

​
What you can reference

The [[ picker uses the context already available in the chat input. You can reference:
  • Attached files.
  • CoDrafts.
  • CoSheets.
  • CoMeetings.
  • Workspaces.
  • Orchestrations.
  • Plans in the current conversation.
  • Selected text from a CoDraft or CoSheet when it has been added as context.
If the picker says no context items are added, click + first. Add a Sofie item with Add context or choose Attach for a local file.

​
Add a reference

1

Add context or attach a file

Click + and choose Add context or Attach. Confirm the item appears above the chat input.
2

Type double brackets

In the message, type [[.
3

Find the item

Type part of the item name to filter the picker.
4

Select the item

Click the item, or use the arrow keys and press Tab or Enter.
5

Write the instruction around the reference

Tell Sofie exactly how to use that source.
After you select an item, Sofie inserts it as a chip in the message. Remove the chip if you picked the wrong item.
Use arrows plus Tab when you are adding several references quickly. This is faster than switching between the keyboard and mouse.

​
Why references improve answers

References make source intent explicit. They help Sofie understand which attachment or context item belongs to each part of the task. This matters when:
  • Multiple attachments have similar names.
  • One source should be used for facts and another for formatting.
  • You want Sofie to compare two specific items.
  • You want to refer to a selected range or selected text.
  • You need Sofie to ignore earlier context in the conversation.
Without references:
With references:

​
Reference attachments

Attachments are useful for one-time file review. Reference an attachment when you have more than one file attached or when one file has a specific role in the prompt. Examples:

​
Reference Sofie items

Use references for existing Sofie work when the item already lives in Sofie. Examples:

​
Reference selected content

When selected text or a selected CoSheet range appears as context, reference it directly. This keeps the prompt focused on the exact excerpt or range instead of the whole artifact. Examples:

​
Combine references with search settings

References identify specific context. Search settings control how Sofie gathers additional evidence. Good combined prompt:

​
Write precise reference prompts

Use this pattern:
Example:

​
Troubleshoot references

Referencing a source helps Sofie focus, but it does not replace human review. Verify source use, calculations, conclusions, and any output used in regulated or controlled work.