> For the complete documentation index, see [llms.txt](https://kb.stoque.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.stoque.com.br/zeev/agentes-de-ia-no-zeev/traga-a-sua-ia-para-o-zeev/faq.md). # FAQ
O que é o "Traga a sua LLM" para o Zeev? O "Traga a sua LLM" permite que você utilize seus próprios modelos de IA dentro do Zeev. Os agentes e fluxos continuam sendo executados na plataforma, mas o modelo de IA utilizado pode ser fornecido por você.
Qual problema o "Traga a sua LLM" resolve para mim? Ele atende você caso já possua contratos com provedores de IA e deseje utilizar esses modelos dentro do Zeev, se utilizando de uma governança já existente e aproveitando os investimentos que você já realizou.
O que é a chave de API que preciso fornecer? É uma credencial de autenticação fornecida pelo provedor de IA. Na prática, você pode compará-la a uma senha que permite ao Zeev acessar o modelo que você contratou.
Sou eu quem deve gerar e fornecer a chave de API? Sim, a responsabilidade é sua. Normalmente, a geração da chave é realizada pela sua equipe de TI ou pelo responsável pela administração do provedor de IA utilizado pela sua empresa.
O Zeev vai gerar ou administrar a minha chave de API? Não. O Zeev apenas recebe a chave que você fornece para realizar a conexão com o provedor escolhido. A gestão da chave permanece sob sua responsabilidade.
Posso cadastrar mais de um modelo de IA? Sim, você pode cadastrar diversos modelos e identificá-los com nomes diferentes, o que facilita o uso em cenários específicos, departamentos ou tipos distintos de processamento.
Existe algum limite para a quantidade de modelos que posso cadastrar? Para isso, consulte mais informações sobre o seu plano.
O que é o modelo alternativo (contingência) que posso configurar? É um segundo modelo que você pode associar ao principal. Caso o modelo principal apresente falha ou indisponibilidade, o sistema poderá utilizar o modelo alternativo que você configurou previamente.
Quais provedores tenho disponíveis nativamente? Você já pode contar com um rol de provedores que inclui OpenRouter, Anthropic, Google, Bedrock e modelos locais, além da possibilidade de apontar o seu próprio provedor.
Posso utilizar um provedor que não está na lista padrão? Sim, você pode usar a opção "Próprio", que permite conectar provedores ou modelos que não estejam na lista padrão de integrações disponibilizada pela plataforma.
O que acontece com os meus créditos de IA do Zeev quando eu uso minha própria LLM? Nesse cenário, o seu consumo deixa de utilizar os créditos de IA do Zeev e passa a ser cobrado diretamente pelo seu provedor de IA.
Meus agentes mudam quando eu utilizo uma LLM própria? Não. O fluxo de criação e utilização dos seus agentes permanece praticamente o mesmo. A principal alteração é a seleção do modelo de IA que será utilizado pelo agente.
O Zeev valida se a minha chave de API está correta? Sim, há uma funcionalidade de teste que verifica se a conexão com o seu provedor foi realizada corretamente antes que o modelo seja salvo.
Posso usar qualquer modelo para imagens, documentos e áudios? Não. Cada modelo possui capacidades específicas. Alguns aceitam apenas texto, enquanto outros suportam imagens, documentos ou visão computacional. Você deve escolher o modelo correto de acordo com a necessidade do seu caso de uso.
O que eu preciso ter para utilizar a minha LLM no Zeev? Você deve: 1. possuir um modelo de IA contratado; 2. ter acesso à geração da chave de API; 3. entender qual capacidade precisa (texto, imagem, documento etc.); 4. ter familiaridade com o uso dos agentes do Zeev; e 5. solicitar a ativação da funcionalidade no seu ambiente, já que ela vem desabilitada por padrão.
Posso utilizar um modelo próprio, hospedado por mim mesmo? Sim! É possível criar um modelo com provedor próprio e/ou hospedado por você, também. Geralmente esse é um caso muito específico onde você pode utilizar modelos open source e/ou desenvolver seu próprio modelo especialista em seu contexto e hospedá-lo em sua própria infraestrutura, sem depender de um provedor terceirizado. Contudo, vale salientar que o rol de modelos que você pode selecionar e utilizar nessa alternativa é limitado. Você não pode, por exemplo, rodar um modelo do Claude localmente. Um exemplo comum é usar um modelo Llamma local, ou algum chinês.
Existe um limite de arquivos quando eu uso um modelo próprio? Sim, existe, mas essa limitação é principalmente uma questão de contexto, ou seja, do tamanho máximo de caracteres ou tokens que o modelo consegue processar em uma requisição. Esse limite varia de modelo para modelo: alguns LLM aceitam contextos grandes, outros bem pequenos. Se você adicionar arquivos muito grandes ou muitos arquivos que ultrapassem esse limite, o processo pode travar e gerar ocorrências no sistema. Os limites atuais da plataforma: até 10000 caracteres para o prompt, 2 arquivos, 5 MB por arquivo e 30 páginas por documento.
Quais cuidados devo ter com a minha chave de API? Você deve tratar sua chave de API como uma senha (só que ainda mais sensível!), já que, se vazada, pode causar prejuízos muito maiores. Existem vírus especializados em roubar chaves de API de LLMs, e sem controle adequado isso pode gerar um vazamento de uso de tokens com prejuízos financeiros. Por isso, você nunca deve mostrar sua chave de API em gravações, reuniões ou documentos, e sempre deve delimitar um volume máximo de créditos disponíveis ao criar uma chave.
Vou poder usar LLMs com suporte a visão computacional? Sim, você poderá. Isso abre diversas novas oportunidades para você.
Agora, com mais opções, a configuração do meu Agente ficou mais complexa? Na verdade, você tem agora uma opção mais completa, não mais complexa. Se você quer comodidade e, por vezes, não tem todo o conhecimento técnico, ou não quer lidar com isso, nós cuidamos disso pra você! Agora, se você tem uma necessidade mais avançada, possui equipe de TI, gerencia chaves de API, quer usar modelos específicos, tem alto volume, quer dividir tarefas por modelos distintos, você pode trazer sua própria chave de API.
Qual o modelo de LLM a Zeev recomenda para uso? Não adotamos a prática de recomendação, pois nem todos os modelos e provedores são necessariamente aplicáveis aos contextos específicos. Contudo, até o momento é consenso que os modelos da OpenAI, da Anthropic ou do Google, em geral, são os mais completos e aceitam visão computacional.
O que é o OpenRouter e como ele pode me ajudar? O OpenRouter funciona como um provedor intermediário, que oferece centenas de modelos de inteligência artificial hospedados por dezenas de provedores ao redor do mundo. Você se conecta uma única vez a ele, e ele roteia suas requisições para os outros provedores (incluindo um custo adicional sobre os tokens por isso). O principal benefício para você é a facilidade de gerenciar suas conexões e chaves de API de forma centralizada, em um só lugar, sem precisar abrir conta separada na OpenAI, na Anthropic ou no Google. Você faz apenas uma conta no OpenRouter, que também permite conexão com modelos chineses, hospedados ou não por empresas chinesas.
*** Acesse ao treinamento completo na Universidade Voltar ao menu do tema --- # 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://kb.stoque.com.br/zeev/agentes-de-ia-no-zeev/traga-a-sua-ia-para-o-zeev/faq.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.