Exemplos do Tunc Orb e prompts de configuração para agentes
Três configurações prontas para o Tunc Orb, cada uma com um prompt que o teu agente segue: memória de projeto partilhada, um trabalho que regista num log e o estado dos itens processados.
Atualizado em
Cada configuração abaixo começa com um prompt que colas no teu agente, para que seja o agente a fazer o trabalho. Mantém as chaves de API fora dos prompts: entrega-as às tuas ferramentas como variáveis de ambiente ou segredos. A documentação do Tunc Orb tem todas as chamadas; esta página tem configurações que funcionam.
Deixa o teu agente ligar-se ao Tunc Orb
No Claude, o caminho mais rápido é uma ligação pré-preenchida. Abre Add custom connector com o nome e o URL já preenchidos; verifica e confirma.
Adicionar o Tunc Orb ao ClaudeO plano Free do Claude permite um conector personalizado. Nos planos Team e Enterprise, é um Owner que o adiciona.
No Claude Code, no Cursor ou em qualquer agente que consiga executar comandos ou alterar as suas próprias definições, cola isto. Ele adiciona a ligação, espera enquanto inicias sessão e depois testa-a:
Liga o Tunc Orb a esta sessão. O servidor MCP dele é https://mcp.tuncorb.com/mcp. Se conseguires executar comandos, executa: claude mcp add --transport http tunc-orb https://mcp.tuncorb.com/mcp. Caso contrário, adiciona-o às minhas definições de MCP. Depois diz-me para iniciar sessão (no Claude Code: executa /mcp, escolhe tunc-orb e depois Authenticate) e espera que eu confirme. Em seguida, testa: guarda um registo chamado test/hello com a descrição “teste de ligação” e o texto “está a funcionar”, volta a lê-lo e depois elimina-o. Diz-me o que fizeste e o que foi devolvido.No ChatGPT, ou em qualquer aplicação em que adicionas conectores através dos menus, pede ao agente que leia as instruções e te guie por elas:
Lê https://tuncorb.com/llms.txt e diz-me, menu a menu, como ligar o Tunc Orb a esta aplicação. Usa a opção de início de sessão, não uma chave de API. Se esta aplicação precisar de um modo especial para adicionar conectores, diz-me qual.Um agente consegue adicionar a ligação, mas não consegue iniciar sessão por ti: autorizas uma vez no teu navegador e escolhes o que ele pode fazer. Os mesmos passos para cada cliente, se preferires fazê-lo à mão:
| Cliente | Passos |
|---|---|
| claude.ai, Claude Desktop and Claude mobile | Customize → Connectors → Add custom connector → nome Tunc Orb, URL https://mcp.tuncorb.com/mcp → Add → Connect. O plano Free permite um conector personalizado; nos planos Team e Enterprise, é um Owner que o adiciona em Organization settings → Connectors. Esta ligação abre a caixa de diálogo com o nome e o URL já preenchidos: |
| Claude Code | Adiciona o servidor, depois executa /mcp, escolhe tunc-orb e Authenticate. |
| ChatGPT | Settings → Apps & Connectors → Advanced → ativa o Developer mode → Create → nome Tunc Orb, URL https://mcp.tuncorb.com/mcp, Authentication OAuth → Create → Connect. |
| Cursor | Adiciona-o ao ~/.cursor/mcp.json e depois vai a Settings → MCP: aparece “Needs login” → Login. |
| VS Code (Copilot) | Paleta de Comandos → MCP: Add Server → HTTP → https://mcp.tuncorb.com/mcp → nome tunc-orb → aceita o pedido de início de sessão. |
| Gemini CLI | Adiciona-o ao settings.json e depois executa /mcp auth tunc-orb. |
| Copilot Studio | Tools → Add a tool → New tool → Model Context Protocol → em URL, indica https://mcp.tuncorb.com/mcp → em Authentication, escolhe OAuth 2.0, Dynamic discovery. |
Partilha um resumo de projeto entre o Claude, o Cursor e o ChatGPT
O problema: trabalhas num projeto em vários assistentes e estás sempre a colar o mesmo contexto em cada um. A configuração: um registo guarda o resumo e um log guarda as decisões. Todos os assistentes ligados ao teu Tunc Orb conseguem ler os dois.
Configura uma vez. Cola isto no assistente que conhece melhor o projeto, com o nome do teu projeto:
Configura a memória do projeto “Redesign do site da Acme” no Tunc Orb. Pergunta o que não souberes. Guarda um registo chamado projects/acme-redesign/brief com o objetivo, para quem é, o estado atual, as perguntas em aberto e onde estão os ficheiros, e dá-lhe a descrição de uma linha “Redesign da Acme: resumo e estado”. Mantém-no com menos de 300 palavras e deixa de fora o histórico de decisões. Depois, cria um log chamado projects/acme-redesign/decisions, com a descrição “Redesign da Acme: decisões e motivos”, adicionando cada decisão tomada até agora como uma entrada com a data e o motivo. Mostra-me os dois nomes quando terminares.Retoma noutro assistente, ou num novo chat:
Lê no Tunc Orb projects/acme-redesign/brief e as cinco entradas mais recentes de projects/acme-redesign/decisions, e diz-me onde ficámos antes de começar.No fim de uma sessão de trabalho:
Atualiza projects/acme-redesign/brief com o novo estado e as perguntas em aberto, e adiciona uma entrada a projects/acme-redesign/decisions por cada escolha que fizemos hoje, com o motivo. Mantém o resumo com menos de 300 palavras.O Tunc Orb verifica a revisão antes de alterar um registo, por isso dois assistentes não se conseguem substituir um ao outro em silêncio: o segundo volta a ler e tenta outra vez. Para que um assistente consulte sem que lho peças, adiciona uma linha às suas instruções permanentes (instruções do projeto no Claude, CLAUDE.md ou regras do Cursor): “No início de uma sessão sobre o redesign da Acme, lê no Tunc Orb projects/acme-redesign/brief.”
Regista o resultado de um trabalho agendado num log que os teus assistentes conseguem ler
O problema: uma verificação semanal, uma importação noturna ou um fluxo do n8n produz um resultado que ninguém lê até alguma coisa avariar. A configuração: o trabalho acrescenta uma entrada a um log, e perguntas a qualquer assistente o que disseram as últimas execuções. O Tunc Orb guarda as entradas; não acorda um agente nem envia mensagens.
Cria em https://tunchub.com/account/keys/new?product=orb uma chave de API só com o acesso de que o trabalho precisa (ler e guardar no Tunc Orb) e entrega-a ao trabalho como variável de ambiente ou segredo. Depois cola isto no teu agente de programação:
Escreve um script, report.py, que execute a minha verificação semanal de tráfego e depois acrescente uma entrada ao log runs/weekly-traffic do Tunc Orb através da REST API em https://api.tuncorb.com/v1/write (operação append). Cada entrada: a data, ok ou failed, os números principais e uma ligação, se houver. A primeira entrada cria o log; dá-lhe a descrição “Resultados da verificação semanal de tráfego”. Lê a chave de API da variável de ambiente TUNC_API_KEY e nunca a imprimas. Envia um novo mutation_id para cada entrada e reutiliza o mesmo se tentares de novo. Usa https://tuncorb.com/docs para o formato dos pedidos.Depois, em qualquer assistente ligado:
Lê as cinco entradas mais recentes do log runs/weekly-traffic do Tunc Orb (uma entrada por execução: data, ok ou failed, números principais). Alguma execução falhou, e os números variaram mais de 10% em relação à execução anterior?Trata cada item uma única vez, mesmo com vários agentes
O problema: um agente faz a triagem de tickets, e-mails ou leads, e não podes tratar nenhum duas vezes nem perder o ponto em que paraste quando o chat termina. A configuração: um registo guarda os ids já tratados. Cada agente lê-o primeiro, salta o que está na lista e adiciona ids com um patch que indica a revisão que leu. Se outro agente tiver alterado o registo entretanto, a alteração é recusada com revision_conflict e o agente volta a ler.
Fazes a triagem de novos tickets de suporte com as ferramentas de helpdesk que tiveres. Primeiro, lê o registo triage/support/processed do Tunc Orb; se não existir, cria-o com a descrição de uma linha “Ids de tickets já tratados” e o valor {"ids": []}. Salta todos os tickets cujo id esteja nessa lista. Depois de responderes a um ticket ou de o fechares, adiciona o seu id com um patch (add /ids/-) na revisão que leste. Se o Tunc Orb responder revision_conflict, lê o registo de novo, vê se o id já está na lista e adiciona-o só se não estiver. Nunca elimines o registo. No fim, diz-me quantos tickets trataste e quantos saltaste.O mesmo padrão serve para uma caixa de entrada, uma lista de leads, uma pasta de ficheiros para converter ou uma fila de páginas para verificar. Como o estado fica no Tunc Orb e não num chat, uma nova sessão ou outro assistente continua a partir da mesma lista. O registo é lido por inteiro de cada vez, por isso, para uma fila movimentada, começa um novo todos os meses, por exemplo triage/support/processed-2026-10.
Guarda o id de um ficheiro junto das tuas notas
O Tunc Art guarda os ficheiros que os teus assistentes criam. Guarda o artifact_id de um ficheiro num registo do Tunc Orb e qualquer assistente consegue abrir o ficheiro mais tarde: o id abre-o, enquanto a ligação é só para pessoas. Isto exige que ambos estejam ligados.
Guarda este relatório no Tunc Art como 2026-10-weekly-report.pdf. Depois atualiza o registo reports/latest do Tunc Orb com o artifact_id do ficheiro, o nome, quando expira e a data de hoje, e dá-me a ligação.Convém saber
- Os registos e logs ficam até os eliminares. Um registo comporta até 16 MiB, e uma chamada envia no máximo 64 KiB, por isso um registo longo cresce através de patches.
- Os nomes e as descrições de uma linha são armazenados sem encriptação para que os agentes encontrem os registos. Não coloques segredos neles.
- Uma conta gratuita tem uma prateleira, partilhada por todos os teus agentes ligados, e cada agente consegue ler todos os registos dela.
- Trabalhas para vários clientes? Cada agente ligado a uma conta Tunc consegue ler todas as prateleiras dela, e uma conta tem uma organização. Usa uma conta Tunc por cliente e liga os agentes de cada cliente à conta desse cliente.
