Skip to main content
Glama
Sign In

GuiaFlow

by pro.guiaflow
OverviewDiscussionsAdmin

Criar tour

create_tour

Cria um tour vazio na conta (aparece no editor do GuiaFlow com a etiqueta "criado por agente"). Depois use add_step para cada captura. Para tours de fotos use um modelo, que já começa no modo Galeria e nomeia as cenas: template "empreendimento" (imóvel/lançamento: Fachada, Lazer, Plantas, Localização), "veiculo" (carro/moto: Exterior, Interior, Detalhes, Ficha técnica) ou "produto" (e-commerce/catálogo: Visão geral, Detalhes, Em uso, Medidas e variações). "software" (padrão) começa em Tour guiado. A resposta traz scaffold.scenes com o número de cada cena e o que fotografar; use o número em scene no add_step. mode ("guided" | "gallery") escolhe o modo direto; o usuário troca depois no editor.

Input Schema

NameRequiredDescriptionDefault
modeNoModo de exibição. "guided" (padrão): tour guiado com balões, destaques, avanço automático e narração. "gallery": galeria de fotos em tela cheia (imóveis, veículos, produtos, catálogos): arrastar ou setas, contador "N de M", legenda de uma linha com "Detalhes", zoom (plantas, detalhes), seções pelos nomes das cenas, miniaturas, vídeo só no clique. Na galeria não há balões, destaques, avanço automático nem narração.
nameYesNome do tour.
themeNo
templateNoModelo do tour. "empreendimento" (imóvel), "veiculo" (carro, moto) e "produto" (e-commerce, catálogo) começam em Galeria com as cenas nomeadas; "software" (padrão) começa em Tour guiado.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / mode / description
      Previous value: -"Modo de exibição. \"guided\" (padrão): tour guiado com balões, destaques, avanço automático e narração. \"gallery\": galeria de fotos em tela cheia (imóveis): arrastar ou setas, contador \"N de M\", legenda de uma linha com \"Detalhes\", zoom (plantas), seções pelos nomes das cenas, miniaturas, vídeo só no clique. Na galeria não há balões, destaques, avanço automático nem narração."New value: +"Modo de exibição. \"guided\" (padrão): tour guiado com balões, destaques, avanço automático e narração. \"gallery\": galeria de fotos em tela cheia (imóveis, veículos, produtos, catálogos): arrastar ou setas, contador \"N de M\", legenda de uma linha com \"Detalhes\", zoom (plantas, detalhes), seções pelos nomes das cenas, miniaturas, vídeo só no clique. Na galeria não há balões, destaques, avanço automático nem narração."
    • changedInput schema / properties / template / description
      Previous value: -"Tipo de tour. \"empreendimento\" (imóvel/lançamento) começa em Galeria; \"software\" (padrão) começa em Tour guiado."New value: +"Modelo do tour. \"empreendimento\" (imóvel), \"veiculo\" (carro, moto) e \"produto\" (e-commerce, catálogo) começam em Galeria com as cenas nomeadas; \"software\" (padrão) começa em Tour guiado."
    • changedInput schema / properties / template / enum
      Previous value: -[
-  "empreendimento",
-  "software"
-]New value: +[
+  "software",
+  "empreendimento",
+  "veiculo",
+  "produto"
+]
  2. Changed2 schema fields changed
    • addedInput schema / properties / mode
      Added value: +{
+  "description": "Modo de exibição. \"guided\" (padrão): tour guiado com balões, destaques, avanço automático e narração. \"gallery\": galeria de fotos em tela cheia (imóveis): arrastar ou setas, contador \"N de M\", legenda de uma linha com \"Detalhes\", zoom (plantas), seções pelos nomes das cenas, miniaturas, vídeo só no clique. Na galeria não há balões, destaques, avanço automático nem narração.",
+  "enum": [
+    "guided",
+    "gallery"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / template
      Added value: +{
+  "description": "Tipo de tour. \"empreendimento\" (imóvel/lançamento) começa em Galeria; \"software\" (padrão) começa em Tour guiado.",
+  "enum": [
+    "empreendimento",
+    "software"
+  ],
+  "type": "string"
+}
  3. Changed1 schema field changed
    • addedInput schema / properties / theme / properties / font
      Added value: +{
+  "description": "Fonte do tour (balões, slides, cartões). \"default\" volta à fonte padrão do tema.",
+  "enum": [
+    "default",
+    "inter",
+    "roboto",
+    "open-sans",
+    "lato",
+    "montserrat",
+    "poppins",
+    "nunito",
+    "merriweather",
+    "source-serif"
+  ],
+  "type": "string"
+}
  4. First observed

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds useful behavior beyond the annotations: the tour appears in the editor with the "criado por agente" label, and the response includes scaffold.scenes with scene numbers to pass to add_step. It still leaves some ambiguity about how mode and template interact when both are supplied, but the main side effects and follow-up workflow are disclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core action, then gives the follow-up step, template guidance, and mode behavior in a compact sequence. The template details are dense but each one helps the agent choose the right parameter value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a creation tool with no output schema, the description is fairly complete: it explains the immediate side effect, the next tool to call, and the shape of the scaffold.scenes response. The remaining gap is that theme behavior and template/mode precedence are not addressed, though the schema covers theme fields.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 75%, so the schema already documents most parameters. The description adds practical meaning for template by listing scene names and intended use cases, and notes that mode can be changed later in the editor. Theme is not mentioned in the description, but it is fully covered by the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb and resource: "Cria um tour vazio na conta". It also distinguishes the next action by naming add_step for captures, so the agent can tell this is the creation step rather than a step-adding or editing tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly says to use add_step after creating the tour for each capture, and it routes photo tours to specific templates with detailed use cases. The alternatives are named and the selection criteria are clear, including the default "software" guided-tour case.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All GuiaFlow toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources