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。
使用方式
- 准备 API key:该技能需要 LinkAI API key,可从 LinkAI Console 获取。
- 设置环境变量:export LINKAI_API_KEY=Link_xxxxxxxxxxxx,或使用 env_config 工具。
- 配置:将 config.json.template 复制为 config.json,并在 config.json 中添加应用或工作流。
- 调用:使用 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% 变量写法。
- 关于收费、价格、平台支持范围等信息,资料暂未提供。