# Anay.OllamaChat

**Repository Path**: AnayDev/ollama-chat

## Basic Information

- **Project Name**: Anay.OllamaChat
- **Description**: Anay.OllamaChat 是基于 ASP.NET Core Web API 后端与 HTML + JavaScript 前端的实时聊天应用，使用 Ollama 服务提供智能对话能力。该程序提供简洁、直观的界面，方便集成到实际应用项目里。
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-28
- **Last Updated**: 2025-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 项目简介：Anay.OllamaChat

**项目名称**: Anay.OllamaChat

**技术栈**:
- **后端**: ASP.NET Core Web API (C#)
- **前端**: HTML, CSS, JavaScript
- **聊天引擎**: Ollama AI 服务
- **RAG (提示词工程)**: Embeddings (bge-m3 模型) -> Elastic 向量库检索 -> RAG提示词构建 -> AI回复
- **Agent (Function Calling)**: 使用FC函数调用外部Tools

**项目概述**:
Anay.OllamaChat 是一个基于 **ASP.NET Core Web API** 的轻量级聊天应用，集成 **Ollama AI 服务** 提供智能对话能力。该应用拥有简洁直观的用户界面，支持实时聊天交互，能够根据用户输入生成自然语言回复。项目旨在提供开箱即用的聊天组件，方便开发者快速集成到现有的 Web 系统中。

**前端界面展示**:

![常规交互](https://gitee.com/AnayDev/ollama-chat/raw/master/ui.png)

![RAG调用本地知识库构建提示词进行回答](https://gitee.com/AnayDev/ollama-chat/raw/master/ui2.png)

![使用FC函数调用外部知识库进行回答](https://gitee.com/AnayDev/ollama-chat/raw/master/ui4.png)

### 主要特点

1. **后端架构 (ASP.NET Core Web API)**:
   - 基于 RESTful 架构设计，提供高效的接口交互。
   - 封装对 **Ollama AI**，**Elasticsearch**，**Embeddings** 等接口调用，统一处理请求与响应。
   - 支持多会话管理，保证对话上下文的一致性。

2. **前端界面 (HTML + JavaScript)**:
   - 简洁直观的用户界面，支持多话题选择。
   - 输入框支持多行扩展，自动滚动适应长文本。
   - 消息对话展示区区分用户和 AI 消息，配有头像和时间戳。

3. **智能对话引擎**:
   - 通过 **Ollama AI 服务** 实现自然语言生成。
   - 支持连续多轮对话，保留上下文信息。
   - 集成 RAG 模型，增强知识库检索能力。
   - 支持函数Tools调用，扩展外部知识库。

4. **易于集成与扩展**:
   - 提供简洁接口，方便对接第三方系统。
   - 支持自定义话题、身份验证及响应配置。
   - 可扩展插件机制，满足业务定制需求。

### 使用方式

#### 1. 部署后端
- 修改 `appsettings.json` 配置 Ollama API 地址。
- 启动 ASP.NET Core Web API 服务。
- 通过 `curl` 测试接口：

```bash
# 启动会话
curl -X POST http://localhost:5142/ollama/start/session1

# 获取会话状态
curl -X GET http://localhost:5142/ollama/status
```

#### 2. 集成前端
- 将 HTML、CSS、JavaScript 文件集成到 Web 项目中。
- 使用 **Fetch API** 调用后端接口。
- 根据返回结果更新聊天面板。

### 代码仓库
[项目地址](https://gitee.com/AnayDev/ollama-chat)