飞桥数智云/文档
文档/

本指南会带你完成首次模型 API 请求，并介绍如何为智能体添加托管技能。开始前，请在飞桥数智云控制台创建项目。

1. 获取 API 密钥

登录飞桥数智云控制台，创建项目并生成 API 密钥。请将密钥保存在安全位置，不要提交到代码仓库。

export FEIQIAO_API_KEY="<你的 API 密钥>"

2. 发出首次请求

飞桥数智云提供 OpenAI 兼容接口。将客户端的 API 基地址设为 https://api.feiqiao.ai/v1，然后发出请求：

curl https://api.feiqiao.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FEIQIAO_API_KEY" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [
      { "role": "user", "content": "请用一句话介绍人工智能智能体。" }
    ]
  }'

请按控制台和模型目录中显示的模型 ID 选择模型。不同模型支持的接口和参数可能不同，调用前请查看对应模型的说明。

3. 接入开发工具

许多兼容 OpenAI API 的开发工具只需配置 API 基地址和密钥即可接入。也可以直接阅读这些配置教程：

4. 为智能体添加技能

托管技能可以为智能体提供查询、计算或调用内部系统的能力。你可以使用 Yomo Framework 创建 Node.js 技能：

curl -fsSL https://get.yomo.run | sh
yomo init -l node ./llm-tool

技能项目会导出工具描述、参数类型和处理函数。模型根据用户请求选择是否调用工具，技能返回结果后，模型再生成最终答复。项目中配置的技能由服务端管理，客户端通常无需在请求中重复提交工具列表。请求格式请参阅智能体 API。

体验托管技能

在控制台项目中生成 API 密钥、APP_KEY 和 APP_SECRET。API 密钥用于模型 API 请求；应用密钥用于技能本地连接和部署。请分开保存并仅授予所需权限。

下例先询问智能体两个网站的网络性能。没有网络测量技能时，模型无法主动探测实时延迟：

curl https://api.feiqiao.ai/v1/chat/completions \
  -H "Authorization: Bearer $FEIQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "role": "user", "content": "比较 amazon.com 和 shopify.com 的网络性能" }
    ]
  }'

创建网络探测技能

初始化 Node.js 项目并安装 ping 依赖。下面的技能先解析域名，再对首个 IP 地址执行 ping：

import { promises as dns } from 'node:dns'
import ping from 'ping'

async function measure(domain: string) {
  const ips = await dns.resolve4(domain)
  const result = await ping.promise.probe(ips[0], { timeout: 3, min_reply: 3 })
  return `域名 ${domain} 的 IP 为 ${ips[0]}，平均延迟为 ${result.avg}ms，丢包率为 ${result.packetLoss}%`
}

export const description = '用户询问网站 IP 或网络延迟时，测量指定域名并返回 IP、平均延迟和丢包率。'

export type Argument = {
  domain: string
}

export async function handler(args: Argument) {
  return await measure(args.domain)
}

先在本地运行技能进行调试：

viv run \
  --name ai_skill_get_ip_latency \
  --zipper zipper.feiqiao.ai:9000 \
  --credential <APP_KEY>

本地验证通过后，在项目目录按飞桥 CLI 的部署要求填写技能名与 APP_SECRET，再运行：

viv deploy .

部署后可在控制台查看技能实例状态和日志。再次发送网络性能问题时，智能体即可通过技能获取测量结果。CLI 安装与部署命令请以控制台当前说明为准。

请求地址与安全

  • 模型 API 基地址：https://api.feiqiao.ai/v1
  • 身份认证：Authorization: Bearer <API 密钥>
  • 生产环境中应从密钥管理服务读取凭据，并为不同环境使用独立密钥。
  • 不要将密钥写入浏览器端代码、日志或公开示例。