# Documentação Adapta

Aprenda a navegar, buscar, praticar com casos de uso e aproveitar os recursos do Adapta Guides.

Fonte: https://guides.adapta.org/guias/inicio/

**TL;DR** · Use a busca para encontrar um recurso, os guias dos produtos para aprender em sequência e os casos de uso para partir de uma tarefa real. Leia o resumo, siga os passos com imagens e confira o resultado. Você também pode compartilhar o artigo, baixar seu Markdown e continuar pelo celular.

## Um caminho para cada objetivo

Não precisa ler tudo em ordem. Escolha o caminho que combina com o que você quer fazer agora.

|  Seu objetivo |  Por onde começar |
| --- | --- |

|  Conhecer as possibilidades e escolher um produto |  [One, Maestro ou Skip?](https://guides.adapta.org/guias/comece-aqui/qual-produto-usar/) |

|  Encontrar um botão, uma configuração ou um recurso |  [Todos os artigos](https://guides.adapta.org/artigos/) e a busca no topo |

|  Aprender fazendo uma primeira entrega |  [Primeiros passos](https://guides.adapta.org/comece-aqui/) |

|  Adaptar um exemplo para sua rotina |  [Catálogo de casos de uso](https://guides.adapta.org/casos-de-uso/) |

|  Resolver acesso, cobrança ou pedir atendimento |  [Encontre ajuda](https://guides.adapta.org/guias/aprenda-e-encontre-ajuda/ajuda/) |

|  Preparar informações antes de usar IA |  [Cuidados com seus dados](https://guides.adapta.org/guias/aprenda-e-encontre-ajuda/privacidade/) |

Você pode consultar os guias públicos sem entrar em uma conta. **Entrar**, no cabeçalho, leva ao ambiente da Adapta para usar os produtos.

## Encontre e aproveite seu primeiro artigo

1. **Explore a biblioteca**

    Abra [Todos os artigos](https://guides.adapta.org/artigos/). Use **Buscar artigos** para procurar um título ou assunto e selecione **One**, **Maestro** ou **Skip** para restringir a lista ao produto. **Todos** volta a reunir os produtos.

    Leia a descrição do card antes de abrir: ela explica o que você vai aprender. Ao chegar ao fim da lista visível, **Mostrar mais artigos** carrega a próxima parte.

![Biblioteca do Guides com busca, filtros por produto e cards de artigos](https://guides.adapta.org/media/guides-tour/biblioteca.png)

    *A biblioteca ajuda a explorar um produto; o campo de busca reduz a lista ao assunto desejado.*

2. **Faça uma busca direta**

    Selecione a lupa ou **Buscar na documentação** no topo. No computador, o atalho **⌘ K** no Mac ou **Ctrl K** abre a busca. Digite o nome de um recurso, como **skills**, ou a tarefa que precisa realizar.

    Confira o produto e a descrição de cada resultado. Recursos com nomes parecidos podem funcionar de maneiras diferentes no One e no Maestro. Se a busca ficou ampla, acrescente o produto ou uma ação: **conectores Maestro**, por exemplo. Use **Esc** ou o botão de fechar para voltar à página.

![Busca global por skills com resultados da documentação](https://guides.adapta.org/media/guides-tour/busca.png)

    *O título encontra o assunto; o contexto do resultado ajuda a escolher a página certa.*

3. **Entenda onde você está**

    Ao abrir um artigo, confira o título, a descrição e o **TL;DR**, o resumo inicial. Eles mostram a finalidade do guia antes de você entrar nos detalhes.

    A navegação lateral reúne os guias do produto. O caminho acima do título ajuda a voltar à área de origem. **Neste artigo** leva diretamente às seções da página atual: use-o para retomar uma etapa sem procurar por toda a página.

![Artigo Conversas com navegação do One, resumo inicial e sumário de seções](https://guides.adapta.org/media/guides-tour/artigo.png)

    *A lateral troca de guia; o sumário navega dentro do artigo que você está lendo.*

4. **Leve o guia para outra pessoa**

    Abra **Compartilhar**, abaixo da apresentação do artigo. Copie o link para enviar a um colega ou escolha uma das opções disponíveis. O link identifica aquele artigo, para a pessoa chegar ao mesmo conteúdo.

    Para Instagram ou TikTok, baixe a capa e prepare a publicação no aplicativo. Acrescente o link onde a plataforma permitir. Baixar a imagem não publica nada automaticamente.

![Menu de compartilhamento aberto no artigo Conversas](https://guides.adapta.org/media/guides-tour/compartilhar.png)

    *Compartilhe a página para leitura ou use a capa como apoio visual da sua publicação.*

## Escolha seu produto e pratique

One

Use os guias do One para trabalhar em conversas, preparar pedidos, escolher modelos e usar arquivos. Comece com uma tarefa pequena e um resultado que você consiga conferir.

[Comece no One](https://guides.adapta.org/guias/one/comece-aqui/inicio/) · [Escreva um bom pedido](https://guides.adapta.org/guias/one/comece-aqui/preparar-pedidos/) · [Explore os recursos](https://guides.adapta.org/one/)

Maestro

Explore o Maestro quando a tarefa envolver ferramentas, fontes conectadas ou uma rotina com várias etapas. Antes de reproduzir o exemplo, confira os materiais, as permissões e o resultado esperado.

[Comece no Maestro](https://guides.adapta.org/guias/maestro/comece-aqui/inicio/) · [Primeira entrega](https://guides.adapta.org/guias/maestro/comece-aqui/primeira-entrega/) · [Explore os recursos](https://guides.adapta.org/maestro/)

Skip

Use os guias do Skip para transformar uma necessidade em um aplicativo. Comece definindo quem vai usar, o que essa pessoa precisa fazer e como você vai testar o fluxo.

[Comece no Skip](https://guides.adapta.org/guias/skip/comece-aqui/inicio/) · [Explore os recursos](https://guides.adapta.org/skip/)

## Leia os exemplos com intenção

Cada elemento tem uma função. Você não precisa ler um artigo inteiro para voltar a um detalhe, mas vale seguir a sequência completa ao experimentar algo pela primeira vez.

|  Elemento |  Como aproveitar |
| --- | --- |

|  TL;DR |  Confira rapidamente o resultado e as condições principais. |

|  Passos numerados |  Execute uma etapa por vez e compare com a imagem antes de avançar. |

|  Capturas e legendas |  Localize o controle e entenda o que deve observar na tela. |

|  Blocos de pedido |  Reaproveite a estrutura e substitua os dados demonstrativos. |

|  Tabelas |  Compare opções, requisitos e diferenças entre recursos. |

|  Seções expansíveis |  Abra a alternativa que corresponde ao seu produto ou situação. |

|  Avisos |  Confira limites e cuidados antes de enviar dados ou realizar uma ação. |

|  Links relacionados |  Continue pelo recurso necessário para sua próxima tarefa. |

**Compare o resultado, não só a aparência.** Uma captura mostra um momento da interface. Confira também os nomes dos controles e a finalidade da etapa. Se a tela da sua conta estiver diferente, procure o guia do recurso ou consulte a Central de Ajuda.

## Transforme um caso de uso em trabalho real

O [catálogo de casos de uso](https://guides.adapta.org/casos-de-uso/) parte de tarefas: analisar dados, preparar conteúdo, organizar trabalho ou construir um sistema. Os destaques ajudam a descobrir ideias; os filtros ajudam a encontrar uma que faça sentido para você.

![Catálogo de casos de uso com apresentação e exemplos em destaque](https://guides.adapta.org/media/guides-tour/casos.png)

*Escolha uma tarefa pela entrega que você precisa produzir, depois confira o produto e os recursos envolvidos.*

Busque uma tarefa, selecione um produto e explore as áreas. No celular, abra **Filtrar casos de uso** para acessar esses controles. Combine poucos filtros de cada vez; limpe-os se quiser ampliar a lista.

Ao abrir um caso, procure quatro respostas:

1. **Qual é a entrega?** Entenda o objetivo e como o resultado será usado.

2. **O que preciso preparar?** Separe arquivos, contexto e exemplos necessários.

3. **Quais recursos participam?** Confira as skills, ferramentas e os conectores indicados naquele caso, quando houver.

4. **Como vou conferir?** Revise números, fontes, formato e condições antes de aproveitar a entrega.

Quando o caso oferecer um modelo de skill para baixar, leia as instruções e adapte-o à sua rotina. Um arquivo de exemplo não conecta contas nem autoriza ações por você. Para conectores, confirme a conta, a fonte e as permissões no produto.

**Comece com dados demonstrativos.** Substitua as informações do exemplo somente depois de entender o fluxo. Leia [Cuidados com seus dados](https://guides.adapta.org/guias/aprenda-e-encontre-ajuda/privacidade/) antes de incluir material de trabalho.

Se encontrar votação no catálogo, considere-a uma demonstração: as contagens são ilustrativas e sua escolha fica neste navegador. Ela não representa uma votação global da comunidade.

## Continue pelo celular

No celular, a navegação fica concentrada no topo. A **lupa** abre a busca e **Abrir menu** reúne os caminhos do Guides, os produtos, a ajuda e a opção de tema.

Dentro de um artigo de produto, **Guias do One**, **Guias do Maestro** ou **Guias do Skip** abre a lista de páginas. **Neste artigo** abre o sumário da leitura atual. Escolha uma seção para ir direto ao trecho que precisa.

![Artigo do One no celular com lupa, menu e atalhos Guias do One e Neste artigo](https://guides.adapta.org/media/guides-tour/mobile.png)

*Você pode trocar de guia ou abrir o sumário sem percorrer toda a página.*

Se uma tabela for mais larga que a tela, deslize a própria tabela na horizontal. Nos carrosséis de cards, deslize para ver outros conteúdos. No computador, use também as setas disponíveis.

## Compartilhe e guarde os materiais

|  O que você quer fazer |  Recurso |
| --- | --- |

|  Enviar o artigo em uma conversa |  Abra **Compartilhar** e copie o link. |

|  Preparar uma publicação |  Escolha X, Facebook, LinkedIn ou outra opção disponível e revise no serviço de destino. |

|  Enviar por mensagem ou e-mail |  Use WhatsApp, Telegram ou e-mail no menu. |

|  Usar outro aplicativo do aparelho |  Use a opção de compartilhamento do dispositivo, quando disponível. |

|  Publicar uma capa no Instagram ou TikTok |  Baixe a capa, envie a imagem no aplicativo e acrescente o link. |

|  Guardar o texto para consulta |  Use **Baixar artigo em Markdown**, no fim do artigo. |

O Markdown é uma versão em texto com estrutura e links. Ele não é uma cópia completa do site para uso offline: imagens e destinos vinculados podem precisar de internet. Para voltar à versão atualizada, guarde também o link da página.

## Ajuste a leitura e encontre os atalhos

**Tema claro ou escuro.** Use o botão de tema no cabeçalho. No celular, a opção fica no menu. Escolha o que deixa a leitura mais confortável no seu ambiente.

**Voltar ao início.** Selecione o logo Adapta Guides. No computador, **Explorar** e **Todos os recursos** também oferecem caminhos de navegação; o rodapé reúne atalhos úteis por produto.

**Obter a marca.** No computador, clique com o botão direito no logo para abrir as opções de marca. Você pode abrir o site ou o logo em outra aba, copiar o logo e baixar o logo ou o favicon. Pelo teclado, foque o logo e use **Shift + F10**.

**Avaliar o artigo.** Use **Este artigo ajudou?** para marcar sua avaliação. A seleção fica salva neste navegador; esse controle não abre um chamado de atendimento.

## Quando você precisar de ajuda

O **Guides** ensina a usar recursos e aplicar exemplos. A [Central de Ajuda](https://ajuda.adapta.org/) reúne orientações de atendimento, acesso, conta e pagamentos em outro site.

Para se localizar por lá, abra [Encontre ajuda na Central da Adapta](https://guides.adapta.org/guias/aprenda-e-encontre-ajuda/ajuda/). O guia mostra a busca, as categorias e como encontrar os canais de atendimento.

Ao relatar um problema, inclua o produto, a página, o que queria fazer e o que aconteceu. Uma captura sem dados sensíveis ajuda a explicar a situação. Nunca envie senha, código de autenticação ou chave de integração.

## Experimente agora

Escolha uma tarefa pequena e complete este percurso:

- Encontre um artigo pela busca e confira o produto do resultado.

- Use **Neste artigo** para abrir a seção de que precisa.

- Siga o exemplo com dados demonstrativos e compare sua entrega com os critérios do guia.

- Abra um caso de uso relacionado e identifique o que mudaria para sua rotina.

- Compartilhe o link com quem vai revisar ou baixe o Markdown para guardar o roteiro.

**Seu ponto de chegada:** saber encontrar uma orientação, aplicar o exemplo e explicar como conferiu o resultado. Quando isso estiver claro, avance para uma tarefa maior.