SuperAPI AI 工具集

linkai-agent

智能体与模型

查看项目

更新于 10-16 01:59

技能介绍

LinkAI Agent 用于调用 LinkAI 应用与工作流,其调用方式是通过 chat completions API 发起请求。可用应用从 config.json 中加载,技能描述在加载时会根据该配置自动生成。

用途 该技能面向需要以命令行方式调用 LinkAI 应用或工作流的场景,通过 bash 工具配合 curl 访问 chat completions API 完成调用。

主要能力

  • 调用 LinkAI 应用与工作流。
  • 可用应用从 config.json 加载,技能描述在加载时根据该配置自动生成。
  • 通过 chat completions API 返回结果,成功响应可从 choices[0].message.content 提取内容,并包含 usage 中的 prompt_tokens、completion_tokens、total_tokens 统计。
  • 出错时返回 error 对象,包含 message 与 code。

使用方式

  1. 准备 API key:该技能需要 LinkAI API key,可从 LinkAI Console 获取。
  2. 设置环境变量:export LINKAI_API_KEY=Link_xxxxxxxxxxxx,或使用 env_config 工具。
  3. 配置:将 config.json.template 复制为 config.json,并在 config.json 中添加应用或工作流。
  4. 调用:使用 bash 工具配合 curl 调用 API,建议优先使用 curl 以避免 Windows PowerShell 上的编码问题。示例命令:

curl -X POST "https://api.link-ai.tech/v1/chat/completions"
-H "Content-Type: application/json"
-H "Authorization: Bearer $LINKAI_API_KEY"
-d '{ "app_code": "<app_code>", "messages": [{"role": "user", "content": "<question>"}], "stream": false }'

可选参数:对视频、图像生成等长时间任务,可在 curl 中添加 --max-time 120。在 Windows cmd 中,使用 %LINKAI_API_KEY% 代替 $LINKAI_API_KEY。

通过 bash 工具调用的示例:

bash(command='curl -sS --max-time 120 -X POST "https://api.link-ai.tech/v1/chat/completions" -H "Content-Type: application/json" -H "Authorization: Bearer $LINKAI_API_KEY" -d "{"app_code":"G7z6vKwp","messages":[{"role":"user","content":"What is AI?"}],"stream":false}"', timeout=130)

响应格式 成功响应示例(从 JSON 中提取 choices[0].message.content):

{ "choices": [{ "message": { "role": "assistant", "content": "AI stands for Artificial Intelligence..." } }], "usage": { "prompt_tokens": 10, "completion_tokens": 50, "total_tokens": 60 } }

错误响应示例:

{ "error": { "message": "Error description", "code": "error_code" } }

适用场景 适用于需要通过命令行调用 LinkAI 应用与工作流的任务,包括可能耗时较长的视频、图像生成类任务(可通过 --max-time 120 延长超时)。

限制

  • 必须提供 LinkAI API key,否则无法调用。
  • 可用应用取决于 config.json 中的配置。
  • 在 Windows PowerShell 上可能存在编码问题,建议使用 curl;在 Windows cmd 中需使用 %LINKAI_API_KEY% 变量写法。
  • 关于收费、价格、平台支持范围等信息,资料暂未提供。