Sally Skills

Conecte a Sally AI ao seu agente. A inteligência de saúde de nível clínico por trás do A1C Insights, Sally AI, agora exposta como um endpoint MCP e API REST para seu agente — mais de 64 biomarcadores em frameworks preventivos da clínica ocidental e MTC. Autentique-se, chame as skills necessárias, pague por requisição. Construído para agentes que se importam com saúde e evidências.

Documentação

Sally Skills

Sally é uma inteligência especializada em saúde metabólica. Sally Skills permite que desenvolvedores integrem as capacidades especializadas da Sally em agentes de IA através do Sally Console usando APIs REST e MCP.

As capacidades disponíveis incluem:

  • 🩸 Contexto de Saúde — Entenda mais de 64 biomarcadores, incluindo glicose sanguínea, HbA1c, sono, atividade, sinais vitais e sinais ambientais.
  • 🧪 Análise Laboratorial — Transforme resultados de exames laboratoriais em insights clinicamente relevantes sobre saúde metabólica.
  • 💊 Pontuação de Suplementos — Pontue e avalie combinações de suplementos quanto à qualidade, eficácia e considerações de saúde metabólica.
  • 🥗 Análise Nutricional — Analise refeições e nutrientes, identifique escolhas mais saudáveis e detecte possíveis armadilhas metabólicas.
  • 📈 Visão Geral Metabólica — Interprete dados de monitores contínuos de glicose (CGM) para revelar padrões de glicose e tendências de saúde metabólica.
  • 🌤️ Insights Diários — Resuma a saúde diária usando dados de sono, sinais vitais, atividade e ambiente com insights personalizados.
  • 🩻 Análise de Radiografias de Tórax e Fraturas — Analise radiografias de tórax e musculoesqueléticas para auxiliar na identificação de achados clinicamente relevantes.
  • 📚 Conhecimento em Longevidade — Acesse o conhecimento selecionado da Sally sobre saúde metabólica e longevidade, combinando evidências da medicina ocidental e da Medicina Tradicional Chinesa (MTC).

Compatível com Claude Code, Claude Desktop, Cursor, OpenClaw, Hermes, Manus, Perplexity e qualquer framework de IA que suporte APIs REST ou MCP.

O Ecossistema

  • Sally — A IA especializada em saúde metabólica e longevidade.
  • A1C Insights — O aplicativo para consumidores onde os usuários conectam seus dados de saúde e conversam com a Sally através do Ask Sally.
  • Sally Console — A plataforma para desenvolvedores para integrar as capacidades da Sally em agentes de IA através de APIs REST e MCP.

Seção 1. Integração

Antes que seu agente possa chamar qualquer skill da Sally, você (o humano) precisa de uma chave de API. Há duas formas de começar, e você pode iniciar por qualquer uma delas.

Caminho A. Comece no console (mais rápido)

  1. Visite https://console.a1c.io e cadastre-se com Apple ou Google. Sem instalação de aplicativo, sem lista de espera.
  2. Abra API Keys, clique em Create new key, dê um nome (ex.: "Claude Code no meu laptop") e clique em Generate.
  3. Copie a chave agora. Ela começa com sk-sally-… e é exibida apenas uma vez. Se você a perder, revogue e reemita.

Isso lhe dá uma chave funcional imediatamente, com acesso ao raciocínio especializado da Sally e à base de conhecimento selecionada sobre metabolismo e longevidade.

O que uma chave somente do console pode chamar hoje:

skillfunciona sem biomarcadores
chat_with_sallysim
analyze_lab_resultsim
food_journalsim
supplement_gradingsim
search_health_knowledgesim, grátis
lookup_supplement_gradesim, grátis
lookup_foodsim, grátis
health_syncprecisa de biomarcadores
health_insightsprecisa de biomarcadores
metabolic_overviewprecisa de biomarcadores

Os três últimos leem seus próprios dados de CGM e wearables, então sem eles retornam um erro tipado no_health_data imediatamente e não cobram nada. Conecte seus biomarcadores no caminho B e eles começarão a responder.

Caminho B. Adicione seus próprios biomarcadores com A1C Insights

Faça isso quando quiser respostas sobre sua glicose, sono e exames, em vez do domínio em geral.

  1. Abra a App Store no seu iPhone.
  2. Pesquise por A1C Insights e instale, ou abra https://apps.apple.com/id/app/a1c-insights/id6748399956 no seu telefone.
  3. Entre com a mesma conta que você usou no console, ou toque em Sign Up se estiver começando por aqui.
  4. Complete a integração (seus dados básicos, objetivos, wearables opcionais) e conecte um CGM ou wearable.

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

Passo a passo visual com capturas de tela anotadas: https://console.a1c.io/docs.html#quickstart.

O Sally Console e o A1C Insights rodam no mesmo backend, então sua conta e sua chave são as mesmas em ambos. Já está no A1C Insights? Entre no console diretamente e sua chave funcionará com os dados que você já sincronizou.

Por que iOS para biomarcadores? Skills como metabolic_overview, health_insights e health_sync leem dados de CGM e wearables que o aplicativo do iPhone coleta via HealthKit. Todo o resto funciona apenas com uma conta no console.

Chaves e cobrança

Você pode criar várias chaves por conta, uma por agente ou dispositivo, e todas compartilham o mesmo saldo de carteira. O uso por chave permanece auditável. Recarregue com cartão ou com USDC na Base, ou opte pelo plano mensal ilimitado.

Seção 1 concluída. Agora você tem:

  • Uma conta, criada onde preferir.
  • Uma carteira com saldo.
  • Uma chave de API sk-sally-… na sua área de transferência.

Seção 2. Use sua chave de qualquer agente

Você tem uma chave. Três formas de chamar a Sally com ela. A maioria dos agentes só precisa do caminho MCP. Escolha esse, a menos que esteja escrevendo scripts pela linha de comando.

2a. O catálogo de skills

Estas sete skills ficam ativas no momento em que sua chave funciona (lista ao vivo em console.a1c.io):

SkillCusto / chamadaO que fazDetalhe
supplement_grading 🆕$0,008Avalie uma combinação de suplementos quanto a interações, qualidade de evidência e lacunas.—
health_sync10 grátis / mês, depois $0,001Traga mais de 64 biomarcadores ao vivo de wearables e CGM para o contexto do seu agente.64 campos
chat_with_sally$0,003Pergunte qualquer coisa à Sally sobre saúde preventiva e MTC, com evidências classificadas.uso
analyze_lab_result$0,008Analise e interprete painéis laboratoriais com alertas de risco e faixas de referência.uso
health_insights$0,003Leituras de manhã, tarde e noite a partir de sono, sinais vitais e atividade.uso
food_journal$0,004Avalie refeições por macronutrientes e previsão de pico de glicose, revelando padrões.uso
metabolic_overview$0,005Visão completa do CGM: tempo no intervalo, variabilidade e curvas pós-prandiais.uso

Em breve no roadmap: health_report, metabolic_risk_score, xray_skills e preventive_protocol.

Veja catalog/ para o detalhamento completo de dados por skill.

2b. Três formas de chamar

CaminhoMelhor paraConfiguração
MCPQualquer agente de IA moderno (Claude, Cursor, OpenClaw, Hermes, Manus, Perplexity, outros).Um bloco de configuração JSON, reinicie o agente, as ferramentas aparecem automaticamente.
API RESTScripts Bash, seus próprios aplicativos, qualquer coisa que possa curl.Um POST HTTP por chamada.
REST por skillIgual ao REST, com URL ligeiramente mais limpa por skill./v1/skills/<name>

Veja protocols/mcp.md para a configuração universal do MCP, protocols/api.md para chamadas REST puras e agents/ para guias rápidos por agente.

2c. Roteamento automático para agentes e CLIs

Quer que seu agente escolha a skill certa da Sally para qualquer solicitação sem que você precise pensar nisso? Coloque SKILL.md no prompt do sistema ou no campo de instruções do agente. É um único arquivo com regras de roteamento determinísticas, tabelas de decisão, padrões de encadeamento e antipadrões. Funciona com qualquer agente baseado em LLM ou CLI baseada em regras.

Veja SKILL.md para a camada completa de decisão do agente.

2d. O teste rápido de 30 segundos

Confirme que sua chave funciona antes de configurar qualquer 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 sua chave está ativa e pode chamar health_sync (suas primeiras 10 chamadas por mês são gratuitas). Você está pronto.

Guias por agente

Escolha o agente que você realmente usa:

Não vê seu agente? A maioria dos agentes modernos suporta MCP. Veja protocols/mcp.md e use a configuração universal.

Preços e carteira

  • Preço por chamada, sem assinatura. Veja a tabela acima. health_sync inclui 10 chamadas gratuitas por mês, depois $0,001 por chamada.
  • A verificação da carteira é aplicada antes de qualquer chamada. Skills pagas retornam 402 payment_required se seu saldo estiver abaixo do preço, então não há cobranças surpresa.
  • Recarregue via Stripe em https://console.a1c.io/billing. Pagamentos com cartão em USD.
  • Cada chamada grava uma linha imutável no seu histórico de uso. Veja em console.a1c.io sob Usage.

Privacidade e segurança

  • Sua chave é sua identidade. A Sally nunca aceita user_uuid, email ou qualquer outro identificador do corpo da solicitação do seu agente, apenas o cabeçalho Authorization: Bearer sk-sally-…. Nenhum agente pode se passar por outro usuário.
  • PDFs de exames e fotos de refeições nunca são persistidos pela Sally. Eles fluem agente → gateway → serviço de IA → resposta, sem upload para S3 ou GCS.
  • Os esquemas de saída são listas de permissões. A resposta da Sally contém apenas os campos explicitamente nomeados na documentação de cada skill. Sem vazamento acidental de colunas de bancos de dados internos.
  • Revogue instantaneamente em console.a1c.io sob API Keys → Revoke. A chave antiga se torna inválida na próxima solicitação.

Ajuda