Prompt Management

Goals

Centralized Storage: Store all your prompts in a single, organized location.
Version Control: Keep track of changes to your prompts over time, allowing you to revert to previous versions if needed.
Collaboration: Enable team members to collaborate on prompt creation and optimization.
Deployment: Deploy prompt changes without needing to modify your codebase.
Programmatic Access: Access and manage your prompts programmatically through our API.

How it works

You can store, manage and access your prompts here.

Create a prompt

Modify an existing prompt

Tag prompt versions

Access the prompts programmatically (Typescript)

Make sure to replace the placeholders HAMMING_API_KEY and prompt slugs with your actual keys and prompt slugs.

Create a file named main.ts and add the following code:

main.ts

import { Hamming } from "@hamming/hamming-sdk";

const hamming = new Hamming({
  apiKey: env.HAMMING_API_KEY,
});

async function main() {
  //Gets all prompts
  const prompts = await hamming.prompts.list();
  console.log(prompts);

  //Gets the latest version of the prompt by slug (default label is production)
  const latestPrompt = await hamming.prompts.get("this-is-the-prompt-slug");
  console.log(latestPrompt);

  //Gets the production version of the prompt
  const productionPrompt = await hamming.prompts.get("this-is-the-prompt-slug", "production");
  console.log(productionPrompt);

  //Gets a particular version of the prompt
  const versionPrompt = await hamming.prompts.get("this-is-the-prompt-slug", undefined, "75c817a240b1");
  console.log(versionPrompt);
}

main();

Access the prompts programmatically (Python)

Make sure to replace the placeholders HAMMING_API_KEY and prompt slugs with your actual keys and prompt slugs.

Create a file named main.py and add the following code:

main.py

from dotenv import load_dotenv
from hamming import (
    ClientOptions,
    Hamming,
)

load_dotenv()
HAMMING_API_KEY = os.getenv("HAMMING_API_KEY")

hamming = Hamming(ClientOptions(api_key=HAMMING_API_KEY))
prompts = hamming.prompts

def main():
    # Get all prompts
    prompt_list = prompts.list()
    print(prompt_list)

    # Get a prompt by slug
    slug = "greeting-prompt-v2"
    prompt_by_slug = prompts.get(slug)
    print(prompt_by_slug)

    # Get a prompt by label
    label = "production"
    prompt_by_label = prompts.get(slug, label=label)
    print(prompt_by_label)


if __name__ == "__main__":
    main()

Run the prompts programmatically (Typescript)

This example demonstrates how to run prompts using the Hamming SDK. It includes:

Fetching a prompt by slug
Running the prompt locally, injecting variables and processing the result
Using a streaming API for chat completions

Make sure to replace the placeholders HAMMING_API_KEY, OPENAI_API_KEY, and prompt slugs with your actual keys and prompt slugs.

Create a file named main.ts and add the following code:

main.ts

import dotenv from "dotenv";
dotenv.config();

import { envsafe, str } from "envsafe";
import { Hamming } from "@hamming/hamming-sdk";

const env = envsafe({
  HAMMING_API_KEY: str(),
  OPENAI_API_KEY: str(),
});

const hamming = new Hamming({
  apiKey: env.HAMMING_API_KEY,
  openaiApiKey: env.OPENAI_API_KEY,
});

async function main() {
  // Run a prompt with variables
  const prompt1 = await hamming.prompts.get("get-weather");
  const result = await hamming.openai.createChatCompletion(prompt1, {
    location: "San Francisco",
  });

  console.log("Role:", result.choices[0].message.role);
  console.log("Content:", result.choices[0].message.content);
  console.log("Tool Calls:", result.choices[0].message.tool_calls);

  // Run a prompt using streaming API
  const prompt2 = await hamming.prompts.get("basic-prompt");
  const result2 = await hamming.openai.createChatCompletionStream(prompt2);

  let content = "";
  for await (const chunk of result2) {
    content += chunk.choices[0].delta.content;
  }

  console.log(content);
}

main().catch((e) => {
  console.error(e);
  process.exit(1);
});

Get Started

Voice Agent Testing

Call Monitoring

Other Guides

Prompt Management

Goals

How it works

Get Started

Voice Agent Testing

Call Monitoring

Other Guides

​Goals

​How it works

Goals

How it works