> 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/a-sua-ia-dentro-do-zeev.md).
# A sua IA dentro do Zeev
## Visão geral
O "Traga a sua IA para o Zeev" permite que você utilize seus próprios modelos de IA dentro do Zeev. Os agentes e fluxos continuam sendo executados na plataforma, mas você escolhe o provedor do modelo de IA utilizado.
Com essa funcionalidade, sua empresa pode utilizar modelos de Inteligência Artificial já contratados junto a provedores como OpenAI, Google, Anthropic, AWS Bedrock ou outros, diretamente dentro dos Agentes de IA do Zeev.
Em outras palavras:
* O Zeev continua fornecendo os processos, agentes e automações.
* Você fornece o modelo de IA que deseja utilizar.
* O consumo deixa de utilizar créditos de IA do Zeev e passa a ser contabilizado diretamente pelo provedor escolhido pelo cliente.
{% hint style="info" %}
A Zai, modelo de Inteligência Artificial nativo do Zeev, continua disponível por meio da aquisição de créditos específicos para a execução de Agentes de IA. O "Traga a sua IA para o Zeev" é um recurso e oportunidade paralelo aos créditos nativos.
{% endhint %}
## Quando faz sentido trazer sua LLM para o Zeev?
A funcionalidade é especialmente recomendada se a sua organização:
✅ Já possui contrato com provedores de IA.
✅ Deseja maior governança sobre token e custos.
✅ Precisa escolher modelos específicos para determinados cenários.
✅ Possui preocupações com privacidade e gerenciamento dos dados.
✅ Possui equipe técnica capaz de administrar chaves e provedores de IA.
## Como funciona a arquitetura?
Com a Zai, IA nativa do Zeev
Com a sua IA no Zeev
## Pré-requisitos para a sua IA no Zeev
* Ambiente Zeev com a funcionalidade habilitada.
* Um modelo de IA contratado.
* Uma chave de API válida.
* Permissão para utilização da API.
## Boas práticas
Sua chave de API deve ser tratada como um segredo corporativo, por isso: não compartilhe por e-mail, chat ou mensagem e também não exiba a sua chave em treinamentos gravados.
Configure limites financeiros de consumo dentro do seu provedor (a grande maioria dos provedores tem essa opção nativamente) e, se possível, para uma melhor governança, utilize chaves específicas por equipe, departamento ou ambiente.
## Modelo alternativo (contingência)
É possível cadastrar um modelo alternativo. Esse modelo será utilizado caso o principal fique indisponível.
{% hint style="warning" %}
Note que só é possível cadastrar um modelo alternativo se houver **mais de um** modelo cadastrado.
{% endhint %}
## Utilizando um modelo em um Agente
Após cadastrar a sua IA, a [**configuração do Agente de IA**](/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/tarefa-de-agente-de-ia/como-criar-agentes-de-ia.md#configurando-agentes-de-ia) segue normalmente. Porém ao Editar o Agente, em "Configurações" é preciso selecionar o Agente desejado para executar as tarefas nas quais ele está vinculado.
#### Limitações importantes
Atualmente, utilizar uma LLM própria **não altera os limites do Zeev para agentes**. Permanecem os limites então vigentes:
* Até 10000 caracteres para prompts
* Até 2 arquivos
* Até 5 MB por arquivo
* Até 30 páginas por documento
***
Acesse ao treinamento completo na UniversidadeVoltar 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/a-sua-ia-dentro-do-zeev.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.