App Actions Reference

Cómo descubrir, leer y utilizar esquemas de acciones de aplicaciones. Cada acción tiene entradas escritas, salidas estructuradas, un costo de crédito y un tipo de autenticación, todo consultable a través de MCP.

Descubriendo acciones

Empezar con list_apps para encontrar la aplicación, entonces get_app_actions para obtener el esquema completo de todas sus acciones:

// Find apps by name or category
list_apps()

// Get all actions for a specific app
get_app_actions("affinity-crm")

// Result shape:
{
  id: "affinity-crm.resolve-company-by-url",
  name: "Resolve Company by URL",
  description: "Find an Affinity company record by its website URL",
  inputs: [...],
  outputs: [...],
  creditCost: 1,
  creditPricingType: "per-result",
  authentication: { type: "apiKey" }
}

Los ID de acción siguen el formato appId.action-name (p.ej., hunter.find-email). Utilice estos ID al configurar los pasos del flujo de trabajo.

Tipos de campos de entrada

Tipo	Usar para
cadena	Nombres, dominios, consultas free-text
número	Conteos, límites, puntuaciones, cantidades
booleano	Banderas, alternancias, interruptores de inclusión/exclusión
seleccionar	Campos de opciones fijas (región, estado, tipo)
selección múltiple	Múltiples opciones fijas (industrias, etiquetas)
formación	Lista de elementos a procesar (dominios, ID)
objeto/json	Carga útil estructurada (cuerpo de la solicitud, objetos de configuración)
URL	Campos URL validados (sitio web de la empresa, enlace del perfil)
knowledge-list	Referencia a una Lista de Conocimientos por clave

Campos marcados required: true debe estar cableado; faltan campos obligatorios que bloquean la publicación (Validación). Campos con supportsTemplateVariables: true aceptar {{steps.stepId.field}} sintaxis.

Tipos de autenticación

Tipo de autenticación	Configuración
oauth2	Conéctese una vez a través del flujo OAuth en el panel de Integraciones. Fichas auto-refresh.
apiKey	Pegue la clave en Integraciones → aplicación → Configurar. Almacenado cifrado, workspace-scoped.
agentled-managed	Sin configuración. AgentLed proporciona la clave; el uso se factura a créditos del espacio de trabajo.
portador / básico	Pase el token o las credenciales como entrada de paso (úselo con la solicitud Custom Actions/HTTP).
ninguno	No se requiere credencial. Acción interna pública API o AgentLed.

Paginación

Las aplicaciones que devuelven listas (búsqueda Hunter, Affinity, LinkedIn) exponen parámetros de paginación en el esquema de acción. Patrones comunes:

•compensación / límite - aprobar offset: 0 luego incrementar en limit cada iteración.
•cursor — la respuesta incluye una nextCursor; pasarlo a la siguiente convocatoria.

Combinar paginación con un paso de bucle para recorrer grandes conjuntos de resultados, o con procesamiento por lotes desplegarse a través de las páginas en paralelo.

Créditos en registros de ejecución

Las deducciones de crédito se registran por paso en el cronograma de ejecución. La salida de cada paso incluye:

•creditCost — créditos cobrados por esta llamada.
•creditPricingType — per-usage (siempre cargado) o per-result (se cobra solo cuando se devuelve un resultado).

Los límites de tarifas a nivel de proveedor (429) aparecen como errores de paso en la línea de tiempo. combinar con Auto-Fix Vuelva a intentar manejar las respuestas rate-limit transitorias automáticamente.

Probar una acción

Usar test_app_action para activar una solicitud en vivo e inspeccionar la respuesta antes de conectarla a un flujo de trabajo:

test_app_action("hunter", "find-email", {
  domain: "acme.com",
  first_name: "Jane",
  last_name: "Doe"
})
// Returns live API response — inspect output fields before adding to workflow

Próximos pasos

App System — Cómo se organizan, conectan y autentican las aplicaciones
Custom Actions — Llame a APIs que no está en el catálogo con HTTP Solicite pasos
MCP Tools Reference — Referencia completa para todas las herramientas AgentLed MCP