# agent

**Repository Path**: meta-works---meta-works/agent

## Basic Information

- **Project Name**: agent
- **Description**: 使用python + OpenAI 实现的agent
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-05
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Agent

一个基于大语言模型的 AI Agent 示例项目。

## 项目简介

本项目实现了一个简单的 AI Agent，能够根据用户指令自主调用多种工具完成任务。Agent 基于 OpenAI API（支持 ModelScope 推理端点）构建，具备搜索、计算、文件读取等能力。

## 功能特性

- **对话式交互**：通过自然语言与用户进行多轮对话
- **网络搜索**：实时搜索互联网信息
- **数学计算**：执行数学表达式计算
- **文件读取**：读取本地文件内容
- **迭代执行**：支持多轮迭代完成任务（默认最多 10 轮）

## 环境要求

- Python 3.8+
- OpenAI SDK
- 网络连接（用于 API 调用和网络搜索）

## 安装配置

1. 克隆仓库：
```bash
git clone https://gitee.com/meta-works---meta-works/agent.git
cd agent
```

2. 安装依赖：
```bash
pip install openai
```

3. 配置 API Key：
在代码中设置 `api_key` 参数，或通过环境变量配置。

## 快速开始

```python
from agent_demo import run_agent

# 设置你的 API Key
api_key = "your-api-key"

# 运行 Agent
response = run_agent("请帮我搜索今天的天气信息，并计算 123 * 456 的结果", api_key)
print(response)
```

## 核心函数说明

| 函数 | 功能 |
|------|------|
| `initialize_client` | 初始化 OpenAI 客户端，可自定义 base_url |
| `search_web` | 执行网络搜索 |
| `calculate` | 计算数学表达式 |
| `read_file` | 读取指定路径的文件内容 |
| `run_agent` | 运行 Agent 主循环，处理用户请求 |

## 使用示例

### 初始化客户端

```python
from agent_demo import initialize_client

client = initialize_client(
    api_key="your-api-key",
    base_url="https://api-inference.modelscope.cn/v1"  # 可选，默认使用 ModelScope 端点
)
```

### 搜索功能

```python
from agent_demo import search_web

result = search_web("Python 教程")
print(result)
```

### 计算功能

```python
from agent_demo import calculate

result = calculate("(10 + 5) * 2")
print(result)  # 输出: 30
```

### 读取文件

```python
from agent_demo import read_file

content = read_file("example.txt")
print(content)
```

## 注意事项

- 请确保 API Key 有足够的配额
- 网络搜索功能需要有效的网络连接
- 文件读取功能需要确保文件路径存在且有读取权限
- 建议设置合理的 `max_iterations` 参数以控制执行轮次

## 许可证

本项目仅供学习和研究使用。