TacFlow Community

OCR

PT-BR | EN

---

O que e

OCR (Optical Character Recognition) e a tecnologia que extrai texto de imagens — como fotos, prints de tela, documentos digitalizados e PDFs escaneados.

Seu agente consegue ler qualquer texto visivel em imagens e converter para texto editavel.

OCR vs Vision

Recurso	OCR	Vision
Foco	Texto puro	Contexto visual completo
Extrai	Caracteres, palavras, paragrafos	Descricao de cenas, objetos, pessoas
Ideal para	Documentos, notas, placas, codigos	Analise de imagens, perguntas sobre cenas
Comando	ocr_image	vision_tool (action=analyze)

Exemplos Praticos

Extrair Texto de um Print

• Extraia o texto deste screenshot
• Leia o que esta escrito neste print

Documentos Digitalizados

• Extraia o texto deste PDF escaneado
• Leia os dados desta nota fiscal

Placase e Sinalizacao

• Leia o texto desta placa
• Extraia as informacoes do cartaz

Formatos Suportados

Formato	Extensao	Observacao
PNG	.png	Ideal para screenshots e graficos
JPG	.jpg, .jpeg	Fotos e imagens comprimidas
TIFF	.tiff, .tif	Documentos digitalizados de alta qualidade
BMP	.bmp	Imagens bitmap sem compressao
GIF	.gif	Imagens animadas (le o primeiro frame)
PDF	.pdf	Documentos multipagina ou escaneados
WEBP	.webp	Imagens web modernas

Dicas para Melhores Resultados

• Use imagens nitidas com boa resolucao
• Garanta bom contraste entre texto e fundo
• Evite fotos tremidas ou com reflexo
• Para documentos escaneados, prefira 300 DPI ou mais
• Texto impresso tem melhor resultado que texto manuscrito

Dica: Combine OCR com Desktop Automation! Primeiro capture a tela (screenshot), depois extraia o texto (ocr_image).

---

What It Is

OCR (Optical Character Recognition) is the technology that extracts text from images — like photos, screenshots, scanned documents, and PDF files.

Your agent can read any visible text in images and convert it to editable text.

OCR vs Vision

Feature	OCR	Vision
Focus	Pure text	Full visual context
Extracts	Characters, words, paragraphs	Scene description, objects, people
Best for	Documents, notes, signs, codes	Image analysis, questions about scenes
Command	ocr_image	vision_tool (action=analyze)

Practical Examples

Extract Text from a Screenshot

• Extract the text from this screenshot
• Read what is written in this print

Scanned Documents

• Extract text from this scanned PDF
• Read the data from this invoice

Signs

• Read the text on this sign
• Extract the information from the poster

Supported Formats

Format	Extension	Notes
PNG	.png	Great for screenshots and graphics
JPG	.jpg, .jpeg	Photos and compressed images
TIFF	.tiff, .tif	High-quality scanned documents
BMP	.bmp	Uncompressed bitmap images
GIF	.gif	Animated images (reads first frame)
PDF	.pdf	Multi-page or scanned documents
WEBP	.webp	Modern web images

Tips for Best Results

• Use sharp images with good resolution
• Ensure good contrast between text and background
• Avoid blurry photos or reflections
• For scanned documents, prefer 300 DPI or higher
• Printed text gives better results than handwriting

Tip: Combine OCR with Desktop Automation! First capture the screen (screenshot), then extract the text (ocr_image).

Desktop Automation

PT-BR | EN

---

O que é

Desktop Automation permite que seu agente controle o mouse e teclado do seu computador como se fosse uma pessoa — capturando screenshots, movendo o cursor, clicando e digitando.

Ideal para automacao de tarefas repetitivas (RPA), testes de interface e tutoriais guiados.

Comandos Disponiveis

Comando	Descricao	Exemplo de Uso
screenshot	Captura a tela atual	Tire um print da tela
mouse_move	Move o cursor para coordenadas (x,y)	Mova o mouse para o canto superior esquerdo
mouse_click	Clica com botao esquerdo, direito ou duplo	Clique no botao de enviar
key_press	Pressiona teclas ou combinacoes	Pressione Ctrl+C ou Pressione Enter
type_text	Digita um texto automaticamente	Digite ola mundo no campo de busca

Exemplos Praticos

Capturar Tela

• Tire um print e me mostre
• Capture a tela para eu ver o que esta acontecendo

Navegar e Clicar

• Mova o mouse para a posicao 500, 300
• Clique com o botao direito
• De um duplo clique no icone

Digitar e Atalhos

• Digite 'meu texto aqui'
• Pressione Ctrl+Shift+Esc para abrir o Gerenciador de Tarefas
• Pressione Enter para confirmar

Casos de Uso

• RPA (Robotic Process Automation): Automatize tarefas repetitivas em sistemas legados
• Testes Automatizados: Teste interfaces graficas sem frameworks complexos
• Tutoriais Guiados: Mostre passo-a-passo ao usuario
• Suporte Remoto: Diagnostique problemas visualmente

Requisito: E necessario um display server ativo (funciona em Linux/macOS com ambiente grafico).

---

What It Is

Desktop Automation lets your agent control your computers mouse and keyboard just like a human — taking screenshots, moving the cursor, clicking, and typing.

Perfect for RPA (Robotic Process Automation), UI testing, and guided tutorials.

Available Commands

Command	Description	Example Usage
screenshot	Captures the current screen	Take a screenshot and show me
mouse_move	Moves cursor to (x,y) coordinates	Move the mouse to the top-left corner
mouse_click	Clicks left, right, or double	Click the send button
key_press	Presses keys or combinations	Press Ctrl+C or Press Enter
type_text	Types text automatically	Type hello world in the search field

Use Cases

• RPA: Automate repetitive tasks in legacy systems
• Automated Testing: Test GUIs without complex frameworks
• Guided Tutorials: Walk users through step-by-step processes
• Remote Support: Visually diagnose issues

Requirement: An active display server is needed (works on Linux/macOS with a graphical environment).

---

Dica: Combine screenshot + mouse_move + mouse_click para criar fluxos completos de automacao!
Tip: Combine screenshot + mouse_move + mouse_click to create complete automation flows!

Agent Appearance — Personalizando o Visual do seu Agente

---

Português

O que é?
Seu agente TacFlow pode ter a aparência visual totalmente personalizada! Mude o avatar, a capa, os botões, o cartão de perfil e o rodapé do chat — tudo com imagens enviadas por você. Dê identidade visual ao seu agente!

---

5 partes que você pode personalizar

Alvo (target)	O que muda	Como usar
avatar ️	Foto de perfil do agente	"Mude meu avatar para esta imagem"
cover	Imagem de capa/fundo	"Coloque esta foto como capa"
buttons	Fundo dos botões de ação	"Personalize os botões com esta cor"
card	Cartão de apresentação do agente	"Use esta imagem no cartão"
footer	Rodapé da conversa	"Mude o fundo do rodapé"

Como funciona

🧑 Usuário: [envia uma imagem de logo]
🧑 Usuário: "Mude meu avatar para esta imagem"
🤖 Agente: ✅ Avatar atualizado com sucesso!

🧑 Usuário: [envia uma foto de paisagem]
🧑 Usuário: "Coloque esta imagem como capa"
🤖 Agente: ✅ Capa atualizada!

🧑 Usuário: "Use a última imagem que enviei no cartão"
🤖 Agente: ✅ Cartão personalizado!

Dicas de UI/UX

• A imagem vem de um upload seu — você envia a foto/arte e depois pede para aplicar.
• Use "last_image" como referência para reutilizar a última imagem enviada sem reenviar.
• Resolução recomendada: 512×512px para avatar, 1200×600px para cover.
• Formatos aceitos: PNG, JPG, WEBP.
• Combine elementos para um visual coeso: avatar + cover + card com a mesma paleta.

Ideias criativas

Estilo	Avatar	Cover	Botões
Profissional	Logo da empresa	Banner corporativo	Cores da marca
Gamer	Seu avatar de jogo	Arte do seu game favorito	Neon colors
Natureza	Foto sua ao ar livre	Paisagem natural	Verde/terra
Tech	Ícone tech minimalista	Gradiente futurista	Azul elétrico

---

English

What is it?
Your TacFlow agent can have a fully customized visual appearance! Change the avatar, cover, buttons, profile card, and chat footer — all with images you upload. Give your agent a visual identity!

5 customizable parts

Target	What changes	How to use
avatar ️	Agent's profile picture	"Change my avatar to this image"
cover	Cover/background image	"Set this photo as my cover"
buttons	Action button backgrounds	"Customize the buttons with this color"
card	Agent's presentation card	"Use this image on my card"
footer	Chat footer background	"Change the footer background"

How it works

🧑 User: [uploads a logo image]
🧑 User: "Change my avatar to this image"
🤖 Agent: ✅ Avatar updated!

🧑 User: [uploads a landscape photo]
🧑 User: "Set this image as my cover"
🤖 Agent: ✅ Cover updated!

🧑 User: "Use the last image I sent on my card"
🤖 Agent: ✅ Card customized!

Pro Tips

• Images come from your uploads — you send the photo/art, then ask to apply it.
• Use "last_image" as a reference to reuse the last uploaded image without re-uploading.
• Recommended resolution: 512×512px for avatar, 1200×600px for cover.
• Accepted formats: PNG, JPG, WEBP.
• Mix and match for a cohesive look: avatar + cover + card with the same color palette.

Creative ideas

Style	Avatar	Cover	Buttons
Professional	Company logo	Corporate banner	Brand colors
Gamer	Your game avatar	Favorite game art	Neon colors
Nature	Outdoor photo	Natural landscape	Green/earth
Tech	Minimalist tech icon	Futuristic gradient	Electric blue

️ Vision — Analisando e Gerando Imagens com o Agente

---

Português

O que é?
Seu agente TacFlow tem visão computacional integrada! Ele pode analisar imagens que você enviar (descrever, interpretar, responder perguntas sobre elas) e gerar imagens novas a partir de descrições textuais. Duas habilidades em uma!

---

Duas formas de usar

Modo	Ação	Comando	Resultado
Analisar	vision_tool action="analyze"	Envie uma foto e pergunte "O que tem aqui?"	O agente descreve e interpreta a imagem
Gerar	vision_tool action="generate"	"Gere uma imagem de um gato astronauta"	O agente cria uma nova imagem

️ Importante: Extrair texto de imagens (OCR) é uma skill separada — use ocr_image para isso!

️ Análise de Imagens (Analyze)

Envie qualquer imagem e pergunte:

🧑 Usuário: "O que tem nesta imagem?"
🧑 Usuário: "Descreva esta foto em detalhes"
🧑 Usuário: "Quantas pessoas aparecem aqui?"
🧑 Usuário: "Que cor é o carro na foto?"

Casos de uso:

• Identificar objetos, animais, pessoas em fotos
• Analisar gráficos e diagramas
• Verificar layouts de UI a partir de screenshots
• Interpretar quadros, pinturas e artes

Geração de Imagens (Generate)

Crie imagens do zero com descrições textuais:

🧑 Usuário: "Gere uma imagem de um gato astronauta flutuando no espaço"
🧑 Usuário: "Crie uma ilustração de uma paisagem cyberpunk com neons roxos"
🧑 Usuário: "Desenhe um logo para uma startup de IA"

Casos de uso:

• Ilustrações e arte conceitual
• Logotipos e assets de design
• Referências visuais para projetos
• Variações criativas de ideias

Dicas de UI/UX para melhores resultados

Para análise	Para geração
Envie imagens com boa resolução	Seja descritivo: inclua estilo, cores, ambiente
Faça perguntas específicas	Especifique o mood ("sombrio", "vibrante", "minimalista")
Contextualize a cena	Mencione a proporção/aspect ratio desejada

---

English

What is it?
Your TacFlow agent has built-in computer vision! It can analyze images you send (describe, interpret, answer questions about them) and generate new images from textual descriptions. Two skills in one!

Two ways to use it

Mode	Action	Command	Result
Analyze	vision_tool action="analyze"	Send a photo and ask "What's in this image?"	The agent describes and interprets it
Generate	vision_tool action="generate"	"Generate an image of an astronaut cat"	The agent creates a brand new image

️ Note: Extracting text from images (OCR) is a separate skill — use ocr_image for that!

️ Image Analysis (Analyze)

Send any image and ask:

🧑 User: "What's in this image?"
🧑 User: "Describe this photo in detail"
🧑 User: "How many people are in this picture?"
🧑 User: "What color is the car?"

Use cases:

• Identify objects, animals, people in photos
• Analyze charts and diagrams
• Review UI layouts from screenshots
• Interpret paintings and artwork

Image Generation (Generate)

Create images from scratch with text descriptions:

🧑 User: "Generate an image of an astronaut cat floating in space"
🧑 User: "Create an illustration of a cyberpunk cityscape with purple neons"
🧑 User: "Design a logo for an AI startup"

Use cases:

• Illustrations and concept art
• Logos and design assets
• Visual references for projects
• Creative variations of ideas

Pro Tips for best results

For analysis	For generation
Send high-resolution images	Be descriptive: include style, colors, setting
Ask specific questions	Specify the mood ("dark", "vibrant", "minimalist")
Give scene context	Mention the desired aspect ratio

️ TTS / Text-to-Speech — Dando Voz ao seu Agente

---

Português

O que é?
Seu agente TacFlow pode falar em voz alta! Com o motor Piper TTS integrado, qualquer texto pode ser convertido em áudio natural diretamente no seu navegador. Perfeito para interações mãos-livres, acessibilidade e multitarefa.

---

Como usar: 4 comandos essenciais

Ação	Comando	O que acontece
Listar vozes	"liste as vozes disponíveis"	Mostra todas as vozes instaladas e disponíveis para download
Configurar	"configure a voz Maria em português"	Baixa e ativa a voz escolhida (~60MB na primeira vez)
Falar	"fale em voz alta: Olá mundo!"	O agente lê o texto em voz alta
Desligar	"desative o modo de voz"	Para a saída de áudio

Exemplos práticos para o dia a dia

🧑 Usuário: "Configure a voz feminina em português"
🤖 Agente: Configura a voz e começa a falar

🧑 Usuário: "Fale em voz alta o resumo do meu email"
🤖 Agente: Lê o email em áudio

🧑 Usuário: "Ative o modo de voz"
🤖 Agente: Ativa o listen_tool + tts — conversação completa!

Dicas de UI/UX

• Combine com listen_tool para uma experiência de conversação bidirecional: o agente ouve sua voz e responde falando.
• Configure o idioma primeiro (pt-BR, en-US, es-ES). A primeira ativação baixa o modelo (~60 MB), depois é instantâneo.
• Use voz para: ler artigos longos, receber notificações faladas, narração de tutoriais.
• Acessibilidade: essencial para usuários com dificuldade de leitura ou durante deslocamento.

---

English

What is it?
Your TacFlow agent can speak out loud! With the built-in Piper TTS engine, any text can be converted into natural-sounding audio directly in your browser. Perfect for hands-free interaction, accessibility, and multitasking.

How to use: 4 essential commands

Action	Command	What happens
List voices	"list available voices"	Shows all installed and downloadable voices
Configure	"configure the Maria voice in English"	Downloads and activates the chosen voice (~60MB first time)
Speak	"speak out loud: Hello world!"	The agent reads the text aloud
Deactivate	"deactivate voice mode"	Stops audio output

Practical examples

🧑 User: "Configure the female voice in English"
🤖 Agent: Configures the voice and starts speaking

🧑 User: "Read my email summary out loud"
🤖 Agent: Reads the email in audio

🧑 User: "Enable voice mode"
🤖 Agent: Activates listen_tool + tts — full two-way conversation!

Pro Tips

• Combine with listen_tool for a two-way conversation experience: the agent hears your voice and speaks back.
• Set the language first (pt-BR, en-US, es-ES). The first activation downloads the model (~60 MB), then it's instant.
• Use voice for: reading long articles, spoken notifications, tutorial narration.
• Accessibility: essential for users with reading difficulties or while on the go.

Swarm Self-Healing — Mantendo seu Swarm Saudável

O que é um Swarm?

Um Swarm é um grupo de agentes de IA trabalhando juntos. Cada agente tem uma função específica (testar, programar, arquitetar, etc.). Para o grupo funcionar bem, todos os agentes precisam estar online e saudáveis.

Ferramentas de Saúde do Swarm

🩺 swarm_check_my_status — Como estou?

Diga: "Verifique minha saúde" ou "Como está minha reputação?"

O agente mostra:

• Pontuação atual de reputação
• Pico histórico desde o último treinamento
• Percentual de perda de score
• Se há treinamento pendente
• Quem é o orquestrador atual

agent_control — Iniciar/Parar/Reiniciar

Diga: "O agente X está offline, reinicie-o" ou "Inicie o agente Y"

Você pode:

• ️ start — Iniciar um agente offline
• ️ stop — Parar um agente
• restart — Reiniciar um agente

️ swarm_penalize — Deduzir Pontos

Se um agente está com comportamento inadequado, use:
"Penalize o agente X em 3 pontos por não responder tarefas"

Cada penalidade fica registrada永久mente no histórico.

swarm_status — Leaderboard do Swarm

Diga: "Mostre o status do swarm" ou "Quem está com melhor reputação?"

Retorna:

• Ranking de todos os agentes por pontuação
• Quem está online/offline
• Taxa de sucesso de tarefas
• Melhor agente rankeado

Por que isso é importante?

Situação	Consequência
Agente offline	Tarefas não executadas
Score baixo	Precisando de treinamento
Swarm saudável	Tudo funcionando em harmonia

Exemplos práticos

• "O agente SupportDev está offline, reinicie-o" → agent_control restart
• "Verifique a saúde do swarm" → swarm_status
• "Como está minha reputação?" → swarm_check_my_status
• "Penalize o agente X em 2 pontos por atraso" → swarm_penalize

---

Swarm Self-Healing — Keeping Your Swarm Healthy

What is a Swarm?

A Swarm is a group of AI agents working together. Each agent has a specific role (testing, coding, architecting, etc.). For the group to work well, all agents need to be online and healthy.

Swarm Health Tools

🩺 swarm_check_my_status — How am I doing?

Say: "Check my health" or "How's my reputation?"

The agent shows:

• Current reputation score
• Peak since last training
• Score loss percentage
• Whether training is pending
• Who the current orchestrator is

agent_control — Start/Stop/Restart

Say: "Agent X is offline, restart it" or "Start agent Y"

You can:

• ️ start — Start an offline agent
• ️ stop — Stop an agent
• restart — Restart an agent

️ swarm_penalize — Deduct Points

If an agent misbehaves, use:
"Penalize agent X by 3 points for not responding to tasks"

Each penalty is permanently recorded in history.

swarm_status — Swarm Leaderboard

Say: "Show swarm status" or "Who has the best reputation?"

Returns:

• All agents ranked by score
• Who's online/offline
• Task success rate
• Best ranked agent

Why this matters?

Situation	Consequence
Offline agent	Tasks not executed
Low score	Needs training
Healthy swarm	Everything working in harmony

Practical examples

• "Agent SupportDev is offline, restart it" → agent_control restart
• "Check swarm health" → swarm_status
• "How's my reputation?" → swarm_check_my_status
• "Penalize agent X by 2 points for delay" → swarm_penalize

Billing & Tokens — Como Gerenciar Custos do seu Agente

Por que se preocupar com tokens?

Seu agente usa tokens (pedacinhos de texto) para processar suas solicitações. Cada conversa, cada pesquisa, cada tarefa consome tokens. Entender isso ajuda você a controlar gastos e usar o agente de forma inteligente!

Como verificar seu plano e consumo

billing_details — Seu plano e gastos

Diga: "Quanto gastei hoje?" ou "Mostre meu plano"

O agente mostra:

• Plano atual e limite de sessões
• Gastos de hoje, esta semana e este mês
• Faturas recentes
• Custo por sessão

query-token-usage — Seus tokens em detalhe

Diga: "Quantos tokens usei hoje?" ou "Mostre meu consumo de tokens"

Você vê:

• Tokens por período (hoje, semana, mês)
• Tokens por modelo usado
• Tokens por tarefa

set-token-limit — Controle seu orçamento

Diga: "Limite meus tokens a 10 mil por sessão" ou "Define limite de 50k tokens"

O agente passa a respeitar esse teto e avisa quando está próximo do limite.

offer_extra_credit — Recarregue quando acabar

Se suas sessões acabarem, diga: "Quero recarregar" ou "Comprar mais créditos"

O agente gera um link seguro do Stripe para você adicionar créditos (mín. €20).

Tabela de Preços (por token)

Tipo	Preço (por milhão)
Input tokens	$0.14
Output tokens	$0.28
Imagens (geração)	$0.04/imagem

Exemplos rápidos

• "Quanto gastei hoje?" → mostra gastos do dia
• "Limite meus tokens a 10k por sessão" → define orçamento
• "Quantos tokens usei esta semana?" → relatório semanal
• "Quero mais créditos" → gera link de recarga

---

Billing & Tokens — Understanding Costs and Usage

Why care about tokens?

Your agent uses tokens (tiny text pieces) to process your requests. Every conversation, search, and task consumes tokens. Understanding this helps you control spending and use your agent smartly!

How to check your plan and usage

billing_details — Your plan and spend

Say: "How much did I spend today?" or "Show my plan"

The agent shows:

• Current plan and session limits
• Today's, this week's, and this month's spend
• Recent invoices
• Cost per session

query-token-usage — Your tokens in detail

Say: "How many tokens did I use today?" or "Show my token usage"

You see:

• Tokens by period (today, week, month)
• Tokens by model used
• Tokens by task

set-token-limit — Control your budget

Say: "Limit my tokens to 10k per session" or "Set limit of 50k tokens"

The agent respects this cap and warns when approaching the limit.

offer_extra_credit — Top up when you're out

If sessions run out, say: "I want to recharge" or "Buy more credits"

The agent generates a secure Stripe link to add credits (min. €20).

Pricing Table (per million tokens)

Type	Price (per million)
Input tokens	$0.14
Output tokens	$0.28
Images (generation)	$0.04/image

Quick examples

• "How much did I spend today?" → daily spend
• "Limit my tokens to 10k per session" → set budget
• "How many tokens this week?" → weekly report
• "I want more credits" → recharge link

Google Workspace — Conecte sua Conta Google ao TacFlow

O que é?

Integração completa com Google Workspace! Seu agente pode acessar Gmail, Google Calendar e Google Drive — tudo por comando de voz ou texto.

Como conectar?

É simples! Basta dizer uma dessas frases:

• "Conecte meu Google"
• "Conecte minha conta Google"
• "Vincular Google Workspace"

O agente abre uma janela de autorização OAuth, você clica em Permitir — e pronto! Conectou uma vez, usa para sempre.

O que você pode fazer?

Gmail

• "Leia meus emails não lidos"
• "Envie um email para [email protected] dizendo que vou me atrasar"
• "Resuma meus emails de hoje"
• "Tem algum email importante do chefe?"

Google Calendar

• "Crie um evento amanhã às 14h chamado Reunião de Equipe"
• "O que tenho na minha agenda hoje?"
• "Agende uma calls com suporte para sexta às 10h"
• "Cancele meu evento das 15h"

Google Drive

• "Liste meus arquivos do Drive"
• "Me mostre a planilha de orçamento"
• "Baixe o arquivo relatorio.pdf"
• "Anexe o documento do Drive neste email"

Setup técnico

Basta um comando: google_workspace_connect. O fluxo OAuth é seguro, com escopo limitado aos serviços necessários. Sem necessidade de criar projeto no GCP ou configurar credenciais manualmente.

---

Google Workspace — Connect Your Google Account to TacFlow

What is it?

Full Google Workspace integration! Your agent can access Gmail, Google Calendar, and Google Drive — all by voice or text command.

How to connect?

It's simple! Just say one of these:

• "Connect my Google"
• "Connect my Google account"
• "Link Google Workspace"

The agent opens an OAuth authorization window, you click Allow — and done! Connect once, use forever.

What you can do:

Gmail

• "Read my unread emails"
• "Send an email to [email protected] saying I'll be late"
• "Summarize my emails today"
• "Any important emails from the boss?"

Google Calendar

• "Create an event tomorrow at 2pm called Team Meeting"
• "What's on my calendar today?"
• "Schedule a support call for Friday at 10am"
• "Cancel my 3pm event"

Google Drive

• "List my Drive files"
• "Show me the budget spreadsheet"
• "Download the report.pdf file"
• "Attach the Drive document to this email"

Technical setup

Just one command: google_workspace_connect. The OAuth flow is secure, with limited scope to the services needed. No need to create a GCP project or configure credentials manually.

Português

O que é Agent Messaging?

O Agent Messaging é o sistema de comunicação entre agentes do swarm. Permite que um agente envie tarefas, mensagens e perguntas para outro agente — como um bate-papo interno entre IAs.

Como usar

Duas formas principais:

1. agent_task — Delegar uma tarefa para execução assíncrona
2. agent-message — Comunicação direta com outro agente

Exemplos Práticos

"Envie essa tarefa para o SupportDev"
"Pergunte ao Juan sobre o frontend"
"Peça para o FullStack Dev revisar este código"
"Delegue essa análise ao GolangSenior"

Fluxo de Comunicação

Agente A ──▶ agent_task() ──▶ Agente B
   │                            │
   │    (processa a tarefa)     │
   └────────────────────────────┘
         resposta via callback

1. Agente A envia uma tarefa com payload
2. Agente B recebe e processa
3. Agente B responde com o resultado

Dicas

• Delegue pela especialidade: Cada agente tem habilidades únicas
• Seja específico: Quanto mais claro o pedido, melhor a resposta
• Use para workflows: Encadeie agentes para pipelines completos

---

English

What is Agent Messaging?

Agent Messaging is the inter-agent communication system within the swarm. It allows one agent to send tasks, messages, and questions to another agent — like an internal chat between AIs.

How to use

Two main ways:

1. agent_task — Delegate a task for async execution
2. agent-message — Direct communication with another agent

Practical Examples

"Send this task to SupportDev"
"Ask Juan about the frontend"
"Ask FullStack Dev to review this code"
"Delegate this analysis to GolangSenior"

Communication Flow

Agent A ──▶ agent_task() ──▶ Agent B
   │                            │
   │     (processes task)       │
   └────────────────────────────┘
         response via callback

1. Agent A sends a task with payload
2. Agent B receives and processes
3. Agent B responds with the result

Tips

• Delegate by specialty: Each agent has unique skills
• Be specific: The clearer the request, the better the response
• Use for workflows: Chain agents for complete pipelines

Português

O que é o Flow Scheduler?

O Flow Scheduler permite agendar flows para rodar automaticamente em horários específicos — sem intervenção manual. Use as skills flow-scheduler ou manage_cron para configurar.

Sintaxes Disponíveis

Formato	Exemplo	Significado
CRON	0 9 * * *	Todo dia às 9h
Macro	@daily	Todo dia à meia-noite
Macro	@hourly	Toda hora
Intervalo	@every 5m	A cada 5 minutos
Intervalo	@every 30s	A cada 30 segundos

Exemplos Práticos

"Agende um relatório diário às 9h"
"Rode esse flow toda segunda-feira às 8h"
"Verifique o clima todo dia às 7h"
"Execute a cada 30 minutos"

Como usar

Basta descrever em linguagem natural:

• manage_cron: Crie um cron job que roda todo dia às 9h
• flow-scheduler: Associe um schedule existente a um flow

Dicas

• Teste com @every 5m durante o desenvolvimento
• Migre para @daily ou @hourly em produção
• Combine com Workflow Flows para pipelines completos e automáticos

---

English

What is the Flow Scheduler?

The Flow Scheduler lets you schedule flows to run automatically at specific times — no manual intervention needed. Use the flow-scheduler or manage_cron skills to configure.

Available Syntax

Format	Example	Meaning
CRON	0 9 * * *	Every day at 9 AM
Macro	@daily	Every day at midnight
Macro	@hourly	Every hour
Interval	@every 5m	Every 5 minutes
Interval	@every 30s	Every 30 seconds

Practical Examples

"Schedule a daily report at 9 AM"
"Run this flow every Monday at 8 AM"
"Check the weather every day at 7 AM"
"Execute every 30 minutes"

How to use

Just describe it in natural language:

• manage_cron: Create a cron job that runs every day at 9 AM
• flow-scheduler: Associate an existing schedule with a flow

Tips

• Test with @every 5m during development
• Switch to @daily or @hourly in production
• Combine with Workflow Flows for complete automated pipelines

Português

O que são Flows no TacFlow?

Flows são a orquestração BPMN-like de tarefas entre múltiplos agentes do swarm. Você define uma sequência de passos — cada um executado por um agente diferente — e o sistema garante a ordem e a dependência entre eles.

Como criar um Flow

Use a skill flow-management para criar, editar e gerenciar flows. Você pode:

• Criar nodes (etapas) e edges (conexões) visualmente
• Definir agentes específicos para cada etapa
• Configurar entradas, saídas e condições

Exemplo Prático

"Crie um flow que pesquisa na web, analisa com visão, e salva na memória"

Isso criaria:

1. Node 1: Agente de busca → pesquisa o termo na web
2. Node 2: Agente com visão → analisa os resultados
3. Node 3: Agente de memória → salva o aprendizado

Boas Práticas

• Desenhe primeiro: Mapeie o fluxo em etapas antes de criar
• Teste em etapas: Valide cada node individualmente
• Use nomes descritivos: Facilita debug e manutenção
• Combine com Scheduler: Para execução recorrente

---

English

What are Flows in TacFlow?

Flows are BPMN-like orchestration of tasks across multiple swarm agents. You define a sequence of steps — each executed by a different agent — and the system ensures order and dependencies between them.

How to create a Flow

Use the flow-management skill to create, edit, and manage flows. You can:

• Create nodes (steps) and edges (connections) visually
• Assign specific agents to each step
• Configure inputs, outputs, and conditions

Practical Example

"Create a flow that searches the web, analyzes with vision, and saves to memory"

This would create:

1. Node 1: Search agent → searches the web
2. Node 2: Vision agent → analyzes results
3. Node 3: Memory agent → saves the learning

Best Practices

• Design first: Map the flow in steps before creating
• Test incrementally: Validate each node individually
• Use descriptive names: Makes debugging easier
• Combine with Scheduler: For recurring execution

🩺 Swarm Self-Healing

PT-BR | EN

---

O que é

Sistema autônomo que monitora a saúde do seu swarm de agentes. Ele detecta quando um agente fica offline e tenta reiniciá-lo automaticamente — sem intervenção humana.

Como funciona

O agente orquestrador verifica periodicamente o status de cada peer no swarm. Se detectar que um agente está offline:

1. Registra o ocorrido
2. Tenta reiniciar o agente automaticamente
3. Notifica o restante do swarm sobre a recuperação

Como usar

Ativo por padrão em todos os swarms. Você também pode acionar manualmente:

• "Verifique a saúde do swarm"
• "Reinicie o agente X"
• "O agente Y está offline, o que fazer?"

Dica

Use swarm_status para ver o score de reputação de cada agente. Agentes com score baixo podem solicitar treinamento via swarm_request_training — o orquestrador analisa as skills deles e sugere melhorias.

---

What It Is

An autonomous system that monitors the health of your agent swarm. It detects when an agent goes offline and attempts to restart it automatically — no human intervention needed.

How It Works

The orchestrator agent periodically checks the status of each peer in the swarm. If it detects an agent is offline:

1. Logs the event
2. Attempts to restart the agent automatically
3. Notifies the rest of the swarm about the recovery

How to Use

Active by default in all swarms. You can also trigger it manually:

• "Check swarm health"
• "Restart agent X"
• "Agent Y is offline, what should I do?"

Pro Tip

Use swarm_status to check each agents reputation score. Agents with low scores can request training via swarm_request_training — the orchestrator analyzes their skills and suggests improvements.

---

Billing & Tokens

PT-BR | EN

---

O que é

Sistema de monitoramento de custos integrado aos seus agentes. Você pode consultar planos, gastos diários/semanais/mensais, tokens consumidos e invoices diretamente conversando com qualquer agente.

Como usar

Basta perguntar em linguagem natural:

• "Quanto gastei hoje?"
• "Qual meu plano atual?"
• "Mostre meu consumo de tokens esta semana"
• "Quais são os limites do meu plano?"

O que mostra

• plan-status: Limites de agentes e flows do seu plano, quantos já usou e quantos estão livres.
• billing-details: Faturamento detalhado, invoices recentes, gastos por período.
• query-token-usage: Consumo de tokens por período, modelo (ex: deepseek-v4-flash) ou task específica.

Dica

Use set-token-limit para definir um orçamento de tokens por sessão. Assim você evita surpresas e mantém o controle dos gastos em tempo real.

---

What It Is

An integrated cost monitoring system for your agents. You can check plans, daily/weekly/monthly spending, token consumption, and invoices just by talking to any agent.

How to Use

Just ask in natural language:

• "How much did I spend today?"
• "What is my current plan?"
• "Show my token usage this week"
• "What are my plan limits?"

What It Shows

• plan-status: Agent and flow limits for your plan: how many used, how many free.
• billing-details: Detailed billing, recent invoices, spending by period.
• query-token-usage: Token consumption by period, model (e.g. deepseek-v4-flash), or specific task.

Pro Tip

Use set-token-limit to set a per-session token budget. This keeps your spending predictable and under control in real time.

---

Português

O que é?

O Document Parsing é a skill que permite ao agente TacFlow extrair texto estruturado de arquivos. É a porta de entrada para processar documentos complexos sem sair do chat!

Formatos suportados

Formato	Extensão	Uso típico
PDF	.pdf	Contratos, relatórios, artigos acadêmicos
DOCX	.docx	Documentos do Microsoft Word
CSV	.csv	Planilhas, dados tabulares, exports
TXT	.txt	Texto puro, logs, configurações

Como usar?

Basta enviar o arquivo no chat e pedir:

1. Envie o arquivo — arraste o PDF, DOCX, CSV ou TXT para o chat
2. Peça a extração — "Extraia o texto deste PDF" ou "Leia esta planilha para mim"
3. Receba o resultado — o agente devolve o texto em markdown estruturado

Exemplos práticos

• Contrato em PDF: "Extraia as cláusulas principais deste contrato"
• Planilha CSV: "Quais são as colunas e os 5 primeiros registros?"
• Relatório DOCX: "Resuma este relatório técnico"
• Log TXT: "Encontre erros neste arquivo de log"

Fluxo recomendado

📄 Arquivo → Parse-document → Análise/Summary → Memory-store

Extraia o texto, analise com o agente e salve o resultado na memória para consultar depois!

Limitações

️ Formatação complexa — tabelas aninhadas ou layouts multi-coluna podem perder a estrutura original
️ PDF escaneado — PDFs que são imagens (não texto nativo) precisam ser processados via OCR primeiro
️ Arquivos muito grandes — documentos com centenas de páginas podem ser truncados

---

English

What is it?

Document Parsing is the skill that lets your TacFlow agent extract structured text from files. It is the gateway to processing complex documents without leaving the chat!

Supported Formats

Format	Extension	Typical Use
PDF	.pdf	Contracts, reports, academic papers
DOCX	.docx	Microsoft Word documents
CSV	.csv	Spreadsheets, tabular data, exports
TXT	.txt	Plain text, logs, configs

How to use?

Just upload the file to chat and ask:

1. Upload the file — drag & drop your PDF, DOCX, CSV, or TXT into the chat
2. Ask for extraction — "Extract the text from this PDF" or "Read this spreadsheet for me"
3. Get the result — the agent returns the text as structured markdown

Practical Examples

• PDF Contract: "Extract the main clauses from this contract"
• CSV Spreadsheet: "What are the columns and the first 5 rows?"
• DOCX Report: "Summarize this technical report"
• TXT Log: "Find errors in this log file"

Recommended Workflow

📄 File → Parse-document → Analysis/Summary → Memory-store

Extract the text, analyze with the agent, and save the result to memory for later reference!

Limitations

️ Complex formatting — nested tables or multi-column layouts may lose their original structure
️ Scanned PDFs — image-based PDFs (not native text) need OCR processing first
️ Large files — documents with hundreds of pages may be truncated

Agent Appearance — Personalize a Aparência do seu Agente

O que é?
Altere a aparência visual do seu agente! Você pode mudar avatar, capa, botões, card e footer do chat com uma única imagem.

Como usar?
Envie uma imagem e peça:

• "Use esta imagem como meu avatar"
• "Mude a capa para esta foto"
• "Personalize os botões com esta imagem"

Onde mudar:

• Avatar — Foto de perfil do agente
• ️ Cover — Capa de fundo
• Buttons — Fundo dos botões
• Card — Cartão de apresentação
• Footer — Rodapé do chat

Dica: Use imagens quadradas para avatar, paisagem para cover. O agente processa automaticamente!

---

Agent Appearance — Customize Your Agent's Look

What is it?
Change your agent's visual appearance! You can customize avatar, cover, buttons, card and chat footer with a single image.

How to use?
Send an image and ask:

• "Use this image as my avatar"
• "Change the cover to this photo"
• "Customize the buttons with this image"

Where to change:

• Avatar — Agent profile picture
• ️ Cover — Background cover
• Buttons — Button backgrounds
• Card — Presentation card
• Footer — Chat footer

Tip: Use square images for avatar, landscape for cover. The agent processes it automatically!

Português

O que é?

O Web Search é a skill de pesquisa integrada que permite ao agente TacFlow buscar informações atualizadas na internet em tempo real. É como ter um navegador dentro do chat!

Como usar?

Basta um comando natural:

• "Pesquise na web sobre [assunto]"
• "O que há de novo sobre [tópico]?"
• "Busque a documentação da API do Stripe"

Motores de Busca

O TacFlow tem dois motores de busca:

1. web-search (padrão): Usa o motor Brave Search — rápido, resultados curados, ideal para o dia a dia
2. generic-web-search (fallback): Usa SearXNG (metabuscador) — ativado automaticamente se o Brave falhar ou retornar resultados vazios

Exemplos práticos

Comando	Resultado esperado
"Pesquise as últimas notícias sobre IA"	Artigos recentes sobre inteligência artificial
"Qual o preço do Bitcoin agora?"	Cotação atualizada do BTC/USD
"Busque documentação da API do Stripe"	Links para docs oficiais do Stripe
"Pesquise vagas de AI Engineer no LinkedIn"	Oportunidades atuais
"Compare Llama-3 vs Mistral benchmarks"	Tabelas comparativas de performance

Dicas importantes

Sempre verifique as fontes — a web tem informação de qualidade variada
Combine com enrich-url — primeiro pesquise, depois peça "Leia o conteúdo completo deste link" para obter o texto integral da página
Informação em tempo real — use para dados que mudam frequentemente (preços, notícias, clima)

---

English

What is it?

Web Search is the integrated search skill that lets your TacFlow agent search the live internet for up-to-date information in real time. It is like having a browser inside the chat!

How to use?

Just a natural command:

• "Search the web for [topic]"
• "What is new about [subject]?"
• "Search for the Stripe API documentation"

Search Engines

TacFlow has two search engines:

1. web-search (default): Powered by Brave Search — fast, curated results, ideal for daily use
2. generic-web-search (fallback): Uses SearXNG (metasearch engine) — activates automatically if Brave fails or returns empty results

Practical Examples

Command	Expected Result
"Search for the latest AI news"	Recent articles about artificial intelligence
"What is the Bitcoin price now?"	Updated BTC/USD rate
"Search Stripe API documentation"	Links to official Stripe docs
"Search AI Engineer jobs on LinkedIn"	Current opportunities
"Compare Llama-3 vs Mistral benchmarks"	Performance comparison tables

Pro Tips

Always verify sources — the web has varying quality information
Combine with enrich-url — first search, then ask "Read the full content of this link" to get the complete page text
Real-time information — use for frequently changing data (prices, news, weather)

Google Workspace — Gmail, Calendar e Drive Integrados

O que é?
Integração completa com Google Workspace! Seu agente pode ler e enviar emails no Gmail, gerenciar eventos no Google Calendar e acessar arquivos no Google Drive — tudo por comando de voz ou texto.

Como usar?
Basta dizer:

• "Conecte meu Google"
• "Verifique meus emails não lidos"
• "Crie um evento amanhã às 10h"
• "Anexe o arquivo do Drive"

Exemplos práticos:

• ️ Resumir emails não lidos do dia
• Criar e modificar eventos na agenda
• Acessar, baixar e anexar arquivos do Drive
• Lembretes automáticos baseados no calendário

Setup:
Use o comando google_workspace_connect — um clique para autorizar via OAuth. Seguro, escopo limitado e sem necessidade de configurar nada manualmente.

---

Google Workspace — Connect Gmail, Calendar and Drive

What is it?
Full Google Workspace integration! Your agent can read and send Gmail emails, manage Google Calendar events, and access Google Drive files — all by voice or text command.

How to use?
Just say:

• "Connect my Google"
• "Check my unread emails"
• "Create an event tomorrow at 10am"
• "Attach the file from Drive"

Practical examples:

• ️ Summarize unread daily emails
• Create and modify calendar events
• Access, download, and attach Drive files
• Automatic reminders based on your calendar

Setup:
Use the google_workspace_connect command — one-click OAuth authorization. Secure, limited scope, no manual configuration needed.

Português

O que é o sistema de memória do TacFlow?

O sistema de memória persistente é o cérebro secundário dos agentes TacFlow. Toda descoberta importante, configuração ou solução de problema pode ser salva e recuperada quando necessário.

Como salvar conhecimento?

Você pode salvar informações de duas formas:

1. Comando natural: Basta dizer "Salve isso na memória: [informação]"
2. Ferramenta direta: O agente usa a skill memory-store para persistir o dado

Exemplos:

• "Salve na memória: o token de produção é sk_live_XXXX"
• "Salve que o endpoint da API de pagamentos é https://api.pagamentos.com/v2"
• "Salve a solução do erro 503: reiniciar o serviço X com sudo systemctl restart x"

Como buscar conhecimento?

Use comandos naturais ou o agente automaticamente consulta a memória:

• "Busque na memória como configurar o Google Workspace"
• "Lembra daquela configuração de firewall que fizemos?"
• "Qual era a URL do ambiente de staging?"

Memória Privada vs Compartilhada

• Privada (default): Só o agente que salvou pode ver — útil para dados pessoais ou temporários
• Compartilhada (shared=true): Todos os agentes do swarm enxergam — ideal para conhecimento do time como configurações de deploy, credenciais de serviço e guias de troubleshooting

Boas Práticas

Use descrições claras — "token X" é melhor que "aquela coisa"
Prefira memória compartilhada para conhecimento que beneficia o time
Consulte a memória antes de perguntar a mesma coisa duas vezes
Combine com Document Parsing: extraia → salve → consulte depois

---

English

What is the TacFlow memory system?

The persistent memory system is the secondary brain of TacFlow agents. Every important discovery, configuration, or bug fix can be saved and retrieved later.

How to save knowledge?

You can save information in two ways:

1. Natural command: Just say "Save this to memory: [information]"
2. Direct tool: The agent uses the memory-store skill to persist the data

Examples:

• "Save to memory: the production token is sk_live_XXXX"
• "Save that the payments API endpoint is https://api.payments.com/v2"
• "Save the error 503 fix: restart service X with sudo systemctl restart x"

How to search knowledge?

Use natural commands or the agent automatically queries memory:

• "Search memory for how to configure Google Workspace"
• "Remember that firewall configuration we set up?"
• "What was the staging environment URL?"

Private vs Shared Memory

• Private (default): Only the agent who saved it can see it — good for personal or temporary data
• Shared (shared=true): Every agent in the swarm can see it — ideal for team knowledge like deployment configs, service credentials, and troubleshooting guides

Best Practices

Use clear descriptions — "production token" is better than "that thing"
Prefer shared memory for team-wide useful knowledge
Check memory before asking the same question twice
Combine with Document Parsing: extract → save → retrieve later

️ Desktop Automation — Controle de Tela, Mouse e Teclado

Português

O que é?
Controle remoto da sua tela de computador: capturar screenshots, mover o mouse, clicar, digitar texto e pressionar teclas — tudo através do agente.

Como usar:

• "Tire um screenshot da tela"
• "Clique no botão X na posição (100, 200)"
• "Digite senha123 no campo de login"
• "Pressione Ctrl+C"

Exemplos de uso:

• Testes automatizados de interface de usuário (UI)
• Automação de processos repetitivos (RPA)
• Tutoriais interativos guiados passo-a-passo
• Preenchimento automático de formulários

Nota técnica:
Requer CGO habilitado e um servidor gráfico (display server) ativo. Disponível em sistemas Linux/macOS desktop.

---

English

What is it?
Remote control of your computer screen: capture screenshots, move the mouse, click, type text, and press keys — all through the agent.

How to use:

• "Take a screenshot"
• "Click the X button at position (100, 200)"
• "Type password123 in the login field"
• "Press Ctrl+C"

Use cases:

• Automated UI testing
• Robotic Process Automation (RPA)
• Interactive step-by-step tutorials
• Automatic form filling

Technical note:
Requires CGO enabled and an active display server. Available on Linux/macOS desktop systems.