> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/gestao-and-operacao/comece-aqui/onboarding-fortics-ia.md). # Onboarding Fortics IA O **Onboarding Inicial** é responsável por guiar as primeiras configurações da Fortics AI. No primeiro acesso, a plataforma inicia automaticamente um assistente que conduz você pelas etapas necessárias para começar a utilizar o sistema. Durante esse processo, você irá configurar os dados da conta, aceitar os termos de uso, conectar o provedor de inteligência artificial e selecionar um segmento de atuação para aplicar configurações iniciais e acelerar a criação dos seus primeiros agentes. ## Tela de boas vindas Nesta primeira tela, você receberá as boas-vindas à plataforma e verá uma apresentação geral sobre o propósito do ecossistema. Leia o texto para se ambientar e para começar a configurar o sistema, basta clicar no botão **"Iniciar"** no canto inferior direito. ## Termos de uso e funcionalidades Aqui você verá os termos de uso da plataforma. Leia atentamente o texto apresentado para entender as suas responsabilidades e direitos ao utilizar a Fortics AI, onde são detalhados os recursos que fazem a diferença na sua operação. Para avançar, você deve rolar a página, marcar explicitamente a caixa de seleção afirmando que leu e aceitou os termos e, em seguida, clicar no botão **"Avançar"**, que será desbloqueado logo após a marcação. ## Informando seus dados No primeiro acesso, você deverá definir as informações permanentes da conta do administrador. Preencha os dados essenciais para criar o seu acesso seguro e estruturar a conta do administrador na plataforma. O formulário exige que você digite o seu nome completo, insira um endereço de e-mail corporativo principal e defina uma senha segura, confirmando-a no campo logo abaixo. Fique atento ao alerta visual destacado na cor amarela: ele serve para lembrar você de garantir a inserção de um e-mail válido, evitando falhas de comunicação ou problemas na liberação dos seus recursos nas próximas etapas antes de clicar em "**Avançar"**. ## Conectando sua ferramenta de IA Nesta etapa, você irá configurar o provedor de IA que será utilizado pelos seus Agentes. A tela é dividida em duas áreas. À esquerda, selecione o provedor desejado. À direita, preencha os campos correspondentes. **Opção OpenAI:** Informe a sua **API Key** e selecione o modelo que deseja utilizar (*como o padrão gpt-5.1- instant*, otimizado para conversas rápidas). **Opção Gemini:** Você deve fazer o upload do arquivo JSON de credenciais da sua conta clicando em "**Conta de serviço Google**" (*Choose File*) e selecionar a versão do modelo correspondente no menu suspenso. **Opção Gemini Free**: Você usará uma versão gratuita disponibilizada para testes básicos. Para essa opção você pode colocar uma chave de uso gratuita do *Google AI Studio* e depois selecionar o modelo que deseja utilizar. {% hint style="danger" %} **##Importante** A opção *Gemini Free* é recomendada apenas para testes e possui limitações de uso e processamento. {% endhint %} ## Selecione o escopo de trabalho {% hint style="warning" %} **## Dica** Iniciando nesse ponto, todas as configurações podem ser feitas em um momento posterior, inclusive selecionando o escopo de trabalho que vamos apresentar abaixo, seja na criação dos agentes ou no assistente que você pode executar a qualquer momento na interface.\ \ Caso deseje iniciar o uso da plataforma para depois efetuar essas configurações basta selecionar a opção configuração manual e você será direcionado direto para a tela de conclusão do assistente. {% endhint %} Nesta etapa, você deve selecionar o segmento de atuação que melhor representa o seu negócio. Esta escolha permite que a plataforma aplique automaticamente templates e pré-configurações para seu trabalho, facilitando a criação do seu primeiro agente. Você deve escolher uma das três alternativas disponíveis na interface. {% hint style="info" %} **## Informação** As opções oferecidas refletem configurações automatizadas que foram criadas pela nossa equipe de desenvolvedores, esse é um processo contínuo e com o tempo vamos oferecer outros tipos de integrações. Essas mesmas opções poderão ser selecionadas na criação manual de um agente para novos agentes que criar na plataforma após concluir as configurações iniciais. {% endhint %} **Provedor de Internet:** Selecione esta opção se a sua empresa for um provedor de internet, ISP ou telecomunicações. Ao avançar, a tela mostrará uma listagem com os principais sistemas integradores do mercado (como *Elite Soft, TopSapp, IXCSoft, Grupo Voalle, SGP TSMX, MK Solutions, RBXSoft e Hubsoft*) para você selecionar o seu software de gestão. **Varejo:** Selecione esta opção se a sua operação for focada em comércio eletrônico. Ao avançar, a interface abrirá os campos de credenciais necessários para integrar nativamente com a plataforma **VTEX**, solicitando dados como *AppKey, AppToken*, nome da conta e URLs da loja. **Configuração manual**: Selecione esta opção caso o seu modelo de negócio não se enquadre nos ramos anteriores. Ao clicar neste card, você desativa os assistentes engessados e ganha total liberdade para construir suas bases de dados e prompts manualmente, direto pelo painel de controle, assim que o onboarding for concluído. ### Selecionando a opção provedores Ao selecionar a opção provedores você verá uma lista de plataformas pré configuradas que oferecemos. Selecione a opção que deseja usar e clique em avançar. Na tela seguinte, independentemente da opção selecionada, você terá que colocar os dados para configurar a integração. Após inserir os dados, clique em avançar. {% hint style="warning" icon="lightbulb-exclamation-on" %} **##Dica** Caso tenha dúvidas sobre os dados solicitados por uma integração, consulte a documentação ou o suporte da plataforma correspondente. As informações deste onboarding serão [salvas na sessão de credenciais](/gestao-and-operacao/tutoriais/fortics-ia/integracoes/gerenciando-credenciais.md) da plataforma do Fortics IA e poderão ser editadas posteriormente.
{% endhint %} ### Selecionando a opção varejo Após selecionar a opção **Varejo**, informe os dados necessários para configurar a integração com a VTEX. ## Selecionando um tipo de agente Após salvar as suas credenciais técnicas, a plataforma direcionará você automaticamente para a tela de seleção de tipos de agentes. Ao escolher uma das opções disponíveis na lista que melhor represente o seu modelo de negócio, o sistema criará de forma 100% automática um agente base estruturado sob medida para a tarefa selecionada. Este novo agente gerado já virá de fábrica configurado e pronto para o uso, estando nativamente amarrado à ferramenta de integração que você acabou de salvar, conectado ao motor de inteligência artificial (LLM) escolhido e parametrizado com todas as diretrizes e regras básicas necessárias para o seu funcionamento imediato. Após selecionar o tipo de agente clique em **salvar**. Ao concluir as configurações iniciais, a plataforma exibirá um roteiro com as próximas etapas recomendadas para começar a utilizar a Fortics AI. Entre as primeiras ações estão a criação dos [conteúdos que alimentarão](/gestao-and-operacao/tutoriais/fortics-ia/gerenciando-conteudo/como-adicionar-conteudos-na-fortics-ia.md) a IA, a organização dessas informações em [Bases de Conhecimento](/gestao-and-operacao/tutoriais/fortics-ia/gerenciando-conteudo/criando-uma-base-de-conhecimento.md), a [configuração dos Agentes](/gestao-and-operacao/tutoriais/fortics-ia/agentes-de-ia/criando-e-editando-agentes.md) e a realização dos primeiros testes no Playground. Cada uma dessas etapas possui configurações específicas e será abordada em tutoriais dedicados da Central de Ajuda.
--- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.fortics.com.br/gestao-and-operacao/comece-aqui/onboarding-fortics-ia.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.