Letta Code SDK

将 Letta Code 作为库使用，构建有状态代理

Letta Code SDK 提供了 Letta Code 的编程接口。它是记忆优先的（代理持久存在并随时间改进）、模型无关的（使用 Claude、GPT、Gemini 或本地模型），并且是开源的。

安装

npm install @letta-ai/letta-code-sdk

快速开始

一次性提示

对于简单查询，使用 prompt()：

import { prompt } from "@letta-ai/letta-code-sdk";

const result = await prompt("What is 2 + 2?");
console.log(result.result); // "4"

持久代理

创建一个跨会话保持记忆的代理：

import { createAgent, resumeSession } from "@letta-ai/letta-code-sdk";

// 创建一个新代理
const agentId = await createAgent({
  persona: "You are a Python expert specialized in data science.",
});

// 恢复会话
const session = resumeSession(agentId);

// 发送消息
const response = await session.send("Help me analyze this dataset");
console.log(response.content);

关键概念

• 代理 (Agent)：一个具有记忆的持久实体。代理跨会话存在，并随时间学习和改进。
• 对话 (Conversation)：代理内的消息线程。一个代理可以有多个对话，所有对话共享相同的记忆。
• 会话 (Session)：单次执行或连接。会话代表与代理的一次交互。

示例应用

API 参考

prompt()

发送一次性提示并获取响应。

import { prompt } from "@letta-ai/letta-code-sdk";

const result = await prompt("Your query here", {
  model: "claude-sonnet-4.5",  // 可选
  systemPrompt: "...",         // 可选
});

createAgent()

创建一个具有指定配置的新代理。

import { createAgent } from "@letta-ai/letta-code-sdk";

const agentId = await createAgent({
  persona: "You are a helpful assistant...",
  human: "User preferences...",
  model: "claude-sonnet-4.5",
  tools: ["web_search", "run_code"],
});

resumeSession()

恢复与代理的会话。

import { resumeSession } from "@letta-ai/letta-code-sdk";

// 通过代理 ID 恢复
const session = resumeSession(agentId);

// 发送消息
const response = await session.send("Your message");

资源

• GitHub 仓库 - 源代码和问题跟踪
• npm 包 - 包详情

下一步