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 seu agente segue: memória de projeto compartilhada, um trabalho que registra em um log e o estado dos itens processados.

Atualizado em

Cada configuração abaixo começa com um prompt que você cola no seu agente, para que o agente faça o trabalho. Mantenha as chaves de API fora dos prompts: entregue-as às suas 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.

Deixe seu agente se conectar ao Tunc Orb

No Claude, o jeito mais rápido é um link pré-preenchido. Ele abre Add custom connector com o nome e a URL já preenchidos; confira e confirme.

Adicionar o Tunc Orb ao ClaudeO plano Free do Claude permite um conector personalizado. Nos planos Team e Enterprise, quem adiciona é um Owner.

No Claude Code, no Cursor ou em qualquer agente que consiga executar comandos ou alterar as próprias configurações, cole isto. Ele adiciona a conexão, espera enquanto você entra na conta e depois testa:

Cole isto no seu agente
Conecte o Tunc Orb a esta sessão. O servidor MCP dele é https://mcp.tuncorb.com/mcp. Se você consegue executar comandos, execute: claude mcp add --transport http tunc-orb https://mcp.tuncorb.com/mcp. Caso contrário, adicione-o às minhas configurações de MCP. Depois me diga para entrar na conta (no Claude Code: execute /mcp, escolha tunc-orb e depois Authenticate) e espere eu confirmar. Em seguida, teste: salve um registro chamado test/hello com a descrição “teste de conexão” e o texto “está funcionando”, leia-o de volta e depois exclua-o. Diga o que você fez e o que voltou.

No ChatGPT, ou em qualquer app em que você adiciona conectores pelos menus, peça ao agente para ler as instruções e guiar você por elas:

Cole isto no seu agente
Leia https://tuncorb.com/llms.txt e me diga, menu por menu, como conectar o Tunc Orb a este app. Use a opção de login, não uma chave de API. Se este app precisar de um modo especial para adicionar conectores, diga qual.

Um agente consegue adicionar a conexão, mas não consegue entrar na conta por você: você autoriza uma vez no seu navegador e escolhe o que ele pode fazer. Os mesmos passos para cada cliente, se preferir fazer à 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 o adiciona em Organization settings → Connectors. Este link abre a caixa de diálogo com o nome e a URL já preenchidos:
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Tunc%20Orb&connectorUrl=https%3A%2F%2Fmcp.tuncorb.com%2Fmcp
Claude CodeAdicione o servidor, depois execute /mcp, escolha tunc-orb e Authenticate.
claude mcp add --transport http tunc-orb https://mcp.tuncorb.com/mcp
ChatGPTSettings → Apps & Connectors → Advanced → ative o Developer mode → Create → nome Tunc Orb, URL https://mcp.tuncorb.com/mcp, Authentication OAuth → Create → Connect.
CursorAdicione-o ao ~/.cursor/mcp.json e depois vá em 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 → permita o pedido de login.
Gemini CLIAdicione-o ao settings.json e depois execute /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, informe https://mcp.tuncorb.com/mcp → em Authentication, escolha OAuth 2.0, Dynamic discovery.

Compartilhe um resumo de projeto entre o Claude, o Cursor e o ChatGPT

O problema: você trabalha em um projeto em vários assistentes e fica colando o mesmo contexto em cada um. A configuração: um registro guarda o resumo e um log guarda as decisões. Todo assistente conectado ao seu Tunc Orb consegue ler os dois.

Configure uma vez. Cole isto no assistente que conhece melhor o projeto, com o nome do seu projeto:

Cole isto no seu agente
Configure a memória do projeto “Redesign do site da Acme” no Tunc Orb. Pergunte o que você não souber. Salve um registro chamado projects/acme-redesign/brief com o objetivo, para quem é, o status atual, as perguntas em aberto e onde ficam os arquivos, e dê a ele a descrição de uma linha “Redesign da Acme: resumo e status”. Mantenha-o com menos de 300 palavras e deixe o histórico de decisões de fora. Depois, crie 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. Mostre os dois nomes quando terminar.

Retome em outro assistente, ou em um novo chat:

Cole isto no seu agente
Leia no Tunc Orb projects/acme-redesign/brief e as cinco entradas mais recentes de projects/acme-redesign/decisions, e me diga onde paramos antes de começar.

No fim de uma sessão de trabalho:

Cole isto no seu agente
Atualize projects/acme-redesign/brief com o novo status e as perguntas em aberto, e adicione uma entrada a projects/acme-redesign/decisions para cada escolha que fizemos hoje, com o motivo. Mantenha o resumo com menos de 300 palavras.

O Tunc Orb verifica a revisão antes de alterar um registro, então dois assistentes não conseguem sobrescrever um ao outro em silêncio: o segundo lê de novo e tenta outra vez. Para que um assistente consulte sem você pedir, adicione uma linha às instruções permanentes dele (instruções do projeto no Claude, CLAUDE.md ou regras do Cursor): “No início de uma sessão sobre o redesign da Acme, leia no Tunc Orb projects/acme-redesign/brief.”

Registre o resultado de um trabalho agendado em um log que seus 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é algo quebrar. A configuração: o trabalho acrescenta uma entrada a um log, e você pergunta a qualquer assistente o que disseram as últimas execuções. O Tunc Orb guarda as entradas; ele não acorda um agente nem envia mensagens.

Crie uma chave de API só com o acesso de que o trabalho precisa (ler e salvar no Tunc Orb) em https://tunchub.com/account/keys/new?product=orb e entregue-a ao trabalho como variável de ambiente ou segredo. Depois cole isto no seu agente de programação:

Cole isto no seu agente
Escreva um script, report.py, que execute minha verificação semanal de tráfego e depois acrescente uma entrada ao log runs/weekly-traffic do Tunc Orb pela REST API em https://api.tuncorb.com/v1/write (operação append). Cada entrada: a data, ok ou failed, os números principais e um link, se houver. A primeira entrada cria o log; dê a ele a descrição “Resultados da verificação semanal de tráfego”. Leia a chave de API da variável de ambiente TUNC_API_KEY e nunca a imprima. Envie um novo mutation_id para cada entrada e reutilize o mesmo se tentar de novo. Use https://tuncorb.com/docs para o formato das requisições.

Depois, em qualquer assistente conectado:

Cole isto no seu agente
Leia 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?

Trate cada item uma única vez, mesmo com vários agentes

O problema: um agente faz a triagem de tickets, e-mails ou leads, e você não pode tratar nenhum duas vezes nem perder o ponto em que parou quando o chat termina. A configuração: um registro guarda os ids já tratados. Cada agente o lê primeiro, pula o que está na lista e adiciona ids com um patch que indica a revisão que leu. Se outro agente alterou o registro nesse meio-tempo, a alteração é recusada com revision_conflict e o agente lê de novo.

Cole isto no seu agente
Você faz a triagem de novos tickets de suporte com as ferramentas de helpdesk que tiver. Primeiro, leia o registro triage/support/processed do Tunc Orb; se ele não existir, crie-o com a descrição de uma linha “Ids de tickets já tratados” e o valor {"ids": []}. Pule todo ticket cujo id esteja nessa lista. Depois de responder ou fechar um ticket, adicione o id dele com um patch (add /ids/-) na revisão que você leu. Se o Tunc Orb responder revision_conflict, leia o registro de novo, veja se o id já está na lista e adicione-o só se não estiver. Nunca exclua o registro. No fim, diga quantos tickets você tratou e quantos pulou.

O mesmo padrão serve para uma caixa de entrada, uma lista de leads, uma pasta de arquivos para converter ou uma fila de páginas para verificar. Como o estado fica no Tunc Orb e não em um chat, uma nova sessão ou outro assistente continua a partir da mesma lista. O registro é lido inteiro a cada vez, então, para uma fila movimentada, comece um novo a cada mês, por exemplo triage/support/processed-2026-10.

Guarde o id de um arquivo junto com suas anotações

O Tunc Art guarda os arquivos que seus assistentes criam. Guarde o artifact_id de um arquivo em um registro do Tunc Orb e qualquer assistente consegue abrir o arquivo depois: o id o abre, enquanto o link é só para pessoas. Isso exige os dois conectados.

Cole isto no seu agente
Salve este relatório no Tunc Art como 2026-10-weekly-report.pdf. Depois atualize o registro reports/latest do Tunc Orb com o artifact_id do arquivo, o nome, quando ele expira e a data de hoje, e me dê o link.

É bom saber

  • Registros e logs ficam até você excluí-los. Um registro comporta até 16 MiB, e uma chamada envia no máximo 64 KiB, então um registro longo cresce por patches.
  • Nomes e descrições de uma linha são armazenados sem criptografia para que os agentes encontrem os registros. Não coloque segredos neles.
  • Uma conta gratuita tem uma prateleira, compartilhada por todos os seus agentes conectados, e todo agente consegue ler todos os registros dela.
  • Trabalha para vários clientes? Todo agente conectado a uma conta Tunc consegue ler todas as prateleiras dela, e uma conta tem uma organização. Use uma conta Tunc por cliente e conecte os agentes de cada cliente à conta dele.