Agentes de IA
Los Agentes de IA de Sidian son asistentes inteligentes que te ayudan a escribir, entender y refactorizar código. Esta guía explica cómo interactuar con los Agentes de IA y aprovechar sus capacidades para mejorar tu proceso de desarrollo.
Descripción General de los Agentes de IA
Sidian proporciona varios Agentes de IA especializados para asistir con diferentes aspectos del desarrollo:
Asistente de Código
- Completado y sugerencias de código
- Generación de funciones y clases
- Asistencia en refactorización de código
- Detección y corrección de errores
Agente de Explicación
- Explicación y documentación de código
- Análisis de algoritmos
- Perspectivas de arquitectura
- Recomendaciones de aprendizaje
Interacción con los Agentes de IA
Hay múltiples formas de interactuar con los Agentes de IA de Sidian:
Interfaz de Chat
- Abrir el panel de chat de IA desde la barra lateral
- Escribir tu pregunta o solicitud en lenguaje natural
- La IA proporcionará respuestas contextuales basadas en tu código actual
- Hacer preguntas de seguimiento para clarificación
Asistencia en Línea
- Seleccionar código y presionar Ctrl+Shift+L para explicaciones
- Hacer clic derecho en el código para opciones del menú contextual
- Usar atajos de teclado para acciones rápidas de IA
- Pasar el cursor sobre errores para sugerencias de corrección con IA
Consejo Profesional: Los Agentes de IA entienden el contexto de tu proyecto, incluyendo bibliotecas importadas, patrones de codificación y estructura del proyecto. Esto permite una asistencia más precisa y relevante.
Capacidades de los Agentes
Generación de Código
- Creación de funciones: Describe lo que quieres y obtén funciones completas
- Estructura de clases: Genera estructuras de clases con métodos y propiedades
- Generación de pruebas: Crea pruebas unitarias para tu código existente
- Documentación: Genera comentarios y documentación
Análisis de Código
- Detección de errores: Identifica problemas potenciales en tu código
- Optimización de rendimiento: Sugiere mejoras para mejor rendimiento
- Análisis de seguridad: Encuentra vulnerabilidades de seguridad
- Calidad del código: Recomienda mejores prácticas y patrones
Asistencia en Refactorización
- Extraer métodos: Dividir funciones grandes
- Renombrar variables: Nomenclatura consistente en archivos
- Organizar importaciones: Limpiar y optimizar importaciones
- Formateo de código: Aplicar estilo consistente
Mejores Prácticas
Comunicación Efectiva
- Ser específico: Proporcionar solicitudes claras y detalladas
- Incluir contexto: Mencionar el lenguaje de programación y framework
- Hacer preguntas de seguimiento: No dudes en pedir clarificación
- Proporcionar ejemplos: Mostrar lo que estás tratando de lograr
Revisión de Código
- Siempre revisar: Nunca aceptar código generado por IA sin revisión
- Probar a fondo: Ejecutar pruebas y verificar funcionalidad
- Entender cambios: Asegurarse de entender lo que hizo la IA
- Mantener estilo: Garantizar consistencia con tu base de código
Privacidad y Seguridad
- Datos sensibles: Tener cuidado con código propietario o sensible
- Claves API: Nunca compartir claves API o credenciales
- Revisar sugerencias: Verificar implicaciones de seguridad de las sugerencias de IA
- Procesamiento local: Usar modo offline para proyectos sensibles
Funciones Avanzadas
Prompts Personalizados
Crear prompts reutilizables para tareas comunes:
// Prompt personalizado para creación de endpoint API
"Crear un endpoint de API REST para [recurso] con operaciones CRUD usando Express.js y MongoDB"Gestión de Contexto
- Contexto de archivo: La IA considera el archivo actual y archivos relacionados
- Contexto de proyecto: Comprensión de la estructura del proyecto y dependencias
- Contexto del historial: Conversaciones anteriores informan respuestas actuales
- Contexto de selección: Enfoque en código seleccionado para asistencia dirigida
Selección de Modelo
Elegir el modelo de IA correcto para tu tarea:
- Modelos rápidos: Respuestas rápidas para tareas simples
- Modelos avanzados: Razonamiento complejo y generación de código
- Modelos especializados: Modelos específicos del lenguaje o dominio
- Modelos locales: Procesamiento offline enfocado en privacidad
Solución de Problemas
Problemas Comunes
La IA no responde
- Para modelos en la nube: Verificar conexión a internet
- Para modelos locales: Verificar que Ollama/LM Studio esté ejecutándose
- Verificar estado de cuenta y suscripción
- Intentar actualizar la conexión de IA
Sugerencias inexactas
- Proporcionar más contexto en tu solicitud
- Ser más específico sobre los requisitos
- Intentar reformular tu pregunta
- Usar un modelo de IA diferente
Problemas de rendimiento
- Cerrar archivos y pestañas innecesarios
- Limpiar historial de conversación de IA
- Cambiar a un modelo de IA más rápido
- Verificar recursos del sistema
Obtener Ayuda
- Documentación: Guías y tutoriales completos
- Soporte: Asistencia directa del equipo de Sidian
- Comentarios: Reportar problemas y sugerir mejoras
Los Agentes de IA en Sidian están diseñados para ser tus compañeros de codificación, ayudándote a escribir mejor código más rápido mientras aprendes y mejoras tus habilidades en el camino.