在agentkit中接入外部api必须通过mcp服务封装，再作为工具集成到智能体；直接写requests会绕过鉴权、观测与限流，导致不可审计、无法熔断、频繁超时。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在AgentKit中接入外部API的核心路径
要在火山引擎AgentKit中让智能体调用外部HTTP API（如天气服务、支付网关、CRM接口），必须通过MCP服务封装该API，再将MCP服务作为工具集成进智能体——直接在agent代码里写requests请求会绕过平台鉴权、观测与限流机制，【导致调用不可审计、无法熔断、上线后频繁超时】。
创建MCP服务封装外部API
登录AgentKit控制台 → 进入「网关」→ 点击「MCP服务」→ 「创建MCP服务」。
选择「API一键转换」模式，填入目标API的完整URL（例如 https://api.example.com/v1/weather?city={city}），系统自动解析请求方法、参数位置与响应结构。
若API需Header认证（如 Authorization: Bearer xxx），必须在「更新入站身份认证」中勾选「Bearer Token」并填写Token字段名；若用API Key，则选「API Key」并指定Key所在Header名与值前缀（如 X-API-Key: abc123）。
这一步不能跳过：点击「调试MCP服务」，输入样例参数触发真实请求，确认返回状态码为200且JSON结构可被正确解析。若返回401或空响应，说明认证配置错误或网络策略未放行出向流量。
将MCP服务注册为工具并绑定到智能体
方法一：通过AgentKit CLI声明式绑定
在本地agent项目根目录的 agentkit.yaml 文件中，于 tools 节点下添加：
```yaml
tools:
- type: mcp
id: weather_tool
config:
service_id: mcp-svc-abc123 # 在上一步创建MCP服务后获得的ID
```
方法二：在控制台运行时页面手动集成
进入「智能体运行时」→ 选择目标运行时 → 「配置」→ 「工具」→ 「添加工具」→ 类型选「MCP工具」→ 从下拉列表选择已创建的MCP服务 → 点击「确认添加」。
【注意：添加后必须点击右上角「发布运行时」才能生效，仅保存配置不触发更新】
在VeADK智能体代码中调用该工具
第一步：在agent主文件（如 app.py）顶部导入工具调用装饰器
from veadk.tools import use_tool
第二步：定义工具调用函数，参数名必须与MCP服务定义的路径参数/Query参数完全一致
@use_tool(name="weather_tool")
async def get_weather(city: str) -> str:
pass
第三步：在entrypoint函数中像普通异步函数一样调用
@app.entrypoint
async def run(payload: dict, headers: dict) -> str:
city = payload.get("prompt", "").replace("查天气", "").strip()
if city:
result = await get_weather(city)
return f"{city}当前天气：{result}"
return "请提供城市名称"
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
