App Actions Reference

Comment découvrir, lire et utiliser les schémas d'action des applications. Chaque action a des entrées typées, des sorties structurées, un coût de crédit et un type d'authentification – le tout interrogeable via MCP.

Découvrir les actions

Commencez par list_apps pour trouver l'application, puis get_app_actions pour obtenir le schéma complet de toutes ses actions:

// 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" }
}

Les ID d'action suivent le format appId.action-name (par exemple, hunter.find-email). Utilisez ces ID lors de la configuration des étapes du flux de travail.

Types de champs de saisie

Taper	Utiliser pour
chaîne	Noms, domaines, requêtes free-text
nombre	Comptes, limites, scores, montants
booléen	Indicateurs, bascules, commutateurs d'inclusion/exclusion
sélectionner	Champs à options fixes (région, statut, type)
sélection multiple	Plusieurs options fixes (industries, tags)
tableau	Liste des éléments à traiter (domaines, identifiants)
objet/json	Charge utile structurée (corps de la requête, objets de configuration)
URL	Champs URL validés (site Web de l'entreprise, lien de profil)
knowledge-list	Référence à une liste de connaissances par clé

Champs marqués required: true doit être câblé; les champs obligatoires manquants bloquent la publication (Validation). Champs avec supportsTemplateVariables: true accepter {{steps.stepId.field}} syntaxe.

Types d'authentification

Type d'authentification	Installation
oauth2	Connectez-vous une fois via le flux OAuth dans le tableau de bord des intégrations. Jetons auto-refresh.
Clé API	Collez la clé dans Intégrations → application → Configurer. Stocké crypté, workspace-scoped.
agentled-managed	Aucune configuration. AgentLed fournit la clé; utilisation facturée sur les crédits d’espace de travail.
porteur / basique	Transmettez le jeton ou les informations d'identification en tant qu'entrée d'étape (à utiliser avec la requête Custom Actions / HTTP).
aucun	Aucun justificatif requis. Action interne publique API ou AgentLed.

Pagination

Les applications qui renvoient des listes (Hunter, Affinity, LinkedIn search) exposent les paramètres de pagination dans le schéma d'action. Modèles courants:

•décalage / limite - passer offset: 0 puis incrémenter de limit chaque itération.
•curseur — la réponse comprend un nextCursor; passez-le au prochain appel.

Combinez la pagination avec un étape de boucle pour parcourir de grands ensembles de résultats, ou avec mise en lots pour se déployer sur les pages en parallèle.

Crédits dans les journaux d'exécution

Les déductions de crédits sont enregistrées par étape dans la chronologie d'exécution. Chaque résultat d'étape comprend:

•creditCost — crédits facturés pour cet appel.
•creditPricingType — per-usage (toujours facturé) ou per-result (facturé uniquement lorsqu'un résultat est renvoyé).

Les limites de débit au niveau du fournisseur (429) apparaissent sous forme d'erreurs d'étape dans la chronologie. Combiner avec Auto-Fix réessayez de gérer automatiquement les réponses transitoires rate-limit.

Tester une action

Utiliser test_app_action pour lancer une requête en direct et inspecter la réponse avant de la connecter à un workflow:

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

Prochaines étapes

App System — Comment les applications sont organisées, connectées et authentifiées
Custom Actions — Appelez APIs qui ne figure pas dans le catalogue avec les étapes de requête HTTP
MCP Tools Reference — Référence complète pour tous les outils AgentLed MCP