Suna: agentes inteligentes que integram operações de navegador e análise de dados

Introdução geral

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

Lista de funções

• Automação do navegador ：自动导航网页、填写表单、提取数据，支持价格监控和内容抓取。
• Gerenciamento de documentos ：创建、编辑、删除文件，支持批量处理和格式转换（如 CSV 转 JSON）。
• Rastreamento e pesquisa na Web ：通过 Tavily 实时搜索，抓取网页内容，生成结构化报告。
• operação de linha de comando ：在 Daytona 沙盒中执行 Linux 命令，处理系统任务。
• 网站部署 ：将静态网站部署到 Cloudflare Pages，生成公开访问链接。
• Integração de API ：连接 LinkedIn、Zillow 等服务，获取专业数据，如公司信息或房产数据。
• análise de dados ：处理 JSON、CSV、XML 数据，生成可视化图表或报告。
• Planejamento da missão : através de todo.md 系统分解复杂任务，自动执行并跟踪进度。

Usando a Ajuda

Processo de instalação

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

1. Preparação do ambiente ::
   • 安装 Python 3.11+、Node.js 20.x、Git。
   • 配置 Redis（推荐 Upstash 或本地安装）。
   • 创建 Supabase 项目，获取 API URL、匿名密钥和服务角色密钥。
   • 注册 Daytona 账户，配置 adamcohenhillel/kortix-suna:0.0.20 镜像。
   • 获取 OpenAI 或 Antrópica Chave de API.
   • （可选）获取 Tavily 和 RapidAPI 密钥，增强搜索和数据功能。
2. Clonagem da base de código ::

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

1. 配置后端环境 ::
   • entrar em backend 目录，复制 .env.example por causa de .env::

     cd backend
     cp .env.example .env
     

   • compilador .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. Configuração do ambiente de front-end ::
   • entrar em frontend 目录，复制 .env.example por causa de .env.local::

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

   • compilador .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. Instalação de dependências ::
   • Front-end:

     cd frontend
     npm install
     

   • 后端：

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

5. Início dos serviços ::
   • Inicie o back-end:

     cd backend
     python api.py
     

   • Inicie o front end:

     cd frontend
     npm run dev
     

   • Abra seu navegador e acesse http://localhost:3000，注册账户即可使用。
6. （可选）云部署 ::
   • 通过 suna.so 使用 Kortix 提供的云服务，免去本地配置。

Funções principais

Automação do navegador

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

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

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

Gerenciamento de documentos

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

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

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

Rastreamento e pesquisa na Web

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

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

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

operação de linha de comando

O Suna executa comandos do Linux na área restrita do Daytona. Por exemplo, "list catalogue files" (listar arquivos do catálogo):

• Implementação da Suna ls, retorna o resultado.
• Suporte a comandos complexos, como grep talvez sed.
  procedimento ::

1. Digite uma descrição de comando ou tarefa.
2. A Suna retorna a saída ou os resultados do processamento.

网站部署

A Suna oferece suporte à implantação de sites estáticos. Por exemplo, "Deploy my HTML project" (Implantar meu projeto HTML):

• Arquivo de validação da Suna, carregado no Cloudflare Pages.
• Retorna a URL pública.
  procedimento ::

1. Insira o caminho do projeto e as instruções de implantação.
2. A Suna confirma e executa a implantação.
3. Retornar ao link de acesso.

Operação da função em destaque

Planejamento da missão

Uso da Suna todo.md Divida sistematicamente as tarefas. Por exemplo, "Planeje um itinerário de 10 dias para Londres":

• O Suna cria listas de tarefas (busca de voos, hotéis, eventos).
• Executar item por item e gerar arquivos de viagem.
  procedimento ::

1. Digite uma descrição da tarefa.
2. Shows da Suna todo.md Planejar.
3. O usuário pode ajustar ou confirmar a implementação.

Integração de API

A Suna oferece suporte a APIs para LinkedIn, Zillow, etc., por exemplo, "Grab Barcelona company data":

• A Suna chama a API do LinkedIn para extrair informações da empresa.
• Gerar uma lista de leads de vendas.
  procedimento ::

1. Insira os requisitos de dados.
2. A Suna configura a API e exibe os resultados.
3. Pode ser exportado para o Excel.

cenário do aplicativo

1. Pesquisa de mercado
   A Suna rastreia dados do setor para gerar relatórios. Por exemplo, para analisar o mercado de saúde do Reino Unido, a Suna extrai dados do Google e do Crunchbase para reunir os principais participantes e o tamanho do mercado.
2. Suporte ao recrutamento
   A Suna pode pesquisar candidatos no LinkedIn. Por exemplo, encontrar engenheiros de software juniores em Munique, filtrar por formação e experiência e gerar uma lista de candidatos.
3. Geração de conteúdo
   A Suna gera relatórios ou itinerários. Por exemplo, planeje uma viagem corporativa de 7 dias de Paris à Califórnia, pesquise voos e atividades e produza um programa detalhado.
4. Vendas B2B
   A Suna captura dados sobre clientes em potencial. Por exemplo, encontre empresas com 10 a 50 pessoas em Barcelona e gere informações de contato e modelos de e-mail personalizados.
5. Otimização de SEO
   A Suna analisa o SEO do site para encontrar classificações de palavras-chave e tópicos ausentes. Por exemplo, ele analisa o site suna.so e gera relatórios com recomendações de otimização.

QA

1. A Suna é adequada para usuários não técnicos?
   Usuários não técnicos podem usar o serviço de nuvem via suna.so sem configuração. A auto-hospedagem requer um conhecimento técnico.
2. A Suna é totalmente gratuita?
   O Suna é gratuito para código aberto, mas as implantações na nuvem ou as chamadas de API (por exemplo, Tavily, RapidAPI) podem incorrer em uma taxa.
3. Quais modelos são compatíveis com a Suna?
   A Suna é compatível com OpenAI, Anthropic e outros modelos por meio do LiteLLM, e é recomendada. Claude ou GPT-4o.
4. Como faço para proteger a Suna?
   A Suna usa o Daytona Sandbox para isolar as operações e proteger o sistema. Os usuários precisam gerenciar as chaves de API adequadamente.