{"id":1661,"date":"2025-02-06T15:34:13","date_gmt":"2025-02-06T18:34:13","guid":{"rendered":"https:\/\/portal7ia.com.br\/?p=1661"},"modified":"2025-02-06T15:35:31","modified_gmt":"2025-02-06T18:35:31","slug":"tutorial-como-construir-agentes-de-ia-localmente-com-ollama-e-deepseek-r1","status":"publish","type":"post","link":"https:\/\/portal7ia.com.br\/index.php\/2025\/02\/06\/tutorial-como-construir-agentes-de-ia-localmente-com-ollama-e-deepseek-r1\/","title":{"rendered":"Tutorial: Como Construir Agentes de IA Localmente com Ollama e DeepSeek R1"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Introdu\u00e7\u00e3o<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Neste tutorial, voc\u00ea aprender\u00e1 a construir agentes de Intelig\u00eancia Artificial (IA) totalmente localmente utilizando <strong>Ollama<\/strong> e os modelos <strong>DeepSeek R1<\/strong>. Descubra como configurar seu ambiente para rodar modelos de IA de alto desempenho, compar\u00e1veis ou superiores aos modelos da OpenAI, com uma diferen\u00e7a significativa de custo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Pr\u00e9-requisitos<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Antes de come\u00e7ar, certifique-se de ter o seguinte:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Conhecimentos B\u00e1sicos:<\/strong><\/li>\n\n\n\n<li>Familiaridade com o uso do terminal\/linha de comando.<\/li>\n\n\n\n<li>No\u00e7\u00f5es b\u00e1sicas de programa\u00e7\u00e3o em Python.<\/li>\n\n\n\n<li><strong>Software Necess\u00e1rio:<\/strong><\/li>\n\n\n\n<li><strong>Ollama:<\/strong> Ferramenta para gerenciar e executar modelos de linguagem.<\/li>\n\n\n\n<li><strong>Modelos DeepSeek R1:<\/strong> Modelos de linguagem de c\u00f3digo aberto fornecidos pela DeepSeek.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Passo a Passo Detalhado<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Passo 1: Baixar e Instalar o Ollama<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Acesse o Site do Ollama:<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Abra seu navegador e v\u00e1 para <a href=\"https:\/\/ollama.com\">ollama.com<\/a>.<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Baixe o Instalador:<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Clique no bot\u00e3o de download apropriado para o seu sistema operacional (Windows, macOS ou Linux).<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Instale o Ollama:<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ap\u00f3s o download, execute o instalador e siga as instru\u00e7\u00f5es na tela para concluir a instala\u00e7\u00e3o.<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Execute o Ollama:<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Abra o Ollama ap\u00f3s a instala\u00e7\u00e3o para garantir que tudo est\u00e1 funcionando corretamente.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Passo 2: Baixar o Modelo DeepSeek R1<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Acesse o Ollama:<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Abra o aplicativo Ollama em seu computador.<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Navegue at\u00e9 os Modelos:<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>No canto superior esquerdo, clique em <strong>&#8220;Models&#8221;<\/strong> ou use a barra de busca na tela principal.<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Selecione o Modelo DeepSeek R1:<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>O modelo DeepSeek R1 \u00e9 popular e estar\u00e1 listado como o modelo mais popular no Ollama.<\/li>\n\n\n\n<li>Clique em <strong>DeepSeek R1<\/strong> para ver todas as variantes de par\u00e2metros dispon\u00edveis.<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Escolha o Tamanho do Modelo:<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Modelos Maiores:<\/strong> 32 bilh\u00f5es e 70 bilh\u00f5es de par\u00e2metros, compar\u00e1veis ao modelo mini da OpenAI.<\/li>\n\n\n\n<li><strong>Modelos Destilados:<\/strong> Menores, como o de 1,5 bilh\u00e3o de par\u00e2metros, ideais para m\u00e1quinas com menor capacidade.<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Baixe o Modelo:<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Selecione o modelo desejado (por exemplo, 1,5 bilh\u00e3o de par\u00e2metros) e clique em <strong>&#8220;Download&#8221;<\/strong>.<\/li>\n\n\n\n<li><strong>Nota:<\/strong> O tempo de download pode variar dependendo do tamanho do modelo e da velocidade da sua internet.<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Confirme o Download:<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ap\u00f3s o t\u00e9rmino do download, verifique se o modelo foi adicionado \u00e0 sua lista de modelos no Ollama.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Passo 3: Executar o Modelo Localmente<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Abra o Terminal:<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Windows:<\/strong> Abra o Prompt de Comando ou PowerShell.<\/li>\n\n\n\n<li><strong>macOS\/Linux:<\/strong> Abra o Terminal.<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Baixe o Modelo Usando o Terminal:<\/strong><\/li>\n<\/ol>\n\n\n\n<pre class=\"wp-block-code\"><code>   ollama pull deepseek-r1-1.5b<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">4. **Execute o Modelo como Standalone:**<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>ollama run deepseek-r1-1.5b<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">5. **Interaja com o Modelo:**<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ap\u00f3s executar o comando, voc\u00ea poder\u00e1 interagir com o modelo diretamente no terminal.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">**Exemplo de Conversa:**<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>     Voc\u00ea: Como voc\u00ea est\u00e1?\n     IA: Estou funcionando bem! Como posso ajudar voc\u00ea hoje?<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><br>### Passo 4: Criar e Configurar uma Equipe (Crew) de IA<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">6. **Abra Editor de C\u00f3digo Cursor:**<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">7. **Crie um Novo Projeto:**<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&#8211; No Cursor, clique em **&#8221;New Project&#8221;** e nomeie sua equipe, por exemplo, **&#8221;DeepSeek&#8221;**.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">8. **No terminal, Inicialize a Equipe:**<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>crew AI create crew deepseek<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Aten\u00e7\u00e3o: deepseek no comando anterior \u00e9 o nome que voc\u00ea est\u00e1 dando a sua nova crew. N\u00e3o confunda com o modelo deepseek.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">   &#8211; Siga as instru\u00e7\u00f5es para nomear e configurar sua equipe.<br><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">9. **Configure para Usar o Ollama:**<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">   &#8211; Mesmo que o setup inclua refer\u00eancias a modelos da OpenAI, voc\u00ea ir\u00e1 substitu\u00ed-las para utilizar o Ollama.<br><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">10. **Edite o Arquivo `crew.py`:**<br>  &#8211; Navegue at\u00e9 o arquivo `crew.py` no seu projeto e abra-o para edi\u00e7\u00e3o.<br><br>11. **Importe o LLM do Ollama:**<br>   &#8211; Que consiste simplesmente em adicionar LLM ao final da linha de c\u00f3digo abaixo:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>from crewAI import agent, crew, process, task, LLM<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">12. **Defina o Modelo LLM:**<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>deepseek_ollama = LLM(\nmodel=\"ollama\/deepseek-r1-1.5b\",\nbase_url=\"http:\/\/localhost:11434\" # Substitua 'port' pelo n\u00famero da porta usada pelo Ollama\n)<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">   &#8211; **Nota:** Assegure-se de que o Ollama esteja executando e que a porta especificada esteja correta.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">13. **Integre os Agentes:**<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">   &#8211; Configure os agentes da equipe para utilizar o `deepseek_ollama` como o modelo de linguagem.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">  &#8211; Exemplo:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>    @agent\n    def researcher(self) -&gt; Agent: \n        return Agent(\n            config-self.agents_config&#91;'researcher\u2019], \n            verbose=True,\n            llm=self.deepseek_ollama\n        )\n    @agent\n        def reporting_analyst(self) -&gt; Agent:    \n            return Agent(\n                config=self.agents_config&#91;'reporting_analyst'],\n                verbose=true,\n                llm=self.deepseek_ollama\n        )<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">14. **No arquivo main.py, na linha 7, delete deepseek** (que \u00e9 o nome da sua crew nesse exemplo)<br>    A linha vai estar assim:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>from deepseek.crew import DeepSeek<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Elimine o deedseek.(o nome da sua crew)<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>from crew import DeepSeek<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">15. Ainda no arquivo main.py, na linha 30 adicione uma chamada para a fun\u00e7\u00e3o run:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>run()<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">16. **No terminal, liste os diret\u00f3rios, usando o comando ls;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">17. Navegue para o diret\u00f3rio: deepseek, usando o comando: cd deepseek<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">18. Execute o arquivo main.py, usando o comando:<br><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>python src\/deepseek\/main.py<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Isso iniciar\u00e1 a equipe de IA com os agentes configurados utilizando o modelo local do Ollama.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Conclus\u00e3o<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Parab\u00e9ns! Voc\u00ea configurou com sucesso uma equipe de agentes de IA localmente utilizando <strong>Ollama<\/strong> e os modelos <strong>DeepSeek R1<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Com este setup, voc\u00ea pode aproveitar um desempenho robusto e custos reduzidos em compara\u00e7\u00e3o com servi\u00e7os de IA na nuvem.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Recursos Adicionais<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/github.com\/ollama\/ollama\/tree\/main\/docs\">Documenta\u00e7\u00e3o do Ollama<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/api-docs.deepseek.com\/\">DeepSeek API Docs<\/a><\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"has-small-font-size wp-block-paragraph\"><em>Pesquisa, Edi\u00e7\u00e3o, formata\u00e7\u00e3o e finaliza\u00e7\u00e3o:<\/em><br><em>Werney A. Lima, quinta-feira, 6 de fevereiro de 2025 \u2013 14:46 (quinta-feira)<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Introdu\u00e7\u00e3o Neste tutorial, voc\u00ea aprender\u00e1 a construir agentes de Intelig\u00eancia Artificial (IA) totalmente localmente utilizando Ollama e os modelos DeepSeek R1. Descubra como configurar seu ambiente para rodar modelos de IA de alto desempenho, compar\u00e1veis ou superiores aos modelos da OpenAI, com uma diferen\u00e7a significativa de custo. Pr\u00e9-requisitos Antes de come\u00e7ar, certifique-se de ter o [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":1662,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1,509,492,508],"tags":[],"class_list":["post-1661","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-blog","category-cursor","category-deepseek","category-ollama"],"blocksy_meta":[],"brizy_media":[],"_links":{"self":[{"href":"https:\/\/portal7ia.com.br\/index.php\/wp-json\/wp\/v2\/posts\/1661","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/portal7ia.com.br\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/portal7ia.com.br\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/portal7ia.com.br\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/portal7ia.com.br\/index.php\/wp-json\/wp\/v2\/comments?post=1661"}],"version-history":[{"count":2,"href":"https:\/\/portal7ia.com.br\/index.php\/wp-json\/wp\/v2\/posts\/1661\/revisions"}],"predecessor-version":[{"id":1664,"href":"https:\/\/portal7ia.com.br\/index.php\/wp-json\/wp\/v2\/posts\/1661\/revisions\/1664"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/portal7ia.com.br\/index.php\/wp-json\/wp\/v2\/media\/1662"}],"wp:attachment":[{"href":"https:\/\/portal7ia.com.br\/index.php\/wp-json\/wp\/v2\/media?parent=1661"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/portal7ia.com.br\/index.php\/wp-json\/wp\/v2\/categories?post=1661"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/portal7ia.com.br\/index.php\/wp-json\/wp\/v2\/tags?post=1661"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}