Vai al contenuto
OmniChannels.ai

Assistenti e agenti IA

LlamaIndex + OmniChannels.ai: strumenti di messaggistica per i vostri agenti

Collegamento tramite MCPCollegamento tramite API e webhookAggiornato

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.

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

Collegamento tramite MCPCollegamento tramite API e webhook

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. 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. 2

    Ottenete una chiave temporanea

    Nel portale di amministrazione aprite Integrations, poi MCP Integration, scegliete Get temporary key e impostatela come BROADNET_TOKEN.

    Guida: MCP server for AI agents
  3. 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. 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: MCP server for AI agents
  5. 5

    Restringete e controllate

    Passate all'agente solo gli strumenti necessari e richiedete conferma prima di ogni strumento che invia.

  6. 6

    Testate sul vostro numero

    Eseguite l'agente sul vostro numero verificato e controllate il rapporto di consegna prima di ampliare l'accesso.

Documentazione del fornitore

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.

Flusso di lavoro di esempio

Come una richiesta tipica passa da LlamaIndex al vostro cliente e ritorna.

  1. 01

    Il vostro agente LlamaIndex

    Agente o workflow con strumenti da McpToolSpec

  2. 02

    Server MCP OmniChannels.ai

    Strumenti di invio, template e rapporti di consegna

  3. 03

    Telefono del cliente

    Messaggio SMS, WhatsApp o RCS consegnato

  4. 04

    Rapporto di consegna

    Riletto dall'agente o inviato al vostro webhook

1. Il vostro agente LlamaIndex: Agente o workflow con strumenti da McpToolSpec 2. Server MCP OmniChannels.ai: Strumenti di invio, template e rapporti di consegna 3. Telefono del cliente: Messaggio SMS, WhatsApp o RCS consegnato 4. 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.

Richiedi l’accesso a API e MCP

Indicateci canali, Paesi e caso d’uso. Un tecnico emette le credenziali di test e verifica i vostri numeri di prova.