银河类型SDK
银河 是一个永久的沙盒平台,它通过将无限安全的沙盒保留在自动备用状态来实现近瞬间潜伏状态,同时联合托管你的代理逻辑来切断网络上架.
这个软件包包含了为Blaxel的TypeScript SDK提供的帮助器功能,可以让你以LangChain/LangGraph所要求的格式检索模型客户端和MCP工具定义.
示例
import { blTools, blModel } from "@blaxel/langgraph";
const stream = await createReactAgent({
llm: await blModel("sandbox-openai"),
prompt: prompt,
tools: [
...(await blTools(["blaxel-search", "webcrawl"])),
tool(
async (input: any) => {
console.debug("TOOLCALLING: local weather", input);
return `The weather in ${input.city} is sunny`;
},
{
name: "weather",
description: "Get the weather in a specific city",
schema: z.object({
city: z.string(),
}),
}
),
],
}).stream({
messages: [new HumanMessage(process.argv[2])],
});
安装
# npm
npm install @blaxel/langgraph
# yarn
yarn add @blaxel/langgraph
# bun
bun add @blaxel/langgraph
认证
SDK使用这些源( 按优先级排序) 以您的 Blaxel 工作空间认证 :
- Blaxel CLI,登录时
- 环境变量
.env文件( 编号BL_WORKSPACE, (中文(简体) ),BL_API_KEY(中文(简体) ) - 系统环境变量
- Blaxel 配置文件 (
~/.blaxel/config.yaml(中文(简体) )
当本地开发时, 推荐的方法只是登录您的工作空间 :
bl login YOUR-WORKSPACE
这使得您可以运行Blaxel SDK功能,这些功能将自动连接到您的工作空间而无需额外的设置. 当你在Blaxel上部署时,这种连接会自动地持续.
当运行Blaxel SDK时,我们建议使用上文第三个选项中描述的环境变量.
使用量
模型使用
Blaxel作为模型API的统一网关,集中访问证书,追踪和遥测. 您可以与任何模型 API 提供者进行集成,或者部署自己的自定义模型. 当在Blaxel上部署一个模型时,也会创建一个全球API端点来称呼它.
这个软件包包含一个帮助器功能,它创建了对布赖斯尔上部署的模型的参考,并返回一个框架特定的模型客户端,通过布赖斯尔的统一网关来引导API调用.
// With LangChain
import { blModel } from "@blaxel/langgraph";
const model = await blModel("gpt-5-mini");
MCP 工具的使用
Blaxel允许您部署并托管模型背景协议(MCP)服务器,可以在全局端点上访问可流的HTTP.
此软件包包含一个帮助器功能,以特定框架所需要格式从由Blaxel托管的MCP服务器中检索并返回工具定义.
以下是一个以朗格拉夫要求的格式从Blaxel sandbox的MCP服务器中检索工具定义的例子:
import { SandboxInstance } from "@blaxel/core";
import { blTools } from "@blaxel/langgraph";
// Create a new sandbox (base-image is Alpine + Node.js 22 + git; no Python — use "blaxel/py-app:latest" for Python)
const sandbox = await SandboxInstance.createIfNotExists({
name: "my-sandbox",
image: "blaxel/base-image:latest",
memory: 4096,
region: "us-pdx-1",
ttl: "24h"
});
// Get sandbox tools
const tools = await blTools(['sandbox/my-sandbox'])
遥测
当工作量运行在Blaxel上时,仪器自动发生.
通过导入 : @blaxel/telemetry 软件包 :
import "@blaxel/telemetry";
所需资源
- 节点.js v18 或以后
文档
捐款
欢迎捐款! 请随意 提交拉动请求。 。 。 .
许可证
这个项目根据麻省理工学院的许可证获得许可。 见 自由主义 详细文件.