For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inBook a demo
DocsReferenceChangelog
DocsReferenceChangelog
  • Getting Started
    • Overview
    • Why Humanloop?
    • Quickstart Tutorial
  • Tutorials
    • Create your first GPT-4 App
    • ChatGPT clone with streaming
  • Guides
    • Create a Prompt
      • Tool Calling in Editor
      • Tool Calling with the SDK
      • Link a JSON Schema Tool
      • Use the Snippet Tool
      • Set up semantic search (RAG)
    • Fine-tune a model
    • Manage API keys
    • Invite collaborators
    • Deploy to environments
  • Core concepts
    • Prompts
    • Tools
    • Datasets
    • Evaluators
    • Logs
    • Environments
    • Key Concepts
  • Reference
    • Supported Models
    • Access Roles
    • .prompt files
    • Postman Workspace
LogoLogo
Sign inBook a demo
On this page
  • Create and use a Snippet Tool
  • Prerequisites
GuidesTools

Use the Snippet Tool

Manage common text snippets in your Prompts
Was this page helpful?
Previous

Set up semantic search (RAG)

Set up a RAG system using the Pinecone integration
Next
Built with

The Humanloop Snippet tool supports managing common text ‘snippets’ (or ‘passages’, or ‘chunks’) that you want to reuse across your different prompts. A Snippet tool acts as a simple key/value store, where the key is the name of the common re-usable text snippet and the value is the corresponding text.

For example, you may have some common persona descriptions that you found to be effective across a range of your LLM features. Or maybe you have some specific formatting instructions that you find yourself re-using again and again in your prompts.

Instead of needing to copy and paste between your editor sessions and keep track of which projects you edited, you can instead inject the text into your prompt using the Snippet tool.

Create and use a Snippet Tool

Prerequisites

  • A Humanloop account - you can create one by going to our sign up page.
  • Be on a paid plan - your organization has been upgraded from the Free tier.
  • You already have a Prompt — if not, please follow our Prompt creation guide first.
Paid feature

The Snippet tool is not available for the Free tier. Please contact us if you wish to learn more about our Enterprise plan

To create and use a snippet tool, follow the following steps:

1

Navigate to the tools tab in your organisation and select the Snippet tool card.

2

Name the tool

Name itassistant-personalities and give it a description Useful assistant personalities.

3

Add a snippet called “helpful-assistant”

In the initial box add helpful-assistant and give it a value of You are a helpful assistant. You like to tell jokes and if anyone asks your name is Sam.

4

Add another snippet called “grumpy-assistant”

Let’s add another key-value pair, so press the Add a key/value pair button and add a new key of grumpy-assistant and give it a value of You are a grumpy assistant. You rarely try to help people and if anyone asks your name is Freddy..

5

Press Create Tool.

Now your Snippets are set up, you can use it to populate strings in your prompt templates across your projects.

6

Navigate to the Editor

Go to the Editor of your previously created project.

7

Add {{ assistant-personalities(key) }} to your prompt

Delete the existing prompt template and add {{ assistant-personalities(key) }} to your prompt.

Tool syntax: {{ (key) }}

Double curly bracket syntax is used to call a tool in the editor. Inside the curly brackets you put the tool name, e.g. {{ <tool-name>(key) }}.

8

Enter the key as an input

In the input area set the value to helpful-assistant. The tool requires an input value to be provided for the key. When adding the tool an inputs field will appear in the top right of the editor where you can specify your key.

9

Press the Run button

Start the chat with the LLM and you can see the response of the LLM, as well as, see the key you previously defined add in the Chat on the right.

10

Change the key to grumpy-assistant.

The snippet will only render (or update) in the preview after running the chat

If you want to see the corresponding snippet to the key you either need to first run the conversation to fetch the string and see it in the preview.

11

Play with the LLM

Ask the LLM, I'm a customer and need help solving this issue. Can you help?'. You should see a grumpy response from “Freddy” now.

If you have a specific key you would like to hardcode in the prompt, you can define it using the literal key value: {{ <your-tool-name>("key") }}, so in this case it would be {{ assistant-personalities("grumpy-assistant") }}. Delete the grumpy-assistant field and add it into your chat template.

12

Save your Prompt.

If you’re happy with you’re grumpy assistant, save this new version of your Prompt.

The Snippet tool is particularly useful because you can define passages of text once in a Snippet tool and reuse them across multiple prompts, without needing to copy/paste them and manually keep them all in sync. Editing the values in your tool allows the changes to automatically propagate to the model configs when you update them, as long as the key is the same.

Changing a snippet value can change a Prompt's behaviour

Since the values for a Snippet are saved on the Tool, not the Prompt, changing the values (or keys) defined in your Snippet tools could affect the relative propmt’s behaviour that won’t be captured by the Prompt’s version. This could be exactly what you intend, however caution should still be used make sure the changes are expected.