Consejos, Productos

Presentamos las competencias de Sinch: conocimientos expertos de la API de Sinch, directamente en tu agente de codificación de IA

Image for Presentamos las competencias de Sinch: conocimientos expertos de la API de Sinch, directamente en tu agente de codificación de IA

Los agentes de codificación de IA como Claude Code, Gemini CLI y Cursor te ayudan a enviar más rápido. Pero estos agentes son tan buenos como el contexto del que disponen, y a menudo fallan al desarrollar con APIs. El agente no es el problema. Solo necesita el conocimiento adecuado. 

Por eso hemos creado Sinch Skills – un sólido establecer de archivos de conocimiento estructurado que le dan a tu agente de programación de IA un contexto de nivel experto para cada API de Sinch. Instala una vez, y tu agente se encarga del resto. 

Los datos de entrenamiento de IA genéricos te llevan a cerrar un código listo para producción, pero «cerrar» no es suficiente.

Cuando los desarrolladores usan agentes de IA para desarrollar con APIs hoy en día, pueden encontrarse con algunos problemas predecibles: 

When developers use AI agents to build with APIs today, they may run into some predictable problems: 

  • Auth methods vary by API 
  • Regional endpoint rules are not always documented in a way agents easily pick up
  • Agents often retry billable actions, without first verifying the action’s state, leading to unnecessary charges 
  • Async flows — webhook setup, processing modes, campaign approval — require sequencing that agents have to guess at without guidance. 

Las competencias de Sinch son archivos estructurados que tu agente de programación de IA lee como contexto, como ayuda a los desarrolladores para evitar los problemas comunes de las integraciones de API generadas por IA. 

Cada competencia es un directorio que contiene un archivo SKILL.md con todo lo que el agente necesita para trabajar con una API de Sinch específica, que incluye:

Each skill is a directory containing a SKILL.md file with everything the agent needs to work with a specific Sinch API, including:

  • Auth setup
  • Getting-started code
  • Key concepts
  • Common patterns and “gotchas” 
  • Links to the full API reference

La divulgación progresiva mantiene el contexto limpio

Las competencias utilizan la divulgación progresiva, por lo que no saturan la ventana de contexto de tu agente. 

Skills use progressive disclosure, so they don’t overwhelm your agent’s context window. 

  1. Your agent starts by loading only the name and description of each skill. This tells it what knowledge is available. 
  2. When a task matches a skill, the agent reads the full SKILL.md and any referenced scripts or assets.
  3. Your agent generates code guided by real Sinch expertise, not training data guesswork.

Lista de competencias que cubren la cartera de productos de Sinch

Estamos realizando el lanzamiento con cobertura en cada área principal de los productos de Sinch:

CategoríaCompetencias
PrincipalAutenticación: OAuth2, claves de API, inicialización de SDK en todas las API
MensajeríaAPI de conversación, API de aprovisionamiento: 11 canales, incluidos WhatsApp, SMS, RCS, servicio de mensajería multimedia y Viber 
VozAPI de voz: llamadas, IVR, TTS, conferencias, controlar llamadas SVAML 
Vídeo & SIPLlamadas en la aplicación, troncal SIP elástico
EmailMailgun, Mailgun Inspect, Mailgun Optimize, Mailgun Validate
NúmerosAPI de números, API de pedido de números, Números importados, suscripción a 10DLC
VerificaciónAPI de verificación, API de búsqueda de números
Otra opciónAPI de fax

Cada competencia va más allá de los ejemplos de la API. Incluyen los patrones del mundo real, la secuenciación y los casos extremos que marcan la diferencia entre el código de prueba y el código que se envía. 

Algunos ejemplos de cómo se ve esto en la práctica:

A few examples of what that looks like in practice:

  • The 10DLC skill covers the full six-step registration workflow, including why vague campaign descriptions get rejected by TCR and why you should always use FULL registration type for production.
  • The Verification skill leads with the auth pattern developers get wrong most often: Application Key and Secret, not project OAuth2.
  • The Voice skill covers that cli is required for TTS callouts to connect, that instruction order in SVAML matters, and that ACE callbacks are not sent for in-app destinations.

De la experiencia del desarrollador a la experiencia del agente

Una gran experiencia del desarrollador solía significar documentos claros, buenos SDK y una rápida bienvenida e introducción. Esas cosas siguen siendo importantes. Pero ahora, a menudo el trabajo de un desarrollador es dirigir a un agente que hace la implementación. 

Ese cambio modifica lo que significa «una buena experiencia de desarrollador». No basta con tener documentación que un humano pueda leer. El conocimiento debe estar en un formato que un agente también pueda usar: estructurado, con opiniones y delimitado con precisión. 

Competencias de Sinch es nuestra respuesta a eso. Queremos que tu agente se comporte como un desarrollador experto de Sinch: conociendo los patrones correctos, detectando los errores comunes y al generar código en el que puedas confiar. 

Empieza gratis con un comando

npx skills add sinch/skills

Este comando añade todas las competencias al entorno de tu agente. También puedes instalar competencias individualmente o establecer su configuración desde el repositorio de complementos de Sinch si lo prefieres.  

Las competencias son de uso gratuito y de código abierto bajo Apache-2.0. Necesitas una cuenta de Sinch para usar las API que describen las competencias; regístrate en dashboard.sinch.com.

Puedes navegar por la biblioteca completa de competencias de Sinch en github.com/sinch/skills. ¡Échale un vistazo y dinos qué te parece! Si te resulta útil, dale una ⭐ en GitHub como ayuda para hacer crecer la comunidad. 

Este es el principio. Vamos a actualizar continuamente las competencias a medida que evolucionen las APIs, ampliando la cobertura en función de lo que los desarrolladores construyen realmente. Si tienes comentarios o quieres contribuir, el repositorio está abierto: las solicitudes de extracción son bienvenidas. 

Sobre nosotros: Sinch

Sinch impulsa conversaciones fluidas para crear conexiones duraderas entre las empresas y sus clientes. Más de 150.000 empresas, incluidas las principales empresas tecnológicas del mundo, confían en la red más fiable de Sinch para la mensajería, voz, verificación y correo. Visita sinch.com para obtener más información sobre nosotros, Sinch, y nuestros productos y servicios.

Sinch drives seamless conversations that create lasting connections between businesses and their customers. More than 150,000 businesses, including the world’s leading tech companies, rely on Sinch’s most reliable network for messaging, voice, verification and email. Visit sinch.com to learn more about Sinch and our products and services.