スキルプラグイン開発

概要

SERVICEMEにおいて、スキルプラグインとはAgentが選択可能な能力を指します。システム標準のプラグイン以外にも、開発によってスキルプラグインを拡張し、Agentにさらなる能力を付与することができます。

システム内蔵スキルプラグイン

番号	プラグイン	プラグインタイプ	用途
SearchKnowledgebase	ナレッジベース検索	APIプラグイン	プライベートナレッジの検索機能を提供
ImageGeneration	画像生成	APIプラグイン	テキスト説明に基づき画像を生成
Browsing	ウェブ閲覧	APIプラグイン	ウェブ閲覧によるリアルタイム情報の検索を提供
Charts	チャート	APIプラグイン	提供されたデータに基づき対応するチャートを生成。棒グラフ、折れ線グラフ、円グラフに対応
DocumentReader	ドキュメントリーダー	APIプラグイン	単一または選択したドキュメントの要約情報を提供
QuestionContact	質問連絡先	APIプラグイン	質問の分野に応じて、該当分野の連絡先を返す

タイプ説明

タイプ	説明
APIプラグイン	スキルプラグインはバックエンドAPIとして実装され、Agentがコンテキストに基づきAPIの入力パラメータを補完し、APIの返却値を解析します

APIスキルプラグイン

認証方式のサポート

現在は固定Header認証または認証不要のインターフェース呼び出しのみサポートしています。

タイプ	説明
固定Header	リクエストヘッダーで固定キーを指定してインターフェース認証を行う。OpenAIのapi_key形式に類似

プラグイン開発

このプロセスを理解しやすくするため、タイムゾーンコードでタイムゾーンを検索するAPIプラグインを例に説明します。

ステップ1：タイムゾーンコードに基づきタイムゾーン情報を返すAPIを用意します。

API例

.NET (Web API)

using Microsoft.AspNetCore.Mvc;
using System;

namespace WorldTimeApi.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class TimeController : ControllerBase
    {
        [HttpGet("current/zone")]
        public IActionResult GetTimeByZone([FromQuery] string timeZone)
        {
            if (string.IsNullOrEmpty(timeZone))
            {
                return BadRequest("Missing required parameter: timeZone");
            }

            try
            {
                // 查找时区信息
                var timeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById(timeZone);

                // 获取指定时区的当前时间
                var currentTime = TimeZoneInfo.ConvertTimeFromUtc(DateTime.UtcNow, timeZoneInfo);

                // 返回结果
                return Ok(new
                {
                    TimeZone = timeZone,
                    CurrentTime = currentTime.ToString("yyyy-MM-ddTHH:mm:ss")
                });
            }
            catch (TimeZoneNotFoundException)
            {
                return NotFound("Time zone not found");
            }
            catch (InvalidTimeZoneException)
            {
                return BadRequest("Invalid time zone");
            }
            catch (Exception ex)
            {
                return StatusCode(500, $"Internal server error: {ex.Message}");
            }
        }
    }
}

Java (Spring Boot)

package com.example.worldtime;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import java.time.Instant;
import java.time.ZoneId;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;

@RestController
public class TimeController {

    @GetMapping("/api/Time/current/zone")
    public Object getTimeByZone(@RequestParam String timeZone) {
        try {
            ZoneId zoneId = ZoneId.of(timeZone);
            ZonedDateTime currentTime = ZonedDateTime.ofInstant(Instant.now(), zoneId);
            return new TimeResponse(timeZone, currentTime.format(DateTimeFormatter.ISO_LOCAL_DATE_TIME));
        } catch (Exception e) {
            return "Invalid time zone: " + e.getMessage();
        }
    }

    static class TimeResponse {
        public String timeZone;
        public String currentTime;

        public TimeResponse(String timeZone, String currentTime) {
            this.timeZone = timeZone;
            this.currentTime = currentTime;
        }
    }
}

Python (Fast API)

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
from datetime import datetime
import pytz

app = FastAPI()

class TimeResponse(BaseModel):
    timeZone: str
    currentTime: str

@app.get("/api/Time/current/zone", response_model=TimeResponse)
async def get_time_by_zone(timeZone: str):
    if not timeZone:
        raise HTTPException(status_code=400, detail="Missing required parameter: timeZone")

    try:
        tz = pytz.timezone(timeZone)
        current_time = datetime.now(tz)
        return TimeResponse(
            timeZone=timeZone,
            currentTime=current_time.strftime('%Y-%m-%dT%H:%M:%S')
        )
    except pytz.UnknownTimeZoneError:
        raise HTTPException(status_code=404, detail="Time zone not found")
    except Exception as e:
        raise HTTPException(status_code=500, detail=f"Internal server error: {str(e)}")

Javascript (Next.js)

import moment from 'moment-timezone';

export default function handler(req, res) {
  const { timeZone } = req.query;

  if (!timeZone) {
    return res.status(400).json({ error: 'Missing required parameter: timeZone' });
  }

  try {
    const currentTime = moment().tz(timeZone).format('YYYY-MM-DDTHH:mm:ss');
    res.status(200).json({
      timeZone: timeZone,
      currentTime: currentTime,
    });
  } catch (e) {
    res.status(404).json({ error: 'Time zone not found' });
  }
}

ステップ2：このプラグインをシステムに登録します

スキルプラグインを追加し、以下の情報を入力します

フィールド説明

• Code：プラグインのコード。システム内での一意識別子。意味のある記述を推奨します。
• Name：プラグインの表示名。Agentが思考・実行時に使用するプラグイン名。多言語対応に注意してください。
• Description：プラグインの説明。プラグインの役割を説明し、Agentのスキルプラグイン追加画面で表示されます。
• Request Header：プラグイン呼び出しに必要なHeaderパラメータ（例：API_KEY）を入力します。
• 【重要】OpenAPI / Swagger Schema ( JSON )：API本体の記述。ここでの情報が、Agentがこのスキルをどのような状況で呼び出すべきか、各パラメータをどのように補完すべきかの理解に直結します。

OpenAPI Schema (JSON) サンプル

Get time zone

{
  "Openapi": "3.0.0",
  "Info": {
    "Title": "World Time",
    "Description": "Getting world time",
    "Version": "v1.0.0"
  },
  "Servers": [
    {
      "Url": "https://www.timeapi.io"
    }
  ],
  "Paths": {
    "/api/Time/current/zone": {
      "Get": {
        "OperationId": "zone",
        "Description": "Get world time by timezone name",
        "Deprecated": false,
        "Parameters": [
          {
            "Name": "timeZone",
            "In": "query",
            "Required": true,
            "Description": "Full IANA time zone names.",
            "Schema": {
              "Type": "string"
            }
          }
        ]
      }
    }
  }
}

注意

• Info/Title：ここで記載するプラグインタイトルは、Agentがこのプラグインの役割を理解する助けになります。
• Paths/[api path]/Get/OperationId：Agent Prompt内でバッククォート`%OperationId%`を使い、特定シナリオで呼び出すAPIを明示できます。詳細は下記ステップ4の例を参照してください。
• Paths/[api path]/Get/Description：Agentの理解を助け、どのような状況で特定APIを呼び出すかに影響します。
• Paths/[api path]/Get/Parameters：実際のAPIと一致していることを確認してください。ここがqueryの場合、APIもqueryからパラメータを取得する必要があります。他のタイプ（例：json body）の場合も同様です。パラメータ名の説明は補完成功率向上に役立ちます。
• Servers/Url：APIのBaseURL。正しく記載しないと呼び出しに失敗します。
• 【オプション】プラグイン設定完了後、DEBUG機能でデバッグが可能です。

ステップ3：Agentにスキルプラグインを追加します

Agent設定画面の[スキルプラグイン]タブからプラグインを追加します。

設定を保存後、エキスパートとの対話でテストします。

ステップ4：【オプション】AgentのPromptに必要な説明を追加し、Agentがこのスキルをより適切に実行できるようにします。

例

特定サイトでブラウザプラグインによる検索を誘導

### Skill 3: Web Searching
- You can access web site by `Browsering` toolkit and looking for HR infomation from following sites: (site:*.linkedin.com; site:*.zhipin.com)
- Using result to fulfill users request and list up reference link at end of your response.

注：多くの場合、AgentはOpenAPI Schemaの情報に基づき自動的に実行タイミングやパラメータ補完を判断します。