Em resumo
Os agentes LlamaIndex usam a OmniChannels.ai pelo nosso servidor MCP remoto. Com llama-index-tools-mcp, um BasicMCPClient apontado para https://mcp.broadnet.me/mcp e encapsulado em McpToolSpec transforma as nossas ferramentas de envio, modelos e relatórios de entrega em ferramentas do agente. O nosso servidor exige um cabeçalho Authorization: Bearer, então consulte a documentação do pacote para saber como a sua versão o define, ou chame a nossa REST API com ferramentas próprias.
O que você pode fazer
Agente de suporte de entregas só com leitura
Mantenha apenas as ferramentas de leitura para que o agente responda dúvidas sobre entregas sem poder enviar.
Experimente pedir
“Crie um agente que responda dúvidas sobre entregas usando apenas ferramentas de leitura e recuse qualquer pedido de envio de mensagem.”
Responder com seus documentos, agir com ferramentas
Combine um query engine sobre as suas próprias políticas com as nossas ferramentas de mensagens, para que as respostas sigam as suas regras antes de qualquer envio.
Experimente pedir
“Crie um agente que consulte o índice da nossa política de reembolso, redija uma resposta de WhatsApp em árabe e inglês e me pergunte antes de enviá-la para 971500000000.”
Workflow que respeita os modelos
O agente lista os modelos aprovados do WhatsApp e preenche as variáveis para mensagens iniciadas pela empresa fora da janela de 24 horas.
Experimente pedir
“Escreva um workflow que encontre o modelo aprovado appointment_reminder e o envie para 966500000000 com o horário de amanhã, após a minha aprovação.”
Ferramentas REST específicas
Encapsule uma única operação REST em uma FunctionTool quando quiser controle total sobre campos, validação e logs.
Experimente pedir
“Escreva uma FunctionTool do LlamaIndex que envie um SMS com POST /sms/sendSms e leia BROADNET_TOKEN do ambiente.”
Análise de falhas
O agente lê os relatórios de entrega e agrupa as falhas por motivo para a sua equipe de operações.
Experimente pedir
“Crie um agente que leia os relatórios de entrega de ontem e resuma as mensagens FAILED e REJECTED por motivo e canal.”
Como a conexão funciona
O llama-index-tools-mcp oferece o BasicMCPClient, que se conecta a um servidor MCP remoto pela URL, e o McpToolSpec, que transforma as ferramentas desse servidor em uma lista de ferramentas para um agente LlamaIndex. Aponte o cliente para https://mcp.broadnet.me/mcp, um endpoint Streamable HTTP. Toda requisição ao nosso servidor precisa levar um cabeçalho Authorization: Bearer; a forma de defini-lo, por exemplo com um cliente HTTP personalizado, depende da versão do pacote, então consulte a documentação dele.
Filtre a lista de ferramentas para que cada agente tenha apenas as de que precisa, e adicione uma etapa de confirmação antes de qualquer envio. Se a opção de cabeçalho da sua versão não servir, escreva wrappers FunctionTool próprios para a nossa REST API com um token Bearer, usando a especificação OpenAPI 3.1 para os campos exatos; o SMS único usa JSON, e os envios em massa e a maioria dos outros canais usam multipart/form-data.
- MCP: BasicMCPClient em https://mcp.broadnet.me/mcp, encapsulado em McpToolSpec
- Cabeçalho Authorization: Bearer obrigatório em toda requisição
- Filtre as ferramentas por nome e confirme antes de qualquer envio
- Alternativa REST: wrappers FunctionTool criados a partir da especificação OpenAPI 3.1
Configuração
- 1
Solicite acesso à API
Solicite acesso de teste e receba um token de API. Os envios de teste só vão para os seus próprios números verificados.
- 2
Obtenha uma chave temporária
No portal de administração, abra Integrations e depois MCP Integration, escolha Get temporary key e defina-a como BROADNET_TOKEN.
Guia: MCP server for AI agents - 3
Instale o llama-index-tools-mcp
Instale o pacote e consulte a documentação dele para saber como a sua versão passa cabeçalhos personalizados a um servidor remoto.
- 4
Carregue as ferramentas
Crie um BasicMCPClient para a nossa URL com o cabeçalho Authorization, encapsule-o em McpToolSpec e obtenha a lista de ferramentas.
Guia: MCP server for AI agents - 5
Restrinja e controle
Passe ao agente apenas as ferramentas de que ele precisa e exija confirmação antes de qualquer ferramenta que envia.
- 6
Teste no seu próprio número
Rode o agente com o seu número verificado e confira o relatório de entrega antes de ampliar o acesso.
Documentação do fornecedor
LlamaIndex é uma marca de seu proprietário. A OmniChannels.ai não é afiliada nem endossada por LlamaIndex; esta página descreve uma conexão feita com os recursos de MCP, HTTP ou webhook do próprio LlamaIndex.
