使用文档
为自己的产品接入 AI
在服务端接入模型服务商,并将调用能力注入自己的业务功能。
模板在 foundation/aix 提供无状态模型适配器,在后端 internal/ai 提供配置工厂。输入明确的消息,返回文本结果;默认不提供用户聊天页面、聊天接口、对话数据库或每日用量规则。
配置支持 Chat Completions 协议的服务商后,在产品组装代码中使用注入的 HTTP 客户端创建适配器。仅填写配置不会自动开放 AI 接口。密钥保留在服务端,每次模型调用都传递请求上下文。
提示词、用户权限、对话历史、任务流程与收费规则属于具体产品。如果功能按积分收费,可以复用积分账本,在业务服务中决定何时预占、扣费或退款。具体业务的界面与流程不包含在默认用户区。
APP_HOST_AI_ENABLED=true
APP_HOST_AI_BASE_URL=https://api.openai.com/v1
APP_HOST_AI_API_KEY=<your-server-side-provider-key>
APP_HOST_AI_MODEL=<your-compatible-chat-model>
APP_HOST_AI_MAX_OUTPUT_TOKENS=1024