Sally Skills

Conecta Sally AI con tu agente. La inteligencia sanitaria de grado clínico detrás de A1C Insights, Sally AI, ahora expuesta como un endpoint MCP y API REST para tu agente: más de 64 biomarcadores en marcos clínicos occidentales y preventivos de MTC. Autentícate, llama a las habilidades que necesitas, paga por solicitud. Diseñado para agentes que se preocupan por la salud y la evidencia.

Documentación

Sally Skills

Sally es inteligencia especializada en salud metabólica. Sally Skills permite a los desarrolladores integrar las capacidades especializadas de Sally en agentes de IA a través de Sally Console usando APIs REST y MCP.

Las capacidades disponibles incluyen:

  • 🩸 Contexto de Salud — Comprende más de 64 biomarcadores, incluyendo glucosa en sangre, HbA1c, sueño, actividad, signos vitales y señales ambientales.
  • 🧪 Análisis de Laboratorio — Transforma resultados de laboratorio en conocimientos de salud metabólica clínicamente significativos.
  • 💊 Evaluación de Pilas de Suplementos — Evalúa y puntúa pilas de suplementos por calidad, efectividad y consideraciones de salud metabólica.
  • 🥗 Análisis Nutricional — Analiza comidas y nutrientes, identifica opciones más saludables y detecta posibles trampas metabólicas.
  • 📈 Resumen Metabólico — Interpreta datos de monitores continuos de glucosa (CGM) para revelar patrones de glucosa y tendencias de salud metabólica.
  • 🌤️ Perspectivas Diarias — Resume la salud diaria usando sueño, signos vitales, actividad y datos ambientales con perspectivas personalizadas.
  • 🩻 Análisis de Radiografías de Tórax y Fracturas — Analiza radiografías de tórax y musculoesqueléticas para ayudar a identificar hallazgos clínicamente relevantes.
  • 📚 Conocimiento de Longevidad — Accede al conocimiento curado de Sally sobre salud metabólica y longevidad, combinando evidencia de la medicina occidental y la Medicina Tradicional China (MTC).

Compatible con Claude Code, Claude Desktop, Cursor, OpenClaw, Hermes, Manus, Perplexity y cualquier framework de IA que soporte APIs REST o MCP.

El Ecosistema

  • Sally — La IA especializada en salud metabólica y longevidad.
  • A1C Insights — La aplicación de consumo donde los usuarios conectan sus datos de salud y chatean con Sally a través de Ask Sally.
  • Sally Console — La plataforma para desarrolladores para integrar las capacidades de Sally en agentes de IA a través de APIs REST y MCP.

Sección 1. Incorporación

Antes de que tu agente pueda llamar a cualquier habilidad de Sally, tú (el humano) necesitas una clave API. Hay dos formas de entrar, y puedes comenzar con cualquiera de ellas.

Ruta A. Comienza en la consola (la más rápida)

  1. Visita https://console.a1c.io y regístrate con Apple o Google. Sin instalación de aplicación, sin lista de espera.
  2. Abre API Keys, haz clic en Create new key, asígnale un nombre (por ejemplo, "Claude Code en mi laptop") y haz clic en Generate.
  3. Copia la clave ahora. Comienza con sk-sally-… y se muestra solo una vez. Si la pierdes, revócala y vuelve a emitirla.

Esto te da una clave funcional de inmediato, con acceso al razonamiento especializado de Sally y a la base de conocimiento curada de salud metabólica y longevidad.

Lo que una clave solo de consola puede llamar hoy:

habilidadfunciona sin biomarcadores
chat_with_sallysí
analyze_lab_resultsí
food_journalsí
supplement_gradingsí
search_health_knowledgesí, gratis
lookup_supplement_gradesí, gratis
lookup_foodsí, gratis
health_syncnecesita biomarcadores
health_insightsnecesita biomarcadores
metabolic_overviewnecesita biomarcadores

Las últimas tres leen tus propios datos de CGM y dispositivos portátiles, por lo que sin ellos devuelven un error tipado no_health_data inmediatamente y no te cobran nada. Conecta tus biomarcadores en la ruta B y comenzarán a responder.

Ruta B. Añade tus propios biomarcadores con A1C Insights

Haz esto cuando quieras respuestas sobre tu glucosa, sueño y laboratorios en lugar del dominio en general.

  1. Abre la App Store en tu iPhone.
  2. Busca A1C Insights e instálala, o abre https://apps.apple.com/id/app/a1c-insights/id6748399956 en tu teléfono.
  3. Inicia sesión con la misma cuenta que usaste en la consola, o toca Sign Up si estás comenzando aquí.
  4. Recorre la incorporación (tus datos básicos, objetivos, dispositivos portátiles opcionales) y conecta un CGM o dispositivo portátil.

A1C Insights syncing your wearable data on first open   A1C Insights home dashboard after first sync

Recorrido visual con capturas de pantalla anotadas: https://console.a1c.io/docs.html#quickstart.

Sally Console y A1C Insights funcionan en el mismo backend, por lo que tu cuenta y tu clave son las mismas en ambos. ¿Ya estás en A1C Insights? Inicia sesión en la consola directamente y tu clave funcionará con los datos que ya has sincronizado.

¿Por qué iOS para biomarcadores? Habilidades como metabolic_overview, health_insights y health_sync leen datos de CGM y dispositivos portátiles que la aplicación de iPhone recopila a través de HealthKit. Todo lo demás funciona solo con una cuenta de consola.

Claves y facturación

Puedes crear múltiples claves por cuenta, una por agente o dispositivo, y todas comparten el mismo saldo de billetera. El uso por clave permanece auditable. Recarga con tarjeta o con USDC en Base, o ve ilimitado mensual.

Eso completa la sección 1. Ahora tienes:

  • Una cuenta, creada donde te haya convenido.
  • Una billetera financiada.
  • Una clave API sk-sally-… en tu portapapeles.

Sección 2. Usa tu clave desde cualquier agente

Tienes una clave. Tres formas de llamar a Sally con ella. La mayoría de los agentes solo necesitan la ruta MCP. Elige esa a menos que estés escribiendo scripts desde la línea de comandos.

2a. El catálogo de habilidades

Estas siete habilidades se activan en el momento en que tu clave funciona (lista en vivo en console.a1c.io):

HabilidadCosto / llamadaQué haceDetalle
supplement_grading 🆕$0.008Evalúa una pila de suplementos por interacciones, calidad de evidencia y brechas.—
health_sync10 gratis / mes, luego $0.001Trae más de 64 biomarcadores en vivo de dispositivos portátiles y CGM al contexto de tu agente.64 campos
chat_with_sally$0.003Pregunta a Sally cualquier cosa sobre salud preventiva y MTC, con evidencia calificada.uso
analyze_lab_result$0.008Analiza e interpreta paneles de laboratorio con banderas de riesgo y rangos de referencia.uso
health_insights$0.003Lecturas de mañana, tarde y noche desde sueño, signos vitales y actividad.uso
food_journal$0.004Evalúa comidas por macros y predicción de picos de glucosa, revelando patrones.uso
metabolic_overview$0.005Instantánea completa de CGM: tiempo en rango, variabilidad y curvas posprandiales.uso

Próximamente en la hoja de ruta: health_report, metabolic_risk_score, xray_skills y preventive_protocol.

Consulta catalog/ para el desglose completo de datos por habilidad.

2b. Tres formas de llamar

RutaMejor paraConfiguración
MCPCualquier agente de IA moderno (Claude, Cursor, OpenClaw, Hermes, Manus, Perplexity, otros).Un bloque de configuración JSON, reinicia el agente, las herramientas aparecen automáticamente.
API RESTScripts de Bash, tus propias aplicaciones, cualquier cosa que pueda curl.Una solicitud HTTP POST por llamada.
REST por habilidadIgual que REST, URL ligeramente más limpia por habilidad./v1/skills/<name>

Consulta protocols/mcp.md para la configuración universal de MCP, protocols/api.md para llamadas REST directas y agents/ para inicios rápidos por agente.

2c. Enrutamiento automático para agentes y CLIs

¿Quieres que tu agente elija la habilidad correcta de Sally para cualquier solicitud sin que tengas que pensarlo? Coloca SKILL.md en el prompt del sistema o campo de instrucciones del agente. Es un solo archivo con reglas de enrutamiento deterministas, tablas de decisión, patrones de encadenamiento y antipatrones. Funciona con cualquier agente basado en LLM o CLI basado en reglas.

Consulta SKILL.md para la capa completa de decisión del agente.

2d. La prueba rápida de 30 segundos

Confirma que tu clave funciona antes de configurar cualquier agente:

curl -sS https://sally.a1c.io/v1/call \
  -H "Authorization: Bearer sk-sally-…" \
  -H "Content-Type: application/json" \
  -d '{"skill":"health_sync","input":{}}' | jq .ok
# → true

true significa que tu clave está activa y puede llamar a health_sync (tus primeras 10 llamadas cada mes son gratis). Estás listo.

Guías por agente

Elige el agente que realmente usas:

¿No ves tu agente? La mayoría de los agentes modernos soportan MCP. Consulta protocols/mcp.md y usa la configuración universal.

Precios y billetera

  • Precio por llamada, sin suscripción. Consulta la tabla anterior. health_sync incluye 10 llamadas gratis por mes, luego $0.001 por llamada.
  • La verificación de billetera se aplica antes de cualquier llamada. Las habilidades de pago devuelven 402 payment_required si tu saldo está por debajo del precio, por lo que no hay cargos sorpresa.
  • Recarga a través de Stripe en https://console.a1c.io/billing. Pagos con tarjeta en USD.
  • Cada llamada escribe una fila inmutable en tu historial de uso. Míralo en console.a1c.io bajo Usage.

Privacidad y seguridad

  • Tu clave es tu identidad. Sally nunca acepta user_uuid, email ni ningún otro identificador del cuerpo de la solicitud de tu agente, solo el encabezado Authorization: Bearer sk-sally-…. Ningún agente puede hacerse pasar por otro usuario.
  • Los PDFs de laboratorio y fotos de comidas nunca se persisten en Sally. Fluyen agente → puerta de enlace → servicio de IA → respuesta, sin carga a S3 o GCS.
  • Los esquemas de salida son listas de permitidos. La respuesta de Sally solo contiene los campos explícitamente nombrados en la documentación de cada habilidad. Sin fugas accidentales de columnas de bases de datos internas.
  • Revoca instantáneamente en console.a1c.io bajo API Keys → Revoke. La clave anterior se vuelve inválida en su próxima solicitud.

Ayuda