文档中心

AgentKit

技能

在 Agent 中集成技能示例

在 Agent 中集成技能示例

本文以 VeADK 为例，介绍如何在 Agent 代码中集成预置 Skill。使 Agent 在运行时可检索并执行目标技能，从而扩展其任务处理能力。

前提条件

已获取 AK/SK。若未获取，请登录平台控制台 API 访问密钥页面，创建并获取 Access Key ID 和 Secret Access Key，具体操作请参见获取AK/SK。

注意

请妥善保管个人 AK/SK 密钥信息。AK/SK 为平台接口调用的核心身份凭证，具备账号权限能力，请勿对外泄露、转发或公开披露，避免因密钥泄露导致账号数据安全及业务风险。

已在本地开发环境中安装 Python，且版本不低于3.10。如未安装，请前往 Python 官网下载并安装对应版本。

较低 Python 版本存在语法、标准库兼容性问题，无法支撑 Skill 运行所需依赖，建议优先部署 3.10 及以上稳定版本。

已创建技能空间并获取空间 ID，操作详情参见技能空间。

已创建技能 Sandbox 工具并获取工具 ID，操作详情参见创建工具。

操作步骤

配置环境变量。

# 平台的 AK 和 SK。
export VOLCENGINE_ACCESS_KEY=<your_access_key>
export VOLCENGINE_SECRET_KEY=<your_secret_key>
# AgentKit平台创建的技能 Sandbox的Tool ID。
export AGENTKIT_TOOL_ID=<agentkit_tool_id>
# 技能空间的ID。
export SKILL_SPACE_ID=<skill_space_id>

在本地开发环境中安装依赖包。

pip install 'veadk-python==1.1.5'

集成示例。

from veadk import Agent, Runner
from veadk.tools.builtin_tools.execute_skills import execute_skills

root_agent = Agent(
name="skill_agent",
instruction="Invoke the execute_skills tool to execute the技能based on the user's requirements.",
tools=[execute_skills],
)

runner = Runner(agent=root_agent)

# 如果使用确定的技能，推荐直接在Prompt里声明技能的名称
user_prompt = f"""
Please execute the following workflow:
1. Utilize the skill-creator skill to generate a streamlined PDF processing skill with PDF loading and editing capabilities.
2. Register the finalized skill to the skill space.
"""
session_id = "skill_session_123"
response = asyncio.run(
runner.run(messages=user_prompt, session_id=session_id)
)

print(response)

后续操作

在完成本地开发和测试后，您可以将集成工具后的 Agent 部署到智能体运行时。详细操作，请参见部署到云上生产环境。

最近更新时间：2026.10.09 17:20:33

这个页面对您有帮助吗？

有用

有用

无用

无用