Suna: Intelligente Agenten, die Browserbetrieb und Datenanalyse integrieren

Allgemeine Einführung

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

Funktionsliste

• Browser-Automatisierung ：自动导航网页、填写表单、提取数据，支持价格监控和内容抓取。
• Verwaltung von Dokumenten ：创建、编辑、删除文件，支持批量处理和格式转换（如 CSV 转 JSON）。
• Crawlen und Suchen im Web ：通过 Tavily 实时搜索，抓取网页内容，生成结构化报告。
• Befehlszeilenbetrieb ：在 Daytona 沙盒中执行 Linux 命令，处理系统任务。
• 网站部署 ：将静态网站部署到 Cloudflare Pages，生成公开访问链接。
• API-Integration ：连接 LinkedIn、Zillow 等服务，获取专业数据，如公司信息或房产数据。
• Datenanalyse ：处理 JSON、CSV、XML 数据，生成可视化图表或报告。
• Planung von Einsätzen : durch todo.md 系统分解复杂任务，自动执行并跟踪进度。

Hilfe verwenden

Einbauverfahren

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

1. Vorbereiten der Umgebung ::
   • 安装 Python 3.11+、Node.js 20.x、Git。
   • 配置 Redis（推荐 Upstash 或本地安装）。
   • 创建 Supabase 项目，获取 API URL、匿名密钥和服务角色密钥。
   • 注册 Daytona 账户，配置 adamcohenhillel/kortix-suna:0.0.20 镜像。
   • 获取 OpenAI 或 Anthropisch API-Schlüssel.
   • （可选）获取 Tavily 和 RapidAPI 密钥，增强搜索和数据功能。
2. Klonen der Codebasis ::

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

1. 配置后端环境 ::
   • gehen in backend 目录，复制 .env.example wegen .env::

     cd backend
     cp .env.example .env
     

   • Compiler .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
     

2. 配置 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。
3. Konfigurieren der Front-End-Umgebung ::
   • gehen in frontend 目录，复制 .env.example wegen .env.local::

     cd ../frontend
     cp .env.example .env.local
     

   • Compiler .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"
     

4. Installation von Abhängigkeiten ::
   • Vorderseite:

     cd frontend
     npm install
     

   • 后端：

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

5. Neue Dienste ::
   • Starten Sie das hintere Ende:

     cd backend
     python api.py
     

   • Starten Sie das Frontend:

     cd frontend
     npm run dev
     

   • Öffnen Sie Ihren Browser und besuchen Sie http://localhost:3000，注册账户即可使用。
6. （可选）云部署 ::
   • 通过 suna.so 使用 Kortix 提供的云服务，免去本地配置。

Hauptfunktionen

Browser-Automatisierung

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

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

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

Verwaltung von Dokumenten

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

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

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

Crawlen und Suchen im Web

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

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

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

Befehlszeilenbetrieb

Suna führt Linux-Befehle in der Daytona-Sandbox aus. Zum Beispiel: "Katalogdateien auflisten":

• Suna Umsetzung lsgibt das Ergebnis zurück.
• Unterstützung für komplexe Befehle wie grep vielleicht sed.
  Verfahren ::

1. Geben Sie eine Befehls- oder Aufgabenbeschreibung ein.
2. Suna gibt die Ausgabe oder die Verarbeitungsergebnisse zurück.

网站部署

Suna unterstützt die Bereitstellung statischer Websites. Zum Beispiel: "Mein HTML-Projekt bereitstellen":

• Suna-Validierungsdatei, hochgeladen auf Cloudflare Pages.
• Gibt die öffentliche URL zurück.
  Verfahren ::

1. Geben Sie den Projektpfad und die Bereitstellungsanweisungen ein.
2. Suna bestätigt den Einsatz und führt ihn durch.
3. Zurück zum Zugangslink.

Featured Function Bedienung

Planung von Einsätzen

Suna verwenden todo.md Gliedern Sie Aufgaben systematisch auf. Zum Beispiel: "Planen Sie eine 10-tägige Reiseroute für London":

• Suna erstellt Aufgabenlisten (Suche nach Flügen, Hotels, Veranstaltungen).
• Führen Sie Posten für Posten aus und erzeugen Sie Reisedateien.
  Verfahren ::

1. Geben Sie eine Beschreibung der Aufgabe ein.
2. Suna zeigt todo.md Plan.
3. Der Benutzer kann die Umsetzung anpassen oder bestätigen.

API-Integration

Suna unterstützt APIs für LinkedIn, Zillow, etc. z.B. "Grab Barcelona company data":

• Suna ruft die LinkedIn-API auf, um Unternehmensinformationen zu extrahieren.
• Erstellen Sie eine Liste von Leads.
  Verfahren ::

1. Geben Sie die Datenanforderungen ein.
2. Suna konfiguriert die API und zeigt die Ergebnisse an.
3. Kann in Excel exportiert werden.

Anwendungsszenario

1. Marktforschung
   Suna durchforstet Branchendaten, um Berichte zu erstellen. Um beispielsweise den britischen Gesundheitsmarkt zu analysieren, extrahiert Suna Daten von Google und Crunchbase, um die wichtigsten Akteure und die Marktgröße zu erfassen.
2. Unterstützung bei der Rekrutierung
   Suna kann auf LinkedIn nach Kandidaten suchen. Finden Sie zum Beispiel Junior Software Engineers in München, filtern Sie nach Ausbildung und Erfahrung und geben Sie eine Liste von Kandidaten aus.
3. Generierung von Inhalten
   Suna erstellt Berichte oder Reiserouten. Planen Sie zum Beispiel eine 7-tägige Geschäftsreise von Paris nach Kalifornien, suchen Sie nach Flügen und Aktivitäten und geben Sie ein detailliertes Programm aus.
4. B2B-Verkauf
   Suna erfasst Interessentendaten. Finden Sie zum Beispiel Unternehmen mit 10-50 Mitarbeitern in Barcelona und generieren Sie Kontaktinformationen und personalisierte E-Mail-Vorlagen.
5. SEO-Optimierung
   Suna analysiert die Suchmaschinenoptimierung von Websites, um Keyword-Rankings und fehlende Themen zu finden. Zum Beispiel analysiert es suna.so und erstellt Berichte mit Optimierungsempfehlungen.

QA

1. Ist Suna für nichttechnische Benutzer geeignet?
   Technisch nicht versierte Nutzer können den Cloud-Service über suna.so nutzen, ohne dass eine Konfiguration erforderlich ist. Für das Self-Hosting ist ein technischer Hintergrund erforderlich.
2. Ist Suna völlig kostenlos?
   Suna ist als Open Source kostenlos, aber für Cloud-Implementierungen oder API-Aufrufe (z. B. Tavily, RapidAPI) kann eine Gebühr anfallen.
3. Welche Modelle werden von Suna unterstützt?
   Suna unterstützt OpenAI, Anthropic und andere Modelle über LiteLLM und wird empfohlen. Claude oder GPT-4o.
4. Wie kann ich Suna sichern?
   Suna verwendet Daytona Sandbox, um Vorgänge zu isolieren und das System zu sichern. Die Benutzer müssen die API-Schlüssel ordnungsgemäß verwalten.