> For the complete documentation index, see [llms.txt](https://docs.velogicfit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.velogicfit.com/pt-br/secao-03-calibracao-e-medicao/bikefinder-integration.md). # Integração BikeFinder Como usar a integração BikeFinder do Velogic Studio Pro para sugerir quadros-alvo e configurações de mesa para um posicionamento ideal do bike fit. > **Nota:** Este recurso está disponível apenas no Velogic Studio Pro. Ele não está disponível no Velogic Studio Essentials. ## Justificativa Ajudar seu cliente a selecionar e/ou configurar uma nova bike adequada é frequentemente considerado parte de um bike fit. A integração do bikefinder do Velogic Studio ajuda você a tornar isso uma parte integrada da sua oferta de bike fit. ### Se eles tiverem uma bike específica em mente: use "Quadros-alvo" Clientes de bike fit geralmente chegam a um bike fit com um destes cenários: * uma bike existente, querendo ser ajustados a essa bike (o que pode ser complicado se ela não for a bike certa para eles) * ou antes da compra, mas com uma bike específica em mente, e querendo saber o tamanho certo desse modelo. Depois de realizar o ajuste, muitos bike fitters então definem opções para seu cliente: * Se eles tinham uma bike existente, mas foram ajustados para uma posição de barXY diferente: você precisa encontrar uma configuração de mesa/espacadores para alcançar essa posição * Se eles tinham uma bike específica em mente, você precisa sugerir o melhor tamanho E então encontrar uma configuração de mesa/espacadores para atingir o XY-alvo deles. O Velogic Studio pode ajudar sugerindo automaticamente uma combinação de mesa/espacadores e, opcionalmente, o tamanho do quadro durante o ajuste. Sempre que você medir o quadro (manual ou com nossa haste de medição), e as medições incluírem BarX e BarY, o Velogic Studio fará uma sugestão. Leia mais na seção "Escolhendo quadro(s)-alvo" abaixo. ### Se eles quiserem sugestões de bikes: use "Busca online" Se o seu cliente ainda não estiver decidido por um modelo específico, você pode enviar para casa um relatório mostrando algumas opções que provavelmente funcionarão para ele. Leia mais na seção "Busca online" abaixo. ## Escolhendo quadro(s)-alvo No início de um ajuste, ou em qualquer momento durante o ajuste, você pode adicionar um quadro-alvo. Na Etapa 1: Configuração, basta clicar em "Adicionar quadro-alvo": ![Interface da Etapa 1: Configuração do Velogic Studio com o botão 'Adicionar quadro-alvo' na seção Quadros-alvo](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-6af8ceb87058fc35367ec93abc6a5352c9b3b6b7%2F7e94befa.png?alt=media) > **Nota:** Se você não vir a área Quadros-alvo, talvez você não esteja no nível Pro do Velogic Studio, ou talvez precise ativar o plugin BikeFinder (Configurações -> Plugins) Você verá uma janela pop-up de Busca de quadro, onde você insere um termo de busca: ![Janela pop-up de Busca de quadro com campo de entrada de busca para inserir informações de marca, modelo e ano da bike](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-c35b8990a50fa577ce4dbb2895717f3edb69eca1%2Fba905c0e.png?alt=media) O termo de busca é texto livre, então você pode incluir marca, modelo e/ou ano. Será retornado um máximo de 30 resultados; se o quadro que você procura não estiver no conjunto de resultados, mas houver muitos resultados, talvez seja necessário ser mais específico. Se você não conseguir encontrar um quadro que acredita que deveria estar no banco de dados, entre em contato conosco () para solicitar que ele seja adicionado. Assim que você puder ver o quadro que está procurando, clique nele e você o verá aparecer no lado direito da janela de busca: ![Resultados da busca de quadros mostrando o quadro de bike selecionado com opções de tamanho e o botão 'Adicionar quadro-alvo'](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-17320deb56f654bf328be05b1a0e19fd34006584%2Fbf22a511.png?alt=media) Você tem a opção de selecionar um tamanho específico de quadro (por exemplo, se seu cliente já tiver a bike), ou deixar o tamanho como "Qualquer" para que o Velogic Studio sugira um tamanho de quadro. Clique em "Adicionar quadro-alvo" e a janela pop-up de busca será fechada e o quadro será adicionado à área Quadros-alvo: ![Seção Quadros-alvo exibindo o quadro de bike adicionado com opções de configuração para Tolerância BarXY e Protrusão do selim](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-ae514f3e97bf86c606af85ca53348c120bb31f63%2F31c27925.png?alt=media) > **Nota:** Você pode ter vários quadros-alvo para o mesmo modelo, com tamanhos diferentes. Por exemplo, se seu cliente usa tamanho 'M', você pode adicionar um quadro-alvo para esse tamanho e um segundo quadro-alvo para o mesmo modelo, mas com tamanho "Qualquer". Depois, você pode comparar a melhor configuração de mesa/espacadores para o tamanho dele e também o tamanho ideal sugerido. Depois de adicionar um ou mais quadros-alvo, você verá opções para Tolerância BarXY e Protrusão do selim no topo da área Quadros-alvo. Ambas são opcionais, mas se você ativá-las, poderá adicionar parâmetros usados para gerar as recomendações: ![Configuração de quadro-alvo mostrando as definições de Tolerância BarXY e Protrusão do selim para recomendações de ajuste precisas](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-76215d5ac13464a31660295d00625a0ba2f488b1%2Fbikefinder-add-target-frame.png?alt=media) * Se você especificar uma Tolerância BarXY (mm), o Velogic Studio nunca sugerirá uma configuração de mesa/espacadores que fique além da distância especificada do bar XY-alvo. * Se você especificar uma Protrusão do selim (%), e depois medir a altura do selim, o Velogic Studio também verificará se o canote do selim + selim "sobressaem" pelo menos a porcentagem especificada da altura total do selim acima do tubo do selim. Isso serve para evitar uma situação em que um ciclista mais baixo em uma posição agressiva receba a sugestão de um quadro grande (para alcançar o alcance desejado), MAS o selim ficaria completamente abaixado no quadro (ou seria forçado a ficar mais alto do que a altura ideal pelo tubo do selim). Para mais informações, veja "O que é Protrusão do selim" na seção de FAQ abaixo. ## Obtendo sugestões para quadros-alvo durante a medição Quando você tiver adicionado alguns quadros-alvo e medir o quadro com a haste de medição (ou inserir medições manuais), você verá tamanhos de quadro e/ou combinações de mesa/espacadores sugeridos para alcançar esse barXY (e opcionalmente a altura do selim): ![Sugestões do BikeFinder exibindo tamanhos de quadro e configurações de mesa recomendados com métricas de precisão para cada quadro-alvo](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-1fd222b1a632832d2a4ba035737779319f24287c%2Fbikefinder-frame-search.png?alt=media) Para cada quadro-alvo que você adicionou na etapa 1, você verá uma sugestão, contendo: * A marca, o modelo e o ano do quadro-alvo * O tamanho-alvo que você selecionou * Um tamanho sugerido (somente se você selecionou "Qualquer" para o tamanho-alvo) * Uma configuração de mesa sugerida, por exemplo, "120 mm +8°, 15 mm esp." * **120 mm** é o comprimento da mesa * **+8°** significa uma mesa de 8°, inclinada para cima (se o sinal fosse negativo, por exemplo, -8°, isso significaria que a mesa estaria inclinada para baixo) * **15 mm esp.** significa 15 mm de espaçamento do topo do tubo da caixa de direção até a parte inferior da mesa. > **Nota:** O número de espaçadores é contado a partir do topo do tubo da caixa de direção. Você precisa medir e subtrair a altura dos copos e da tampa do headset/anel superior para determinar os espaçadores físicos a serem adicionados. * Informações sobre o quão próxima a sugestão está da sua medição-alvo: * Bar X e Bar Y mostram quantos milímetros a sugestão excedeu o alvo (ou ficou aquém se negativo) * Saddle mostra a porcentagem de protrusão do selim (veja a FAQ) Quando você clicar em Concluir, as medições serão adicionadas ao Registro do ajuste. ## Visualizando sugestões de quadro no registro do ajuste Ao visualizar o registro do ajuste, você verá uma seção "Quadros-alvo" dentro da seção "Métrica da bike", com uma linha por quadro-alvo. Cada linha de quadro-alvo mostrará uma sugestão para cada coluna de medição, para que você possa ver a sugestão para diferentes posições que você mediu durante o ajuste. ![Seção Quadros-alvo do registro do ajuste mostrando sugestões de quadro em diferentes posições de medição com recomendações de mesa e espaçadores](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-90b5de3bc3782656110346c410d7fad2eb035f93%2Fbikefinder-frame-selected.png?alt=media) Se o Velogic Studio não conseguir fazer uma sugestão (porque não encontrou um tamanho de quadro e uma combinação de mesa/espacadores dentro da tolerância especificada do bar XY-alvo), ele mostrará "Sem sugestão". Se você não especificar uma tolerância de bar XY, então o Velogic Studio sempre fará uma sugestão, mesmo que ela seja ridiculamente grande (ou pequena) para a posição barXY-alvo. Nesse caso, você pode ler os erros de BarX e Bar Y, e a protrusão do selim, na linha de texto inferior para decidir se é aceitável. ## Busca online Você pode usar o recurso Busca online do módulo BikeFinder ao fazer medições ou revisar uma medição existente. ![Interface de Busca online exibindo várias opções de quadros de bike com classificações de compatibilidade para a posição medida do ciclista](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-b7314f5a1a7f6bf17047edf78486d4d464ad1817%2Fbikefinder-frame-suggestions.png?alt=media) ## FAQ ### P. Posso usar o recurso Quadros-alvo offline? R. Não. Este recurso se conecta ao banco de dados online de quadros do Velogic, então o recurso não funcionará se você estiver offline. No entanto, você pode realizar um ajuste offline e, depois, quando estiver online novamente, pode adicionar quadros-alvo para obter sugestões para o ajuste. ### P. E se eu não gostar da sugestão para um quadro-alvo? R. Entre em contato e explique os detalhes da recomendação que você recebeu e por que ela não era o que você esperava. Nosso mecanismo de sugestões está em constante aprimoramento para oferecer os melhores resultados em várias situações. ### P. O que é protrusão do selim? R. A altura do selim (distância do rolamento inferior até o topo do selim) é obtida por meio de 3 componentes ou etapas, de baixo para cima: * o tubo do selim (do movimento central até o topo do tubo do selim) * depois a parte visível do canote do selim * e então o próprio selim. A Protrusão do selim é simplesmente a porcentagem da altura do selim que vem da parte visível do canote e do selim. É uma medida de quanto o canote do selim "sai para fora" do tubo do selim. O Velogic Studio mostrará a porcentagem de protrusão do selim se você tiver medido uma altura do selim e se tivermos dados de SeatTubeCT disponíveis para o quadro selecionado (o que na maioria das vezes temos). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.velogicfit.com/pt-br/secao-03-calibracao-e-medicao/bikefinder-integration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.