--- title: "LlamaIndex + OmniChannels.ai: strumenti di messaggistica per i vostri agenti" description: "Collegate gli agenti LlamaIndex al server MCP di OmniChannels.ai con llama-index-tools-mcp, o con strumenti REST, per inviare WhatsApp e SMS e leggere i report." canonical: "https://omnichannels.ai/it/integrations/llamaindex/" language: "it" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # LlamaIndex + OmniChannels.ai: strumenti di messaggistica per i vostri agenti Canonical: https://omnichannels.ai/it/integrations/llamaindex/ Language: it Publisher: OmniChannels.ai by BroadNet Technologies **In breve:** Gli agenti LlamaIndex usano OmniChannels.ai tramite il nostro server MCP remoto. Con llama-index-tools-mcp, un BasicMCPClient puntato su https://mcp.broadnet.me/mcp e incapsulato in McpToolSpec trasforma i nostri strumenti di invio, template e rapporti di consegna in strumenti per l'agente. Il nostro server richiede un'intestazione Authorization: Bearer: consultate la documentazione del pacchetto per capire come la imposta la vostra versione, oppure chiamate la nostra API REST dai vostri strumenti. Collegamento tramite MCP · Collegamento tramite API e webhook ## Cosa potete fare ### Agente di assistenza alle consegne con soli strumenti di lettura Mantenete solo gli strumenti di lettura, così l'agente risponde alle domande sulle consegne senza poter inviare. > Provate a chiedere: "Crea un agente che risponda alle domande sulle consegne usando solo strumenti di lettura e rifiuti qualsiasi richiesta di inviare un messaggio." ### Rispondete dai vostri documenti, agite tramite strumenti Combinate un query engine sulle vostre policy con i nostri strumenti di messaggistica, così le risposte seguono le vostre regole prima di qualsiasi invio. > Provate a chiedere: "Crea un agente che consulti l'indice della nostra policy sui rimborsi, prepari una risposta WhatsApp in inglese e in arabo e mi chieda conferma prima di inviarla a 971500000000." ### Workflow attento ai template L'agente elenca i template WhatsApp approvati e compila le variabili per i messaggi avviati dall'azienda fuori dalla finestra di 24 ore. > Provate a chiedere: "Scrivi un workflow che trovi il template approvato appointment_reminder e lo invii a 966500000000 con la fascia oraria di domani, dopo la mia approvazione." ### Strumenti REST mirati Incapsulate una singola operazione REST in un FunctionTool quando volete il pieno controllo su campi, validazione e log. > Provate a chiedere: "Scrivi un FunctionTool di LlamaIndex che invii un SMS con POST /sms/sendSms e legga BROADNET_TOKEN dall'ambiente." ### Analisi dei fallimenti L'agente legge i rapporti di consegna e raggruppa i fallimenti per motivo per il vostro team operativo. > Provate a chiedere: "Crea un agente che legga i rapporti di consegna di ieri e riassuma i messaggi FAILED e REJECTED per motivo e canale." ## Come si collega llama-index-tools-mcp fornisce BasicMCPClient, che si collega a un server MCP remoto tramite URL, e McpToolSpec, che trasforma gli strumenti di quel server in un elenco di strumenti per un agente LlamaIndex. Puntate il client su https://mcp.broadnet.me/mcp, un endpoint Streamable HTTP. Ogni richiesta al nostro server deve portare un'intestazione Authorization: Bearer; il modo in cui la impostate, ad esempio con un client HTTP personalizzato, dipende dalla versione del pacchetto: consultate la sua documentazione. Filtrate l'elenco degli strumenti in modo che ogni agente abbia solo quelli necessari e aggiungete un passaggio di conferma prima di qualsiasi invio. Se l'opzione per le intestazioni nella vostra versione non è adatta, scrivete wrapper FunctionTool vostri attorno alla nostra API REST con un token Bearer, usando la specifica OpenAPI 3.1 per i campi esatti; l'SMS singolo usa JSON, mentre gli invii massivi e la maggior parte degli altri canali usano multipart/form-data. - MCP: BasicMCPClient su https://mcp.broadnet.me/mcp, incapsulato in McpToolSpec - Intestazione Authorization: Bearer obbligatoria in ogni richiesta - Filtrate gli strumenti per nome e chiedete conferma prima di qualsiasi invio - Alternativa REST: wrapper FunctionTool costruiti dalla specifica OpenAPI 3.1 ## Configurazione 1. **Richiedete l'accesso API:** Richiedete l'accesso di prova e ricevete un token API. Gli invii di prova arrivano solo ai vostri numeri verificati. 2. **Ottenete una chiave temporanea:** Nel portale di amministrazione aprite Integrations, poi MCP Integration, scegliete Get temporary key e impostatela come BROADNET_TOKEN. (Guida: https://omnichannels.ai/developers/mcp/) 3. **Installate llama-index-tools-mcp:** Installate il pacchetto e consultate la sua documentazione per sapere come la vostra versione passa intestazioni personalizzate a un server remoto. 4. **Caricate gli strumenti:** Create un BasicMCPClient per il nostro URL con l'intestazione Authorization, incapsulatelo in McpToolSpec e ottenete l'elenco degli strumenti. (Guida: https://omnichannels.ai/developers/mcp/) 5. **Restringete e controllate:** Passate all'agente solo gli strumenti necessari e richiedete conferma prima di ogni strumento che invia. 6. **Testate sul vostro numero:** Eseguite l'agente sul vostro numero verificato e controllate il rapporto di consegna prima di ampliare l'accesso. ## Flusso di lavoro di esempio Il vostro agente LlamaIndex (Agente o workflow con strumenti da McpToolSpec) → Server MCP OmniChannels.ai (Strumenti di invio, template e rapporti di consegna) → Telefono del cliente (Messaggio SMS, WhatsApp o RCS consegnato) → Rapporto di consegna (Riletto dall'agente o inviato al vostro webhook) ## Domande ### Esiste un'integrazione ufficiale OmniChannels.ai per LlamaIndex? No. LlamaIndex si collega tramite il suo pacchetto generico di strumenti MCP, usando il nostro endpoint pubblico e il vostro token API, oppure tramite strumenti che scrivete sulla nostra API REST. ### Come passo il token API? Il nostro server richiede un'intestazione Authorization: Bearer in ogni richiesta. Il modo in cui llama-index-tools-mcp imposta intestazioni personalizzate dipende dalla sua versione, quindi seguite la documentazione aggiornata. Se non si adatta alla vostra configurazione, chiamate invece l'API REST dai vostri strumenti. ### L'agente può leggere i miei documenti o il mio CRM tramite questo server? No. Il nostro server copre solo messaggistica, template e rapporti di consegna. I vostri documenti arrivano dai vostri indici LlamaIndex e gli altri sistemi tramite i rispettivi strumenti o server MCP. ### Come evito che l'agente invii per errore? Dategli solo gli strumenti necessari, escludete gli strumenti di invio per gli agenti che si limitano a rispondere a domande e fate confermare ogni invio a una persona. Usate una chiave temporanea e numeri vostri durante i test. ## Guide per sviluppatori - https://omnichannels.ai/developers/mcp/ - https://omnichannels.ai/developers/openapi/ - https://omnichannels.ai/developers/authentication/ - https://omnichannels.ai/developers/webhooks/ ## Documentazione del fornitore - [llama-index-tools-mcp on GitHub](https://github.com/run-llama/llama_index/tree/main/llama-index-integrations/tools/llama-index-tools-mcp) - [Model Context Protocol — introduction](https://modelcontextprotocol.io/introduction) ## Integrazioni correlate - https://omnichannels.ai/it/integrations/langchain/ - https://omnichannels.ai/it/integrations/claude-code/ - https://omnichannels.ai/it/integrations/vs-code/ - https://omnichannels.ai/it/integrations/n8n/ LlamaIndex è un marchio del rispettivo proprietario. OmniChannels.ai non è affiliata a LlamaIndex né da essa approvata; questa pagina descrive un collegamento realizzato con le funzioni MCP, HTTP o webhook di LlamaIndex. Aggiornato: 2026-10-10