Waze Navigation Skill
O que faz
Gera links de navegação do Waze que, ao serem tocados no celular, abrem o app
diretamente com a rota pronta. Funciona via deep links públicos do Waze — sem
necessidade de API key.
Formato do link
CODEBLOCK0
O endereço deve estar URL-encoded. Use Python quando disponível:
CODEBLOCK1
Fluxo de uso
Passo 1 — Descobrir a localização do usuário
Antes de qualquer coisa, descubra em qual cidade o usuário está. Procure em:
- -
USER.md no workspace ativo - INLINECODE1 ou qualquer arquivo de perfil do workspace
Se não encontrar, pergunte. A cidade é essencial para buscar estabelecimentos
próximos — nunca assuma uma localização genérica ou use a primeira cidade que
aparecer num resultado de busca.
Passo 2 — Classificar o destino
Destino específico (endereço completo, CEP, coordenadas):
→ Pule direto para o Passo 4.
Destino vago (nome de empresa, categoria, "o mais próximo"):
→ Siga para o Passo 3 primeiro.
Passo 3 — Buscar o local mais próximo (destinos vagos)
Use Tavily para buscar: INLINECODE2
Extraia o endereço completo do resultado (rua, número, bairro, cidade, estado).
Se houver mais de uma opção, escolha a geograficamente mais próxima do usuário,
ou apresente as opções para ele escolher.
Exemplo: usuário em Vitória/ES pede "Leroy Merlin" →
busca "Leroy Merlin" Vitória ES →
endereço encontrado: "Av. Fernando Ferrari, 2600, Goiabeiras, Vitória, ES" →
segue para o Passo 4.
Passo 4 — Gerar o link
URL-encode o endereço e monte o link. Sempre inclua o estado e país no endereço
para evitar ambiguidade (cidades com nomes comuns podem existir em outros países).
Passo 5 — Apresentar o link
Sempre use o formato markdown [texto](url) para o link — nunca exponha a URL crua.
Isso faz o link aparecer como texto clicável no Telegram, muito mais limpo para o usuário.
Em conversa normal:
CODEBLOCK2
No briefing matinal (quando o evento tem um local):
CODEBLOCK3
O resultado no Telegram é um link azul clicável com o texto "Abrir no Waze" — sem URL visível.
Integração com Briefing Matinal
Quando estiver gerando um briefing e um evento da agenda tiver um campo de
localização preenchido, inclua o link do Waze automaticamente logo abaixo do
evento — sem precisar ser solicitado pelo usuário. Isso é especialmente útil
para quem consulta o briefing no celular antes de sair de casa.
Se o local do evento for o nome de um estabelecimento (não um endereço completo),
aplique o Passo 3 para descobrir o endereço real antes de gerar o link.
Observações
- - O link funciona em qualquer dispositivo com Waze instalado. Sem o app, abre
o Waze no navegador.
- - Sempre inclua estado e país no endereço para evitar ambiguidade.
- Vitória, ES, Brasil ≠ Victoria, Austrália ≠ Victoria, Canadá — seja específico.
- Se o usuário pedir "posto mais próximo" ou similar sem fornecer contexto de
rota, use a cidade base do perfil dele como ponto de partida da busca.
Waze 导航技能
功能说明
生成Waze导航链接，在手机上点击后可直接打开应用并显示规划好的路线。通过Waze公开的深度链接实现，无需API密钥。
链接格式
https://waze.com/ul?q=编码后的地址&navigate=yes
地址需进行URL编码。使用Python时示例：
python
from urllib.parse import quote
address = Av. Jerônimo Monteiro, 1000, Vitória, ES, Brasil
link = fhttps://waze.com/ul?q={quote(address)}&navigate=yes
print(link)
使用流程
步骤1 — 确定用户位置
首先，确认用户所在城市。查找位置：
- - 当前工作区中的USER.md文件
- SOUL.md或工作区中的任何配置文件
如果找不到，请直接询问。城市信息对于查找附近地点至关重要——切勿假设一个通用位置，或使用搜索结果中出现的第一个城市。
步骤2 — 分类目的地
明确目的地（完整地址、邮政编码、坐标）：
→ 直接跳至步骤4。
模糊目的地（公司名称、类别、最近的）：
→ 先执行步骤3。
步骤3 — 查找最近地点（模糊目的地）
使用Tavily搜索：地点名称 + 城市 + 州
从结果中提取完整地址（街道、门牌号、街区、城市、州）。
如果有多个选项，选择地理位置上离用户最近的一个，或提供选项供用户选择。
示例：用户在维多利亚/圣埃斯皮里图州询问Leroy Merlin →
搜索Leroy Merlin 维多利亚 圣埃斯皮里图州 →
找到地址：Av. Fernando Ferrari, 2600, Goiabeiras, Vitória, ES →
进入步骤4。
步骤4 — 生成链接
对地址进行URL编码并构建链接。地址中始终包含州和国家，以避免歧义（同名城市可能存在于不同国家）。
步骤5 — 展示链接
始终使用markdown格式文本展示链接——切勿暴露原始URL。这样在Telegram中链接会显示为可点击的文本，对用户更加整洁。
常规对话中：
📍 Leroy Merlin — Av. Fernando Ferrari, 2600, Goiabeiras, Vitória, ES
🗺️ 在Waze中打开
晨间简报中（当活动有地点时）：
📅 今日日程
09:00 — 供应商会议
📍 Leroy Merlin — Av. Fernando Ferrari, 2600, Vitória, ES
🗺️ 在Waze中打开
在Telegram中的效果是一个蓝色可点击链接，显示文本在Waze中打开——不显示可见URL。
与晨间简报的集成
当生成简报且日程事件中包含位置字段时，自动在该事件下方包含Waze链接——无需用户请求。这对于在出门前在手机上查看简报的用户特别有用。
如果事件地点是场所名称（而非完整地址），请先应用步骤3查找真实地址，然后再生成链接。
注意事项
- - 该链接适用于任何安装了Waze的设备。如果没有安装应用，会在浏览器中打开Waze。
- 地址中始终包含州和国家，以避免歧义。
- 巴西圣埃斯皮里图州维多利亚市 ≠ 澳大利亚维多利亚州 ≠ 加拿大维多利亚市——请具体明确。
- 如果用户询问最近的加油站或类似内容，且未提供路线上下文，则使用其个人资料中的基础城市作为搜索起点。
