# Connecteurs custom

Les connecteurs custom transforment des appels API HTTPS reutilisables en actions disponibles dans la palette du workspace courant.

## Structure du manifest

Un manifest de connecteur doit avoir un `id`, un `displayName` et au moins une action HTTP. Chaque action s'execute comme un noeud `httpRequest` et peut definir `inputSchema`, `outputSchema`, des champs de credential, de la doc et les valeurs par defaut de la requete.

```json
{
  "id": "acme_api",
  "displayName": "Acme API",
  "credentialProviders": ["http_bearer", "custom"],
  "actions": [
    {
      "id": "create_record",
      "label": "Create record",
      "handler": "http",
      "nodeType": "httpRequest",
      "inputSchema": {
        "type": "object",
        "properties": {
          "name": { "type": "string" }
        }
      },
      "defaultData": {
        "method": "POST",
        "url": "https://api.example.com/v1/records",
        "authType": "bearerSecret",
        "body": "{\n  \"name\": \"{input.name}\"\n}"
      }
    }
  ]
}
```

## Validation

Utilisez **Valider** dans Production > Connecteurs avant d'enregistrer. La validation applique les memes regles de securite que l'enregistrement, mais ne cree ni ne modifie le connecteur.

Le resultat contient les erreurs bloquantes, les avertissements, le manifest normalise, le nombre d'actions et les ids d'operations qui seront generes dans la palette apres enregistrement.

Les avertissements courants signalent les hosts API de placeholder, les champs `{input.*}` absents de `inputSchema.properties`, et les bodies sur actions GET.

## Preview d'action

Utilisez **Preview** sur une action de connecteur enregistree pour rendre la requete HTTP avec un input d'exemple. Le preview n'enregistre rien, n'execute pas le workflow et n'envoie aucune requete externe.

Le preview affiche la methode, l'URL, les headers, le body, les sample inputs manquants, les templates non resolus et si un credential sera requis au runtime. Les headers d'authentification sont decrits uniquement avec des valeurs masquees.

## Impact workflow

La page Connecteurs verifie quels workflows du workspace courant utilisent le connecteur selectionne. Consultez cet impact avant de desactiver ou supprimer un connecteur, surtout si des workflows live sont listes.

## Marketplace

Utilisez **Publier** sur un connecteur enregistre pour creer un snapshot marketplace. Les autres workspaces peuvent previsualiser le manifest, voir les actions et diagnostics, puis l'installer comme leur propre connecteur custom.

L'installation est bloquee si le workspace cible possede deja un connecteur built-in ou custom avec les memes ids de connecteur/action. Les credentials enregistres ne sont pas copies; l'installateur devra choisir ses propres credentials quand il utilisera l'action dans un workflow.

Quand vous publiez un workflow qui utilise une action de connecteur custom, la fiche workflow inclut aussi un snapshot du manifest du connecteur. Installer ce workflow peut installer automatiquement les connecteurs embarques manquants avant de creer le workflow brouillon.

## Utilisation dans les templates workflow

Quand un workflow marketplace utilise une action de connecteur custom, le contrat portable est l'id du connecteur plus l'id de l'action. Gardez `id` et l'`id` d'action stables apres publication de templates qui en dependent. Renommer l'un des deux cree un nouveau `connectorOperationId`; les fiches workflow existantes gardent leur snapshot embarque, tandis que les workflows edites doivent mettre leurs noeuds a jour vers la nouvelle operation.

Les fiches workflow peuvent embarquer les manifests de connecteurs custom pour la portabilite des templates. Les fiches connecteur restent utiles pour la decouverte, la reutilisation, les reviews et l'installation explicite. Mentionnez l'id du connecteur/des actions dans les descriptions ou tags du workflow pour aider les utilisateurs a reconnaitre dependances et collisions.

Les credentials restent hors des deux fiches. Un snapshot workflow peut porter des marqueurs de setup `credentialRequired`; un manifest connecteur peut porter des definitions de champs credential, pas des valeurs de credential.

## Regles de securite

Les actions de connecteur doivent utiliser des URLs HTTPS absolues. Le scheme et le host ne peuvent pas etre templates.

Ne mettez pas de credentials, tokens bruts, ids de credential, headers `Authorization`, `X-API-Key` ou autres headers d'authentification dans le manifest. Utilisez `authType` avec un credential HTTP enregistre.


## Workflow example

The example card below creates a connector-backed HTTP Request workflow. Use it to inspect the metadata fields kept on connector nodes.

---

*Source: https://agentbuilder.systalink.sn/docs/custom-connectors — human documentation.*
*Other language: [/docs-md/en/custom-connectors.md](/docs-md/en/custom-connectors.md).*
*Machine-readable index: [/llms.txt](/llms.txt).*