hiagent智能体对话

一个基于 hiagent 的智能助手技能，用于与 hiagent 进行对话。

Security Scan

The skill's requested binaries and environment variables match its stated purpose (calling a hiagent HTTP API) and the instructions stay within that scope; the main user consideration is that it will send whatever the user provides to the HIAGENT_API_URL you configure.

Purpose & Capability

Name/description state this is a hiagent chat integration and the skill only requires curl plus HIAGENT_API_URL, HIAGENT_API_KEY, and HIAGENT_USER_ID — all of which are directly relevant and expected for talking to an HTTP-based hiagent service.

Instruction Scope

SKILL.md contains only curl examples to call hiagent endpoints (create_conversation, chat_query_v2, conversation list/messages). This stays within the described purpose. Note: runtime behavior will send user messages and any context the agent includes to whatever URL is set in HIAGENT_API_URL, so the trustworthiness and security (TLS, server operator) of that endpoint matters.

Install Mechanism

No install spec and no code files — instruction-only skill that expects curl to be present. This is the lowest-risk install pattern.

Credentials

Required env vars (API URL, API key, user id) are proportional and expected for an HTTP API client. No unrelated secrets or config paths are requested. The only caveat is that the API URL can point to any host, so the provided API key and any user data will be sent to that host.

Persistence & Privilege

Skill is not always:true and does not request system-level persistence or modify other skills. It can be invoked by the agent (normal behavior) but has no elevated privileges.

Assessment

This skill is coherent for calling a hiagent HTTP API, but before installing: (1) only set HIAGENT_API_URL to a host you trust — all user messages will be sent there; (2) store HIAGENT_API_KEY securely and avoid reusing sensitive credentials; (3) avoid sending secrets or highly sensitive data through the skill unless you control or trust the hiagent service; (4) prefer HTTPS endpoints and consider network controls / auditing for traffic to the configured URL.

hiagent-bot

技能描述

此技能旨在通过 hiagent-bot-chat 与 hiagent 进行对话，回答用户的问题。

使用场景

• 当用户指定使用hiagent-bot-chat 解决问题或进行对话时。

详细指令

hiagent-bot 主要通过调用 hiagent 的两个核心接口来实现：

1. create_conversion 接口：负责创建会话，通常用于在对话开始前初始化并获取会话的上下文 ID (Session ID)。
2. chat_query_v2 接口：负责具体的对话交互，用于在已创建的会话中发送用户的输入并获取 hiagent 的回复。

调用流程示例：

• 第一步：客户端请求 create_conversion 创建一个新的会话。
• 第二步：获取到会话标识后，用户每次发送消息时，客户端调用 chat_query_v2 接口并携带该会话标识进行对话。

hiagent 接口调用示例 (curl)

get conversation history list

use get_conversation_list api to get conversation history list

curl --location '$HIAGENT_API_URL/get_conversation_list'
--header 'Apikey: $HIAGENT_API_KEY'
--header 'Content-Type: application/json'
--data '{
    "UserID": "$HIAGENT_USER_ID"
}'

create conversation

if you want to create a new conversation, you can use the create_conversation api

curl --location '$HIAGENT_API_URL/create_conversation'
--header 'Apikey: $HIAGENT_API_KEY'
--header 'Content-Type: application/json'
--data '{
    "UserID": "$HIAGENT_USER_ID"
}'

get one conversation chat history

use the AppConversationID returned from get_conversation_list or create_conversation

curl --location '$HIAGENT_API_URL/get_conversation_messages'
--header 'Apikey: $HIAGENT_API_KEY'
--header 'Content-Type: application/json'
--data '{
    "AppConversationID": "$AppConversationID",
    "UserID": "$HIAGENT_USER_ID"
}'

send query

use the AppConversationID returned from get_conversation_list or create_conversation

curl --location '$HIAGENT_API_URL/chat_query_v2'
--header 'Apikey: $HIAGENT_API_KEY'
--header 'Content-Type: application/json'
--data '{
    "ResponseMode": "blocking",
    "AppConversationID": "$AppConversationID",
    "UserID": "$HIAGENT_USER_ID",
    "Query": "your query"
}'