O que matrix-skill faz?
Habilidade de agente para comunicação via chat Matrix. Envia mensagens para salas Matrix em nome de usuários por meio de autenticação com token de acesso. Funciona com qualquer servidor doméstico Matrix.
Visão Geral
Esta habilidade permite que seu agente de IA envie mensagens para qualquer sala Matrix usando um token de acesso. É ideal para notificações, integração com ferramentas de desenvolvimento e automação de chat.
Configuração
Antes de usar, defina as seguintes variáveis de ambiente:
| Variável | Descrição |
|---|---|
MATRIX_ACCESS_TOKEN | Token de acesso para autenticação no Matrix |
MATRIX_HOMESERVER | URL do servidor doméstico Matrix (ex: https://matrix.org) |
MATRIX_ROOM_ID | ID da sala Matrix de destino (ex: !roomid:matrix.org) |
Uso
# Exemplo: Enviar mensagem para uma sala Matrix
matrix_send_message("Olá, mundo! Esta é uma mensagem do meu agente.")
Ações disponíveis
matrix_send_message: Envia uma mensagem de texto para a sala configurada.
Funcionamento
A habilidade usa a API de cliente Matrix (especificamente o endpoint POST /_matrix/client/v3/rooms/{roomId}/send/m.room.message) para enviar mensagens. O token de acesso é passado como cabeçalho Authorization: Bearer, garantindo autenticação segura sem expor credenciais.
Compatibilidade
Funciona com qualquer servidor doméstico Matrix (matrix.org, servidores auto-hospedados, etc.) e com qualquer linguagem/plataforma que suporte chamadas HTTP.
Exemplo de uso com ambiente
export MATRIX_ACCESS_TOKEN="s3cr3t_t0k3n"
export MATRIX_HOMESERVER="https://matrix.example.com"
export MATRIX_ROOM_ID="!abc123:matrix.example.com"
# O agente usará estas variáveis para enviar mensagens
Para mais informações, consulte a documentação da API Matrix.