Vai al contenuto principale

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.

​
MCP guida

Hybridbox espone un endpoint Model Context Protocol (MCP) per i client dell’agente che desiderano individuare e chiamare le pseudo-funzioni Hybridbox tramite il runtime dell’agente A2A. L’endpoint MCP è /mcp. I percorsi di origine registrano POST /mcp per le richieste MCP JSON-RPC. GET /mcp è registrato ma il metodo di restituzione non è consentito, quindi i client devono utilizzare POST per il traffico MCP.

​
Superficie del protocollo

I metodi JSON-RPC supportati includono:
  • initialize
  • ping
  • notifications/initialized
  • tools/list
  • tools/call
Sono necessarie sessioni autenticate per tools/list e tools/call. Gli strumenti visibili e le funzioni richiamabili dipendono dalla sessione autenticata.

​
MCP strumenti

​
hybridbox_functions_list

Elenca le pseudo-funzioni Hybridbox visibili alla sessione autenticata. Lo strumento non accetta argomenti. Utilizzalo prima quando un agente deve capire quali funzioni sono disponibili prima di chiamare qualsiasi cosa.

​
hybridbox_functions_explain

Spiega le pseudo-funzioni visibili Hybridbox con schemi, documentazione ed esempi. Argomenti:
  • function: nome di pseudo-funzione singola opzionale da spiegare.
  • functions: array opzionale di nomi di pseudo-funzioni da spiegare.
Utilizzarlo prima dell’esecuzione in modo che l’agente possa convalidare nomi, argomenti obbligatori, argomenti facoltativi e risultati attesi.

​
hybridbox_execute

Esegue le pseudo-funzioni pubbliche Hybridbox utilizzando codice pseudo-python attraverso lo stesso percorso di autorizzazione e di esecuzione dell’agente A2A. Argomenti:
  • code: stringa richiesta contenente il codice di chiamata della funzione Hybridbox pseudo-python, ad esempio domains.list(account_id='acc_123').
Esegui il codice solo dopo aver controllato lo schema della funzione pertinente e convalidato gli argomenti. Il percorso di esecuzione utilizza il profilo di autorizzazione della sessione autenticata.

​
Flusso di lavoro consigliato

1

Funzioni di elenco

Chiama tools/list, quindi chiama hybridbox_functions_list per verificare le pseudo-funzioni disponibili per la sessione autenticata.
2

Spiegare le funzioni

Richiama hybridbox_functions_explain con function o functions prima dell’esecuzione. Utilizzare lo schema e gli esempi restituiti per preparare argomenti validi.
3

Esegui con argomenti convalidati

Chiama hybridbox_execute con una stringa code solo dopo che il nome della funzione e gli argomenti corrispondono allo schema spiegato.

​
Catalogo delle funzioni

Il catalogo delle funzioni A2A generato è il riferimento per le pseudofunzioni Hybridbox disponibili e le relative firme.

A2A catalogo delle funzioni

Sfoglia le firme delle funzioni generate, le funzionalità e le mappature delle rotte pubbliche API.

Catalogo funzioni grezze JSON

Ispezionare i dati del catalogo hybridbox.a2a.functions.v1 generati.