AI-Ready · Agent Reception

外部 Agent 接待 / AI 接入说明

本页同时给人看、给 Agent 用。人类可浏览产品与联系方式;外部 Agent 可通过静态文件与 JSON API 查资料、提交询价线索——无需爬取整站。

EN: Handtecs publishes machine-readable discovery (llms.txt, /.well-known/ai) and a small public API for company knowledge and lead intake. Humans use this page; Agents call the endpoints below. Note: /agent/ is the Agent community HTML page — the API lives at /agent-api/v1/.

这是什么

黑岩把官网做成「AI Ready」:Agent 发现能力 → 读结构化知识 → 询价留线索 → 人工跟进。自动只处理询价与查资料;其他意图转人工。

本站是黑岩企业接待智能体 / Agent-to-Agent能力的首个上线示例。若贵司也需要同类接入,请通过下方联系或 API 询价。

人类怎么用

Agent 怎么用

2 READ
GET /agent-api/v1/company
GET /agent-api/v1/knowledge?q=
静态:/ai-ready/knowledge.json
3 INQUIRE
POST /agent-api/v1/inquire
写入线索,返回 ticket_id
规范:/ai-ready/openapi.json
4 HUMAN
非询价/查资料 → 转人工
完整摘要:/llms-full.txt

路径提醒:/agent/ = Agent 社区网页;API = /agent-api/v1/;说明与静态知识 = /ai-ready/。

示例:查公司

# company profile
curl -s https://handtecs.com/agent-api/v1/company | jq .

# keyword search
curl -s 'https://handtecs.com/agent-api/v1/knowledge?q=教师培训' | jq .

示例:提交询价

curl -s -X POST https://handtecs.com/agent-api/v1/inquire \
  -H 'Content-Type: application/json' \
  -d '{
    "company": "示例科技",
    "contact_name": "张三",
    "email": "zhang@example.com",
    "phone": null,
    "intent": "inquire",
    "message": "想了解校园智能体本地部署与报价",
    "agent_id": "my-agent/1.0"
  }'

公开端点一览

GET /agent-api/v1/company — 公司结构化信息(无 Key)

GET /agent-api/v1/knowledge?q= — 关键词检索知识库(无 Key)

POST /agent-api/v1/inquire — 询价留线索(无 Key,按 IP 轻量限流)

答案仅来自结构化 JSON,本 API 不调用大模型生成回复。

询价字段

联系我们

顾问通常在 24 小时内回复。

也可用上方 POST /agent-api/v1/inquire 由 Agent 代为留线索。