Skip to main content

Installation

Install the Prompt Foundry SDK NPM version
npm install @prompt-foundry/typescript-sdk 

Integration

The full API of this library can be found in the API Reference page by selecting JavaScript in the interactive examples.

Option 1 - Completion Proxy

This option requires you to add a provider API key in your organization settings.
Initiates a completion request to the configured LLM provider using specified parameters and provided variables. This endpoint abstracts the integration with different model providers, enabling seamless switching between models while maintaining a consistent data model for your application.
import PromptFoundry from "@prompt-foundry/typescript-sdk";  // Initialize Prompt Foundry SDK with your API key const promptFoundry = new PromptFoundry({  apiKey: process.env["PROMPT_FOUNDRY_API_KEY"], });  async function main() {  // Retrieve model parameters for the prompt  const completionCreateResponse = await client.completion.create(  "637ae1aa8f4aa6fad144ccbd",  {  // Optionally append additional messages to the converstation thread on top of your configured prompt messages  appendMessages: [  {  role: "user",  content: [  {  type: "TEXT",  text: "What is the weather in Seattle, WA?",  },  ],  },  ],  // Supports prompt template variables  variables: {},  }  );  // completion response  console.log(completionCreateResponse.message); }  main().catch(console.error); 

Option 2 - Direct Provider Integration

Fetches the configured model parameters and messages rendered with the provided variables mapped to the set LLM provider. This endpoint abstracts the need to handle mapping between different providers, while still allowing direct calls to the providers.

OpenAI Integration

Install the OpenAI SDK
npm install openai 
Import the OpenAI and Prompt Foundry SDKs
import PromptFoundry from "@prompt-foundry/typescript-sdk"; import { Configuration, OpenAIApi } from "openai";  // Initialize Prompt Foundry SDK with your API key const promptFoundry = new PromptFoundry({  apiKey: process.env["PROMPT_FOUNDRY_API_KEY"], });  // Initialize OpenAI SDK with your API key const configuration = new Configuration({  apiKey: process.env["OPENAI_API_KEY"], }); const openai = new OpenAIApi(configuration);  async function main() {  // Retrieve model parameters for the prompt  const modelParameters = await promptFoundry.prompts.getParameters("1212121", {  appendMessages: [  {  role: "user",  content: [  {  type: "TEXT",  text: "What is the weather in Seattle, WA?",  },  ],  },  ],  variables: { hello: "world" },  });   // check if provider is Open AI  if (modelParameters.provider === "openai") {  // Use the retrieved parameters to create a chat completion request  const modelResponse = await openai.chat.completions.create(  modelParameters.parameters  );   // Print the response from OpenAI  console.log(modelResponse.data);  } }  main().catch(console.error); 

Anthropic Integration

Install the Anthropic SDK
npm install @anthropic-ai/sdk 
Import the Anthropic and Prompt Foundry SDKs
import PromptFoundry from "@prompt-foundry/typescript-sdk"; import Anthropic from "@anthropic-ai/sdk";  // Initialize Prompt Foundry SDK with your API key const promptFoundry = new PromptFoundry({  apiKey: process.env["PROMPT_FOUNDRY_API_KEY"], });  // Initialize Anthropic SDK with your API key const anthropic = new Anthropic({  apiKey: process.env["ANTHROPIC_API_KEY"], });  async function main() {  // Retrieve model parameters for the prompt  const modelParameters = await promptFoundry.prompts.getParameters("1212121", {  appendMessages: [  {  role: "user",  content: [  {  type: "TEXT",  text: "What is the weather in Seattle, WA?",  },  ],  },  ],  variables: { hello: "world" },  });   // check if provider is Anthropic  if (modelParameters.provider === "anthropic") {  // Use the retrieved parameters to create a chat completion request  const message = await anthropic.messages.create(modelParameters.parameters);   // Print the response from Anthropic  console.log(message.content);  } }  main().catch(console.error); 

Additional Information

For more details, visit the GitHub Repo.
⌘I