AgentSkillsCN

cross-manager

管理 Ravi 会话间的消息。适用于用户希望： - 将一条会话的消息发送至另一条会话 - 向其他代理提问 - 在另一个渠道通知用户 - 查看活跃会话

SKILL.md
--- frontmatter
name: cross-manager
description: |
  Gerencia mensagens entre sessões do Ravi. Use quando o usuário quiser:
  - Enviar mensagens de uma sessão para outra
  - Fazer perguntas para outro agent
  - Notificar usuário em outro canal
  - Ver sessões ativas

Cross Manager

Cross-session messaging permite que um agent envie mensagens para outra sessão do Ravi.

Conceitos

  • •Session Key: Identificador único de uma conversa (ex: agent:main:main, agent:main:whatsapp:5511999999999)
  • •Routing: Canal e destino de entrega (ex: whatsapp:5511999999999)
  • •Type: Tipo de mensagem que define como será tratada

Tipos de Mensagem

TypeDescrição
relayRepasse transparente — mensagem chega sem prefixo, como se fosse do usuário
informInformação pro agent avaliar — ele decide se age, responde ou fica em silêncio
executeOrdem direta — execute a tarefa usando tools
askPergunta cross-session atribuída ao sender
answerResposta a uma pergunta anterior

Comandos

Enviar mensagem

bash
ravi cross send <target> <type> "<message>"

Com routing explícito:

bash
ravi cross send <target> <type> "<message>" --channel whatsapp --to 5511999999999

Com atribuição (pra ask/answer):

bash
ravi cross send <target> ask "<pergunta>" "Nome do Sender"

Listar sessões

bash
ravi cross list

Exemplos

Repassar mensagem transparente:

bash
ravi cross send "agent:main:whatsapp:lid:12345" relay "Tarefa concluída!"

Informar agent (ele decide o que fazer):

bash
ravi cross send "agent:main:main" inform "Daemon reiniciou, motivo: atualização"

Fazer pergunta para outro agent:

bash
ravi cross send "agent:sde:main" ask "Como implementar X?" "Usuário"

Ver todas as sessões ativas:

bash
ravi cross list

Session Keys

Formato: agent:<agentId>:<scope>[:<details>]

Exemplos:

  • •agent:main:main - Sessão principal do agent main
  • •agent:main:whatsapp:5511999999999 - DM do WhatsApp
  • •agent:main:whatsapp:group:123456@g.us - Grupo do WhatsApp
  • •agent:main:matrix:!room:server - Sala do Matrix

Routing

A resposta vai pro canal correto baseado em:

  1. •Parâmetros --channel e --to (se fornecidos)
  2. •Último canal/destino da sessão
  3. •Derivado da session key

Se não houver routing, a resposta não é entregue em nenhum canal (fica só no contexto).