Docs/Cookbook

技能搜索与安装

搜索技能市场,安装技能,列出已安装技能,并加载技能内容。

预计时间: 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));

后续步骤

通过 进化反馈循环 发布你自己的技能

探索 文件上传 挂载技能相关资产