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

Introduction générale

Suna est un agent d'intelligence artificielle généraliste open source développé par Kortix AI, hébergé sur GitHub, basé sur la licence Apache 2.0, permettant aux utilisateurs de le télécharger, de le modifier et de l'auto-héberger gratuitement. Suna est construit sur une architecture modulaire qui comprend un backend Python/FastAPI, un frontend Next.js/React, une base de données Supabase, et un sandbox Daytona pour assurer la sécurité et la flexibilité. Il prend en charge l'intégration de grands modèles de langage tels que OpenAI, Anthropic, etc. Tavily et RapidAPI fournissent des services de recherche et de données en temps réel.

Liste des fonctions

• Automatisation du navigateur Le système d'information sur les prix : Il navigue automatiquement sur les pages web, remplit les formulaires, extrait les données, prend en charge la surveillance des prix et l'exploration du contenu.
• Gestion des documents Les fonctions suivantes sont disponibles : créer, modifier et supprimer des fichiers, prendre en charge le traitement par lots et la conversion de format (par exemple, CSV à JSON).
• Exploration et recherche sur le web : explorer le contenu des sites web et générer des rapports structurés grâce à la recherche en temps réel de Tavily.
• opération en ligne de commande Le système Daytona : Il exécute les commandes Linux et gère les tâches du système dans le bac à sable Daytona.
• Déploiement du site web Déploiement de sites web statiques sur des pages Cloudflare pour générer des liens accessibles au public.
• Intégration de l'API Connexion à des services tels que LinkedIn, Zillow, etc. pour des données professionnelles telles que des informations sur l'entreprise ou des données sur les biens immobiliers.
• l'analyse des données Les données JSON, CSV, XML sont traitées pour générer des graphiques ou des rapports visuels.
• Planification de la mission : à travers todo.md Le système décompose les tâches complexes, automatise l'exécution et suit les progrès réalisés.

Utiliser l'aide

Processus d'installation

Suna prend en charge l'auto-hébergement et convient aux utilisateurs ayant une expérience du développement Python et Node.js. Voici les étapes détaillées de l'installation :

1. Préparation de l'environnement : :
   • Installez Python 3.11+, Node.js 20.x, et Git.
   • Configurer Redis (Upstash ou installation locale recommandée).
   • Créer un projet Supabase et obtenir l'URL de l'API, la clé anonyme et la clé de rôle du service.
   • S'inscrire à un compte Daytona, configurer adamcohenhillel/kortix-suna:0.0.20 Miroir.
   • Obtenir OpenAI ou Anthropique Clé API.
   • (Facultatif) Obtenez les clés Tavily et RapidAPI pour améliorer les capacités de recherche et de données.
2. Clonage de la base de code : :

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

1. Configuration de l'environnement back-end : :
   • entrer dans backend copier le fichier .env.example en raison de .env: :

     cd backend
     cp .env.example .env
     

   • compilateur .env, remplissez le formulaire suivant :

     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. Configuration de la base de données Supabase : :
   • Installer le CLI de Supabase :

     npm install -g @supabase/supabase
     

   • Connectez-vous et reliez le projet :

     supabase login
     supabase link --project-ref your_project_reference_id
     supabase db push
     

   • Dans Project Settings > Data API dans la console Supabase, assurez-vous que "basejump" apparaît dans le Exposed Schema.
3. Configuration de l'environnement frontal : :
   • entrer dans frontend copier le fichier .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"
     

4. Installation des dépendances : :
   • Côté avant :

     cd frontend
     npm install
     

   • Arrière :

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

5. 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:3000Si vous souhaitez l'utiliser, vous pouvez enregistrer votre compte et l'utiliser.
6. (Facultatif) Déploiement dans le nuage : :
   • Utilisez les services en nuage fournis par Kortix via suna.so, éliminant ainsi le besoin de configuration locale.

Principales fonctions

Automatisation du navigateur

Suna utilise le navigateur Chromium pour effectuer des actions sur le web. Par exemple, tapez "Extraire le prix de l'iPhone 14 d'Amazon" :

• Suna ouvre Amazon et recherche l'iPhone 14.
• Localisez l'élément de prix et extrayez les données.
• Renvoie le résultat ou l'enregistre dans un fichier.
  procédure : :

1. Saisissez une commande dans l'écran de discussion, par exemple "Extraire les prix d'un site web".
2. Suna Affiche la progression de l'opération et renvoie le résultat.
3. Les données peuvent être exportées au format CSV ou JSON.

Gestion des documents

Suna prend en charge la création et l'édition de fichiers. Par exemple, "Créer un fichier report.txt pour écrire les données de vente" :

• Suna génère un fichier et écrit le contenu spécifié.
• Prise en charge du traitement par lots, comme la conversion de formats de fichiers.
  procédure : :

1. Entrez une commande qui spécifie le nom et le contenu du fichier.
2. Suna Renvoie un aperçu du chemin d'accès ou du contenu du fichier.
3. Vous pouvez poursuivre les opérations telles que "Convertir le fichier en PDF".

Exploration et recherche sur le web

Suna s'intègre à Tavily pour fournir des recherches en temps réel. Par exemple, "Analyser le marché automobile allemand" :

• Suna recherche les pages web pertinentes et extrait les données.
• Nettoyer les données et générer des rapports.
  procédure : :

1. Saisissez le sujet de l'analyse.
2. Suna planifie le processus de capture et affiche les résultats.
3. Peut être enregistré au format CSV, JSON ou PDF.

opération en ligne de commande

Suna exécute des commandes Linux dans le bac à sable Daytona. Par exemple, "list catalogue files" :

• Mise en œuvre de Suna lset renvoie le résultat.
• Prise en charge de commandes complexes telles que grep peut-être sed.
  procédure : :

1. Entrez une description de la commande ou de la tâche.
2. Suna renvoie les résultats de la production ou du traitement.

Déploiement du site web

Suna prend en charge le déploiement de sites web statiques. Par exemple, "Déployer mon projet HTML" :

• Fichier de validation Suna, téléchargé sur les pages Cloudflare.
• Renvoie l'URL publique.
  procédure : :

1. Saisissez le chemin d'accès au projet et les instructions de déploiement.
2. Suna confirme et exécute le déploiement.
3. Retourner au lien d'accès.

Fonction en vedette Fonctionnement

Planification de la mission

Utilisation de Suna todo.md Décomposer systématiquement les tâches. Par exemple, "Planifier un itinéraire de 10 jours pour Londres" :

• Suna crée des listes de tâches (recherche de vols, d'hôtels, d'événements).
• L'exécution se fait poste par poste et génère des fichiers de déplacement.
  procédure : :

1. Saisissez une description de la tâche.
2. Suna montre todo.md Plan.
3. L'utilisateur peut ajuster ou confirmer la mise en œuvre.

Intégration de l'API

Suna prend en charge les API pour LinkedIn, Zillow, etc., par exemple "Grab Barcelona company data" :

• Suna fait appel à l'API de LinkedIn pour extraire des informations sur l'entreprise.
• Générer une liste de prospects.
  procédure : :

1. Saisir les données requises.
2. Suna configure l'API et affiche les résultats.
3. Peut être exporté vers Excel.

scénario d'application

1. Étude de marché
   Suna explore les données de l'industrie pour générer des rapports. Par exemple, pour analyser le marché britannique de la santé, Suna extrait des données de Google et de Crunchbase pour rassembler les acteurs clés et la taille du marché.
2. Soutien au recrutement
   Suna peut rechercher des candidats sur LinkedIn. Par exemple, trouver des ingénieurs logiciels juniors à Munich, filtrer en fonction de la formation et de l'expérience, et obtenir une liste de candidats.
3. Génération de contenu
   Suna génère des rapports ou des itinéraires. Par exemple, planifier un voyage d'affaires de 7 jours de Paris à la Californie, rechercher des vols et des activités, et produire un programme détaillé.
4. Ventes B2B
   Suna recueille des données sur les clients potentiels. Par exemple, trouvez des entreprises de 10 à 50 personnes à Barcelone et générez des informations de contact et des modèles d'e-mails personnalisés.
5. Optimisation du référencement
   Suna analyse le référencement des sites web pour trouver des classements de mots-clés et des sujets manquants. Par exemple, il analyse suna.so et génère des rapports avec des recommandations d'optimisation.

QA

1. Suna convient-elle aux utilisateurs non techniques ?
   Les utilisateurs non techniques peuvent utiliser le service en nuage via suna.so sans configuration. L'auto-hébergement nécessite des connaissances techniques.
2. Suna est-elle totalement gratuite ?
   Suna est gratuite en open source, mais les déploiements dans le nuage ou les appels d'API (par exemple Tavily, RapidAPI) peuvent être payants.
3. Quels sont les modèles pris en charge par Suna ?
   Suna supporte OpenAI, Anthropic, et d'autres modèles à travers LiteLLM, et est recommandé. Claude ou GPT-4o.
4. Comment sécuriser Suna ?
   Suna utilise Daytona Sandbox pour isoler les opérations et sécuriser le système. Les utilisateurs doivent gérer correctement les clés API.