Langbase

Create Memory langbase.memories.create()

Create a new AI memory on Langbase using the langbase.memories.create() function.

Generate a User/Org API key

You will need to generate an API key to authenticate your requests. For more information, visit the User/Org API key documentation.

API reference

langbase.memories.create(options)

Function Signature

langbase.memories.create(options);

// with types.
langbase.memories.create(options: MemoryCreateOptions);

options

  • Name
    options
    Type
    MemoryCreateOptions
    Description

    MemoryCreateOptions Object

    interface MemoryCreateOptions {
	name: string;
	description?: string;
	embedding_model?:
		| 'openai:text-embedding-3-large'
		| 'cohere:embed-multilingual-v3.0'
		| 'cohere:embed-multilingual-light-v3.0'
		| 'google:text-embedding-004';
}

    Following are the properties of the options object.

  • Name
    name
    Type
    string
    Required
    Required
    Description

    Name of the memory.

  • Name
    description
    Type
    string
    Description

    Description of the memory.

  • Name
    embedding_model
    Type
    string
    Description

    The model to use for text embeddings. Available options:

    • openai:text-embedding-3-large
    • cohere:embed-multilingual-v3.0
    • cohere:embed-multilingual-light-v3.0
    • google:text-embedding-004

    Default: openai:text-embedding-3-large

Usage example

Install the SDK

npm i langbase

Environment variables

.env file

LANGBASE_API_KEY="<USER/ORG-API-KEY>"

Create memory

Create memory on Langbase

import {Langbase} from 'langbase';

const langbase = new Langbase({
	apiKey: process.env.LANGBASE_API_KEY!,
});

async function main() {
	const memory = await langbase.memories.create({
		name: 'knowledge-base',
		description: 'An AI memory for storing company internal docs.',
	});

	console.log('Memory created:', memory);
}

main();

Response

  • Name
    MemoryCreateResponse
    Type
    object
    Description

    The response object returned by the langbase.memories.create() function.

    MemoryCreateResponse

    interface MemoryCreateResponse {
	name: string;
	description: string;
	owner_login: string;
	url: string;
	embedding_model:
		| 'openai:text-embedding-3-large'
		| 'cohere:embed-multilingual-v3.0'
		| 'cohere:embed-multilingual-light-v3.0';
}
    • Name
      name
      Type
      string
      Description

      Name of the memory.

    • Name
      description
      Type
      string
      Description

      Description of the AI memory.

    • Name
      owner_login
      Type
      string
      Description

      Login of the memory owner.

    • Name
      url
      Type
      string
      Description

      Memory access URL.

    • Name
      embedding_model
      Type
      string
      Description

      The embedding model used by the AI memory.

      • openai:text-embedding-3-large
      • cohere:embed-multilingual-v3.0
      • cohere:embed-multilingual-light-v3.0

Response of langbase.memories.create()

{
	"name": "knowledge-base",
	"description": "An AI memory for storing company internal docs.",
	"owner_login": "user123",
	"url": "https://langbase.com/user123/document-memory",
	"embedding_model": "openai:text-embedding-3-large"
}