Como deve um agente de IA consultar o OneMira?

Pesquise antes de carregar transcrições, peça intervalos relevantes, preserve referências às sessões e delimite consultas MCP para obter resultados fiáveis.

Como ligo um agente à Wiki local?

A aplicação Mira Desktop gere transcrições e conteúdo da Wiki localmente. Reveja as notas extraídas e organize páginas duradouras segundo a estrutura do seu projeto.

Ligar através das ferramentas integradas

Execute mira mcp list, depois utilize mira mcp configure <client-id> para o cliente detetado que pretende ligar. O servidor MCP local lê os mesmos dados indexados do OneMira que a aplicação e a CLI.

Escolher a ligação documentada

Não copie, crie ligações simbólicas ou monte manualmente os ficheiros das sessões nos repositórios dos seus projetos.

Porquê: A Mira CLI mantém um índice local SQLite para pesquisa de texto. Utilize a aplicação ou a CLI para escrever, mantendo os ficheiros Markdown legíveis e o índice coerentes.


Como resumo o estado das sessões em regras do projeto?

As transcrições de conversas contêm muita variabilidade e conteúdo irrelevante. Utilizar sempre as transcrições completas como contexto é pouco eficiente.

Manter um resumo diário útil

Peça ao agente que pesquise primeiro e consulte depois os ficheiros ~/.onemira/context/<session_id>/session.md relevantes. Reveja as decisões e respetivas fontes antes de as escrever no ficheiro AGENTS.md do repositório ou num ficheiro de regras.

Começar por uma pergunta focada

Durante tarefas de programação, evite pedir ao agente que leia todas as notas de reuniões e decida o que fazer a seguir.

Porquê: As regras do projeto revistas são mais curtas e fáceis de auditar do que uma coleção de transcrições. Conserve os IDs das sessões de origem para que o agente possa verificar cada regra.


Como limito as consultas MCP?

Quando utiliza o servidor MCP local para obter contexto durante o desenvolvimento, a precisão da pesquisa depende da clareza do pedido.

Delimitar o período ou o tema

Defina restrições explícitas. Por exemplo: «Utilize o MCP para consultar a reunião de hoje às 14h sobre o orçamento de marketing do terceiro trimestre e indique a decisão final.»

Tornar o pedido específico

Adicione um tema, uma data ou um projeto a um pedido vago, como: «Encontre a reunião em que falámos sobre a base de dados.»

Encontrar a sessão e ler a parte relevante

Peça ao agente para utilizar mira_search ou mira_sessions (listagem) para obter primeiro os metadados e um session_id . Depois, utilize mira_segments com limites explícitos de from_ms / to_ms ou tail para extrair apenas os segmentos relevantes.

Ler as novidades

Durante uma reunião em curso, peça os novos segmentos em vez de voltar a carregar toda a transcrição.

Porquê: Ler apenas os novos segmentos tail através de mira_segments reduz o texto transferido e evita carregar repetidamente a sessão completa. O tempo de resposta efetivo depende do cliente e do modelo.


Como forneço manualmente uma sessão conhecida?

O servidor MCP permite pesquisas autónomas por agentes, mas por vezes basta indicar uma reunião específica ao IDE, como Cursor ou Windsurf, sem escrever um pedido de pesquisa.

Copiar o caminho da sessão

No OneMira Desktop, clique com o botão direito numa sessão e selecione Copy Absolute Path ou Copy Relative Path. Cole o caminho no IDE através de uma menção @ para fazer referência à transcrição escolhida.

Porquê: Copiar uma referência conhecida evita uma pesquisa desnecessária. O agente continua a precisar de ler e interpretar corretamente a fonte selecionada.