4sapicom智能聊天机器人技术架构与实践指南

import openai
import logging
from typing import Optional

# 配置日志记录，便于问题排查
logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
)
logger = logging.getLogger("chatbot_core")

class AIChatbot:
    def __init__(self, api_key: str, base_url: str = "https://4sapi.com"):
        """
        初始化聊天机器人客户端
        :param api_key: 平台认证密钥
        :param base_url: New API平台接入地址
        """
        self.client = openai.OpenAI(
            api_key=api_key,
            base_url=base_url
        )
        # 模型参数预设，平衡响应质量与效率
        self.default_params = {
            "engine": "davinci",  # 适用于通用对话场景，复杂需求可切换为"gpt-3.5-turbo"
            "max_tokens": 150,    # 控制回复长度，根据场景可调整为50-500
            "temperature": 0.7,   # 0.0-1.0，值越高回复越灵活，越低越严谨
            "stop": None          # 自定义回复终止符，如"\n"
        }

    def generate_response(self, prompt: str, custom_params: Optional[dict] = None) -> Optional[str]:
        """
        生成机器人回复
        :param prompt: 用户输入 prompt
        :param custom_params: 自定义模型参数，覆盖默认配置
        :return: 机器人回复文本，失败时返回None
        """
        # 合并默认参数与自定义参数
        params = {**self.default_params, **(custom_params or {})}
        try:
            response = self.client.Completion.create(
                prompt=prompt,
                **params
            )
            logger.info(f"成功生成回复，prompt长度：{len(prompt)}")
            return response.choices[0].text.strip()
        except openai.APIError as e:
            logger.error(f"API调用错误：{e.status_code} - {e.message}")
        except openai.RateLimitError as e:
            logger.error(f"接口限流错误：{e.message}，建议调整调用频率")
        except Exception as e:
            logger.error(f"未知错误：{str(e)}")
        return None

# 实例化与测试
if __name__ == "__main__":
    # 替换为实际API密钥
    bot = AIChatbot(api_key="your-api-key")
    user_input = "你好，帮我分析北京明天的天气情况，并推荐适合的出行方案"
    response = bot.generate_response(user_input)
    if response:
        print(f"智能助手：{response}")
    else:
        print("智能助手：当前服务暂时无法响应，请稍后重试")