AgentSkillsCN

routes-manager

管理 Ravi 的消息路由。适用于用户希望： - 创建、列出或删除路由 - 将联系人/群组定向至特定代理 - 配置路由优先级 - 查看哪个代理负责处理哪种模式

SKILL.md
--- frontmatter
name: routes-manager
description: |
  Gerencia rotas de mensagens do Ravi. Use quando o usuário quiser:
  - Criar, listar ou remover rotas
  - Direcionar contatos/grupos para agents específicos
  - Configurar prioridade de rotas
  - Ver qual agent atende qual padrão

Routes Manager

Rotas direcionam mensagens para agents baseado em padrões. Um contato ou grupo pode ser roteado para um agent específico.

Comandos

Listar rotas

bash
ravi routes list

Ver detalhes

bash
ravi routes show <pattern>

Adicionar rota

bash
ravi routes add <pattern> <agent>

Exemplos de padrões:

  • •5511* - Todos com DDD 11
  • •*999* - Números contendo 999
  • •group:123456 - Grupo específico do WhatsApp
  • •* - Catch-all (fallback)

Remover rota

bash
ravi routes remove <pattern>

Configurar propriedades

bash
ravi routes set <pattern> <key> <value>

Keys:

  • •priority - Prioridade (maior = mais prioritário)
  • •dmScope - Escopo de DM (main, per-peer, etc)

Prioridade de Resolução

  1. •Contato com agent atribuído diretamente
  2. •Rota que casa com o padrão (por prioridade)
  3. •AccountId = AgentId
  4. •Agent default

Exemplos

Rotear grupo para agent especializado:

bash
ravi routes add "group:120363123456789@g.us" projeto-x

Rotear todos de SP para agent:

bash
ravi routes add "5511*" vendas

Definir fallback:

bash
ravi routes add "*" main

Relação com Contacts

Routes e Contacts trabalham juntos no roteamento:

  • •Contacts podem ter agent_id atribuído diretamente (via ravi contacts set <phone> agent <agent> ou ravi contacts approve <phone> <agent>)
  • •Routes definem regras por padrão (prefixo, grupo, catch-all)
  • •Na resolução, contact.agent_id tem prioridade sobre routes
  • •ravi routes list mostra o nome e status do contato associado a cada padrão
  • •Para gerenciar contatos: use a skill ravi-system:contacts