TUNC.AI / Exemplos do Tunc Orb

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:

Cola isto no teu agente
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:

Cola isto no teu agente
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:

ClientePassos
claude.ai, Claude Desktop and Claude mobileCustomize → 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:
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Tunc%20Orb&connectorUrl=https%3A%2F%2Fmcp.tuncorb.com%2Fmcp
Claude CodeAdiciona o servidor, depois executa /mcp, escolhe tunc-orb e Authenticate.
claude mcp add --transport http tunc-orb https://mcp.tuncorb.com/mcp
ChatGPTSettings → Apps & Connectors → Advanced → ativa o Developer mode → Create → nome Tunc Orb, URL https://mcp.tuncorb.com/mcp, Authentication OAuth → Create → Connect.
CursorAdiciona-o ao ~/.cursor/mcp.json e depois vai a Settings → MCP: aparece “Needs login” → Login.
{
  "mcpServers": {
    "tunc-orb": {
      "url": "https://mcp.tuncorb.com/mcp"
    }
  }
}
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 CLIAdiciona-o ao settings.json e depois executa /mcp auth tunc-orb.
{
  "mcpServers": {
    "tunc-orb": {
      "httpUrl": "https://mcp.tuncorb.com/mcp"
    }
  }
}
Copilot StudioTools → 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:

Cola isto no teu agente
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:

Cola isto no teu agente
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:

Cola isto no teu agente
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:

Cola isto no teu agente
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:

Cola isto no teu agente
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.

Cola isto no teu agente
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.

Cola isto no teu agente
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.