Cookbook
Agents & skills · for AI agents

Habilidades de la plataforma — las que todo agente ya tiene

Una biblioteca compartida de métodos de trabajo generales disponibles para todo agente, recuperada por intención en lugar de adjuntarse uno por uno.

MCP tools:list_skillscreate_skillupdate_agent

Principio — las habilidades de la plataforma son métodos, las habilidades del inquilino son tu negocio. La biblioteca compartida contiene formas generales de trabajar (investigar a un competidor, leer una regulación, evaluar un prospecto). Todo lo específico de tu industria o de tus datos pertenece a tus propias habilidades. Más información en Principios de diseño.

Todo agente comienza con un conjunto de habilidades de la plataforma que no tuvo que recibir. Son métodos de trabajo generales, se cargan bajo demanda como cualquier otra habilidad, y no las adjuntas una por una.

Por qué no son simplemente "más habilidades en el agente"

Una biblioteca de unos pocos cientos de métodos no puede incluirse en el prompt. Listarlas todas rompe mediblemente la elección: con 207 habilidades listadas en su totalidad, el modelo eligió la correcta el 30% de las veces; con la lista primero reducida a las 15 más relevantes, 51%. Por lo tanto, la plataforma recupera antes de listar.

La recuperación se ejecuta en el mensaje de este turno, sobre ambas bibliotecas a la vez — la compartida y la tuya. Tus propias habilidades no están en desventaja por compartir el espacio con las generales: medido en 18 habilidades genuinamente específicas de la industria mezcladas en 193 generales, las habilidades de la industria fueron reconocidas más fiablemente (86% frente a 79%), porque el vocabulario de la industria se encuentra lejos del vocabulario de los métodos generales.

Por debajo de aproximadamente ocho habilidades no se recupera nada — se muestra simplemente la lista completa. A ese tamaño, la lista ya es precisa, y la recuperación solo podría introducir un nuevo fallo: la habilidad correcta que falta en la lista corta, con el modelo respondiendo luego desde su propio conocimiento y sin rastro en el registro.

Qué controlas y qué no

No es tuyo adjuntarlasLas habilidades de la plataforma están disponibles para todos los agentes por defecto. No hay una lista de verificación por agente para ellas.
Tuyo para desactivarlasUn operador puede retirar una habilidad de la plataforma de la circulación para todos; es una decisión a nivel de plataforma, no por agente.
Tuyo para anularlasEscribe tu propia habilidad para el mismo trabajo. La tuya se recupera en las mismas condiciones y, al ser específica de tu negocio, suele ganar en las solicitudes que realmente tratan sobre tu negocio.

Escríbelas en inglés

Las habilidades de la plataforma se escriben en inglés — description, instructions, menu_label y las frases de activación generadas.

Esto no es solo por las demostraciones. Medido en la misma biblioteca de 193 habilidades en chino, cambiar las tres habilidades de la plataforma de chino a inglés aumentó la fiabilidad con la que cada una fue reconocida: investigación de la competencia 75% → 83%, lectura de políticas 83% → 100%, calificación de prospectos 50% → 62%. Una habilidad en inglés se sitúa más lejos, en el espacio vectorial, de una multitud de habilidades en chino, por lo que es más fácil seleccionarla. (La ventaja proviene de ser diferente, no del inglés en sí mismo — en una biblioteca totalmente en inglés, desaparece.)

El idioma no afecta a si el modelo puede llamar a la habilidad: tanto un modelo autoalojado de 35B como uno alojado emitieron llamadas load_skill correctas y bien formadas a partir de descripciones en chino e inglés por igual. Elegir inglés es una decisión de producto, no un parche técnico.

Tus propias habilidades son un asunto diferente — escríbelas en el idioma que hablan tus clientes.

Haz que la plataforma investigue antes de ejecutar la habilidad

Una habilidad puede pedir que su material se reúna antes de empezar. Pon esta línea al principio de instructions:

PREFETCH: web x4

La plataforma convierte el mensaje del visitante en ese número de consultas, las lanza y entrega a la habilidad una tabla numerada de hechos para citar. PREFETCH: web a secas significa el valor por defecto de dos consultas; si omites la línea, no se busca nada.

Pide amplitud solo donde la pregunta tenga varias partes. Un análisis de producto —precios, límites, exportación— midió 2.957 palabras con cinco citas en un barrido estrecho, y cada precio era una cifra concreta que no figuraba en ninguna fuente; con cuatro consultas, la misma pregunta volvió con 17 citas. Las habilidades que redactan, reescriben o calculan no deberían declarar nada: una búsqueda que no necesitan es tiempo y dinero perdidos sin más.

No sustituye a dejar la regla por escrito, pero es la mitad que funciona. Las instrucciones de esa misma habilidad ya decían nunca indiques un precio que no esté en el material, y lo indicó igualmente. Lo que cambió la respuesta fue el material, no la frase.

Escribir una que realmente se use

Las mismas reglas que cualquier habilidad, más una que solo aparece a escala:

  • description dice cuándo, con las palabras que usaría un cliente. Es lo que la recuperación coincide.
  • instructions terminan con lo que la habilidad no cubre. Con cientos de habilidades, los vecinos cercanos son inevitables; esa línea final es lo único que permite al modelo notar que abrió la incorrecta.
  • Las frases de activación se generan para ti — ocho formas en lenguaje natural de cómo alguien podría pedirla — y puedes editarlas. Se comparan, nunca se muestran a los visitantes, y tus ediciones nunca se sobrescriben por regeneración.

Hay una comprobación que vale la pena ejecutar después de escribir una: pregúntale a la biblioteca qué habilidad recupera cada una de sus propias frases de activación. Si las propias frases de una habilidad siguen volviendo como otras habilidades, esa habilidad está en la biblioteca pero no se alcanzará — fusiona la que sigue ganando, o haz que las dos digan claramente cómo difieren.