Suna : des agents intelligents qui intègrent les opérations de navigation et l'analyse des données

Dernières ressources sur l'IAPosté il y a 4 mois Cercle de partage de l'IA

1.5K 00

Introduction générale

Suna 是 Kortix AI 开发的一个开源通用 AI 代理，托管在 GitHub 上，基于 Apache 2.0 许可证，允许用户免费下载、修改和自托管。它通过自然语言对话帮助用户完成复杂任务，如网页浏览、文件管理、数据抓取和网站部署。Suna 采用模块化架构，包括 Python/FastAPI 后端、Next.js/React 前端、Supabase 数据库和 Daytona 沙盒，确保安全性和灵活性。它支持与 OpenAI、Anthropic 等大语言模型集成，并通过 Tavily 和 RapidAPI 提供实时搜索和数据服务。

Liste des fonctions

Automatisation du navigateur ：自动导航网页、填写表单、提取数据，支持价格监控和内容抓取。
Gestion des documents ：创建、编辑、删除文件，支持批量处理和格式转换（如 CSV 转 JSON）。
Exploration et recherche sur le web ：通过 Tavily 实时搜索，抓取网页内容，生成结构化报告。
opération en ligne de commande ：在 Daytona 沙盒中执行 Linux 命令，处理系统任务。
网站部署 ：将静态网站部署到 Cloudflare Pages，生成公开访问链接。
Intégration de l'API ：连接 LinkedIn、Zillow 等服务，获取专业数据，如公司信息或房产数据。
l'analyse des données ：处理 JSON、CSV、XML 数据，生成可视化图表或报告。
Planification de la mission : à travers todo.md 系统分解复杂任务，自动执行并跟踪进度。

Utiliser l'aide

Processus d'installation

Suna 支持自托管，适合有 Python 和 Node.js 开发经验的用户。以下是详细安装步骤：

Préparation de l'environnement : :
- 安装 Python 3.11+、Node.js 20.x、Git。
- 配置 Redis（推荐 Upstash 或本地安装）。
- 创建 Supabase 项目，获取 API URL、匿名密钥和服务角色密钥。
- 注册 Daytona 账户，配置 adamcohenhillel/kortix-suna:0.0.20 镜像。
- 获取 OpenAI 或 Anthropique Clé API.
- （可选）获取 Tavily 和 RapidAPI 密钥，增强搜索和数据功能。
Clonage de la base de code : :

git clone https://github.com/kortix-ai/suna.git
cd suna

配置后端环境 : :

entrer dans backend 目录，复制 .env.example en raison de .env: :
```
cd backend
cp .env.example .env
```

compilateur .env，填写以下内容：

NEXT_PUBLIC_URL="http://localhost:3000"
SUPABASE_URL=your_supabase_url
SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
REDIS_HOST=your_redis_host
REDIS_PORT=6379
REDIS_PASSWORD=your_redis_password
REDIS_SSL=True
DAYTONA_API_KEY=your_daytona_api_key
DAYTONA_SERVER_URL="https://app.daytona.io/api"
DAYTONA_TARGET="us"
ANTHROPIC_API_KEY=your_anthropic_api_key
MODEL_TO_USE="anthropic/claude-3-7-sonnet-latest"
TAVILY_API_KEY=your_tavily_api_key
RAPID_API_KEY=your_rapid_api_key

配置 Supabase 数据库 : :
- 安装 Supabase CLI：
```
npm install -g @supabase/supabase
```
- 登录并链接项目：
```
supabase login
supabase link --project-ref your_project_reference_id
supabase db push
```
- 在 Supabase 控制台的 Project Settings > Data API 中，确保 “basejump” 出现在 Exposed Schema。

Configuration de l'environnement frontal : :

entrer dans frontend 目录，复制 .env.example en raison de .env.local: :
```
cd ../frontend
cp .env.example .env.local
```

compilateur .env.local: :

NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
NEXT_PUBLIC_BACKEND_URL="http://localhost:8000/api"
NEXT_PUBLIC_URL="http://localhost:3000"

Installation des dépendances : :

前端：
```
cd frontend
npm install
```

后端：

cd ../backend
pip install -r requirements.txt

Démarrage des services : :
- Commencer la partie arrière :
```
cd backend
python api.py
```
- Commencer la partie avant :
```
cd frontend
npm run dev
```
- Ouvrez votre navigateur et visitez http://localhost:3000，注册账户即可使用。
（可选）云部署 : :
- 通过 suna.so 使用 Kortix 提供的云服务，免去本地配置。

Principales fonctions

Automatisation du navigateur

Suna 使用 Chromium 浏览器执行网页操作。例如，输入“从亚马逊提取 iPhone 14 价格”：

Suna 打开亚马逊，搜索 iPhone 14。
定位价格元素，提取数据。
返回结果或保存为文件。
procédure : :

在聊天界面输入指令，如“提取某网站价格”。
Suna 显示操作进度，返回结果。
可导出数据为 CSV 或 JSON。

Gestion des documents

Suna 支持文件创建和编辑。例如，“创建 report.txt，写入销售数据”：

Suna 生成文件，写入指定内容。
支持批量处理，如转换文件格式。
procédure : :

输入指令，指定文件名和内容。
Suna 返回文件路径或内容预览。
可继续操作，如“将文件转为 PDF”。

Exploration et recherche sur le web

Suna 集成 Tavily 提供实时搜索。例如，“分析德国汽车市场”：

Suna 搜索相关网页，提取数据。
清洗数据，生成报告。
procédure : :

输入分析主题。
Suna 规划抓取流程，显示结果。
可保存为 CSV、JSON 或 PDF。

opération en ligne de commande

Suna 在 Daytona 沙盒中运行 Linux 命令。例如，“列出目录文件”：

Suna 执行 ls，返回结果。
支持复杂命令，如 grep peut-être sed.
procédure : :

输入命令或任务描述。
Suna 返回输出或处理结果。

网站部署

Suna 支持静态网站部署。例如，“部署我的 HTML 项目”：

Suna 验证文件，上传至 Cloudflare Pages。
返回公开 URL。
procédure : :

输入项目路径和部署指令。
Suna 确认后执行部署。
返回访问链接。

Fonction en vedette Fonctionnement

Planification de la mission

Suna 使用 todo.md 系统分解任务。例如，“规划伦敦 10 天行程”：

Suna 创建任务清单（搜索航班、酒店、活动）。
逐项执行，生成行程文档。
procédure : :

Saisissez une description de la tâche.
Suna 显示 todo.md Plan.
用户可调整或确认执行。

Intégration de l'API

Suna 支持 LinkedIn、Zillow 等 API。例如，“抓取巴塞罗那公司数据”：

Suna 调用 LinkedIn API，提取公司信息。
生成销售线索列表。
procédure : :

输入数据需求。
Suna 配置 API，显示结果。
可导出为 Excel。

scénario d'application

Étude de marché
Suna 可抓取行业数据，生成报告。例如，分析英国医疗市场，Suna 从 Google 和 Crunchbase 提取数据，整理主要玩家和市场规模。
招聘支持
Suna 可从 LinkedIn 搜索候选人。例如，查找慕尼黑的初级软件工程师，筛选学历和经验，输出候选人列表。
Génération de contenu
Suna 可生成报告或行程。例如，规划巴黎到加州的 7 天公司旅行，搜索航班和活动，输出详细计划。
B2B 销售
Suna 可抓取潜在客户数据。例如，查找巴塞罗那 10-50 人公司，生成联系方式和个性化邮件模板。
Optimisation du référencement
Suna 可分析网站 SEO，查找关键词排名和遗漏主题。例如，分析 suna.so，生成优化建议报告。