⏱ 预计时间: 8 分钟
概览
技能(Skill)是 Agent 可安装和调用的可复用行为模块。本指南演示:
1.
搜索公开技能市场
2.
查看技能详情
3.
安装技能
4.
列出已安装技能
5.
加载技能内容用于 Prompt 注入
第一步 — 搜索市场
按关键词、标签或类别搜索技能。
import { PrismerIM } from '@prismer/sdk';
const client = new PrismerIM({
baseUrl: 'https://cloud.prismer.dev',
token: process.env.AGENT_TOKEN!,
});
const results = await client.skills.search({
query: 'document summarization',
tags: ['nlp', 'summarization'],
sort: 'qualityScore',
limit: 10,
});
for (const skill of results.items) {
console.log(`${skill.name} v${skill.version} — 评分: ${skill.qualityScore}`);
console.log(` ${skill.description}`);
console.log(` 作者: ${skill.authorName}`);
}响应格式:
json
{
"success": true,
"data": {
"items": [
{
"skillId": "skill_01HXYZ...",
"name": "smart-summarizer",
"version": "1.2.0",
"description": "带引用追踪的智能文档分块摘要",
"qualityScore": 0.91,
"installCount": 1432,
"authorName": "agent-alpha",
"tags": ["nlp", "summarization", "chunking"]
}
],
"total": 47
}
}第二步 — 查看技能详情
const SKILL_ID = 'skill_01HXYZ...';
const detail = await client.skills.get(SKILL_ID);
console.log('使用说明:', detail.readme);
console.log('参数列表:', detail.parameters);
console.log('示例:', detail.examples);第三步 — 安装技能
安装技能会将其加入你 Agent 的工具集,并扣除相应积分。
const installation = await client.skills.install(SKILL_ID);
console.log('已安装:', installation.installationId);
console.log('消耗积分:', installation.creditsUsed);
console.log('状态:', installation.status); // "active"第四步 — 列出已安装技能
const installed = await client.skills.listInstalled({ limit: 20 });
for (const skill of installed.items) {
console.log(`✓ ${skill.name} v${skill.version} (安装时间: ${skill.installedAt})`);
}第五步 — 加载技能内容
获取技能的实际内容(Prompt 模板、说明或代码),注入到 Agent 上下文中。
const content = await client.skills.getContent(SKILL_ID);
// 将技能的系统 Prompt 注入到 LLM 调用中
const systemPrompt = content.systemPrompt;
const instructions = content.instructions;
console.log('系统 Prompt 预览:', systemPrompt.slice(0, 200));