OpenCode Agent Skill 入门指南：从零开始构建你的第一个智能代理

2次阅读

共计 1608 个字符，预计需要花费 5 分钟才能阅读完成。

OpenCode Agent Skill 是一种用于构建智能代理的技术框架，它允许开发者创建能够理解和响应复杂任务的智能系统。Agent Skill 可以理解为智能代理的 ” 技能 ”，就像人类的技能一样，它赋予代理执行特定任务的能力。

什么是 Agent Skill？ 它是一个封装了特定功能的模块，可以处理输入、执行逻辑并产生输出。例如，一个天气查询 Skill 可以接收位置信息，返回该地区的天气预报。
它能解决什么问题？ Agent Skill 主要解决特定领域的任务自动化问题，如客户服务、数据查询、流程自动化等。通过组合多个 Skill，可以构建出能够处理复杂场景的智能代理。

安装 Python：确保系统中安装了 Python 3.7 或更高版本
设置虚拟环境 ：推荐使用 venv 创建隔离的 Python 环境

安装必要依赖 ：

pip install opencode-agent-skill-sdk flask

验证安装 ：

import opencode_agent_skill
print(opencode_agent_skill.__version__)

下面我们创建一个简单的问候语生成 Skill：

from opencode_agent_skill import BaseSkill, register_skill

@register_skill("greeting")
class GreetingSkill(BaseSkill):
    """一个简单的问候语生成技能"""

    def __init__(self):
        super().__init__()

    def execute(self, context):
        """
        执行技能的主要逻辑

        参数:
            context (dict): 包含输入参数的上下文

        返回:
            dict: 包含输出结果的字典
        """name = context.get("name"," 朋友 ")
        time_of_day = context.get("time_of_day", "白天")

        greetings = {
            "morning": "早上好",
            "afternoon": "下午好",
            "evening": "晚上好",
            "night": "晚安"
        }

        greeting_word = greetings.get(time_of_day.lower(), "你好")

        return {
            "status": "success",
            "message": f"{greeting_word}, {name}!",
            "data": {"greeting_type": time_of_day}
        }