Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.hybridbox.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Guide MCP

Hybridbox expose un point de terminaison Model Context Protocol (MCP) pour les clients d’agent qui souhaitent découvrir et appeler les pseudo-fonctions Hybridbox via le runtime d’agent A2A. Le point de terminaison MCP est /mcp. Les routes sources enregistrent POST /mcp pour les requêtes MCP JSON-RPC. GET /mcp est enregistré mais renvoie une méthode non autorisée, les clients doivent donc utiliser POST pour le trafic MCP.

​
Surface du protocole

Les méthodes JSON-RPC prises en charge incluent :
  • initialize
  • ping
  • notifications/initialized
  • tools/list
  • tools/call
Des sessions authentifiées sont requises pour tools/list et tools/call. Les outils visibles et les fonctions appelables dépendent de la session authentifiée.

​
Outils MCP

​
hybridbox_functions_list

Répertorie les pseudo-fonctions Hybridbox visibles par la session authentifiée. L’outil n’accepte pas les arguments. Utilisez-le en premier lorsqu’un agent a besoin de comprendre quelles fonctions sont disponibles avant d’appeler quoi que ce soit.

​
hybridbox_functions_explain

Explique les pseudo-fonctions Hybridbox visibles avec des schémas, de la documentation et des exemples. Arguments :
  • function : nom de pseudo-fonction unique facultatif à expliquer.
  • functions : tableau facultatif de noms de pseudo-fonctions à expliquer.
Utilisez-le avant l’exécution afin que l’agent puisse valider les noms, les arguments requis, les arguments facultatifs et les résultats attendus.

​
hybridbox_execute

Exécute les pseudo-fonctions publiques Hybridbox à l’aide de code pseudo-python via le même chemin d’autorisation et d’exécution que l’agent A2A. Arguments :
  • code : chaîne obligatoire contenant le code d’appel de fonction pseudo-python Hybridbox, tel que domains.list(account_id='acc_123').
N’exécutez le code qu’après avoir vérifié le schéma de fonction pertinent et validé les arguments. Le chemin d’exécution utilise le profil d’autorisation de la session authentifiée.

​
Flux de travail recommandé

1

Fonctions de liste

Appelez tools/list, puis appelez hybridbox_functions_list pour inspecter les pseudo-fonctions disponibles pour la session authentifiée.
2

Expliquer les fonctions

Appelez hybridbox_functions_explain avec function ou functions avant l’exécution. Utilisez le schéma et les exemples renvoyés pour préparer des arguments valides.
3

Exécuter avec des arguments validés

Appelez hybridbox_execute avec une chaîne code uniquement après que le nom de la fonction et les arguments correspondent au schéma expliqué.

​
Catalogue de fonctions

Le catalogue de fonctions A2A généré est la référence pour les pseudo-fonctions Hybridbox disponibles et leurs signatures.

Catalogue de fonctions A2A

Parcourez les signatures de fonctions générées, les capacités et les mappages de routes publics API.

Catalogue de fonctions brutes JSON

Inspectez les données du catalogue hybridbox.a2a.functions.v1 générées.