<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Eduardo Petecof on Medium]]></title>
        <description><![CDATA[Stories by Eduardo Petecof on Medium]]></description>
        <link>https://medium.com/@edupetecof?source=rss-140fb42e0865------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*khkgEoKQZbyxjSKR</url>
            <title>Stories by Eduardo Petecof on Medium</title>
            <link>https://medium.com/@edupetecof?source=rss-140fb42e0865------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 09:11:32 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@edupetecof/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Building Blocks: Aprendendo a utilizar o ADK (Agent Development Toolkit) do watsonx Orchestrate]]></title>
            <link>https://medium.com/@edupetecof/building-blocks-aprendendo-a-utilizar-o-adk-agent-development-toolkit-do-watsonx-orchestrate-c660571141aa?source=rss-140fb42e0865------2</link>
            <guid isPermaLink="false">https://medium.com/p/c660571141aa</guid>
            <category><![CDATA[watsonx]]></category>
            <category><![CDATA[watsonx-orchestrate]]></category>
            <category><![CDATA[ai-agent]]></category>
            <dc:creator><![CDATA[Eduardo Petecof]]></dc:creator>
            <pubDate>Tue, 22 Jul 2025 21:31:21 GMT</pubDate>
            <atom:updated>2025-07-22T21:31:21.609Z</atom:updated>
            <content:encoded><![CDATA[<h3>Introdução</h3><p>Olá pessoal, esse é mais um episódio da série Building Blocks! Este artigo explora o uso do ADK (Agent Development Toolkit) do watsonx Orchestrate, uma ferramenta poderosa para a criação e gerenciamento de agentes de IA. Vamos abordar, com um exemplo prático, desde a instalação do ADK até a criação de componentes essenciais como Knowledge Bases, Tools e Agents, proporcionando uma visão prática de como automatizar a criação de agentes de forma programática.</p><h4>Este guia pode ser útil para:</h4><ol><li><strong>Engenheiros de IA</strong>: Que desejam automatizar a criação de agentes e integrá-los em suas aplicações.</li><li><strong>Profissionais de TI</strong>: Que buscam entender como o watsonx Orchestrate pode ser utilizado para criar agentes.</li><li><strong>Entusiastas de Tecnologia</strong>: Que querem explorar as capacidades do watsonx Orchestrate e de agentes no geral.</li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bTfwxwaxXVMO48QQX5Ga7Q.jpeg" /><figcaption>Foto lúdica, gerada por IA, de um programador usando uma máquina que produz robôs humanóides com base em um código.</figcaption></figure><h3>O que são Agentes, Tools e Knowledge Bases?</h3><p>Agentes de IA são sistemas que realizam tarefas de forma autônoma, utilizando ferramentas e bases de conhecimento para responder perguntas, tomar decisões e executar ações. Eles são compostos por:</p><ul><li><strong>Tools</strong>: Ferramentas que os agentes utilizam para realizar suas tarefas, como APIs ou funções específicas.</li><li><strong>Knowledge Bases</strong>: Bases de conhecimento que armazenam informações relevantes para os agentes, permitindo que eles acessem dados e informações necessárias para suas operações.</li></ul><h3>O que é o ADK?</h3><p>O Agent Development Kit (ADK) é uma ferramenta fornecida pela IBM para criar agentes e ferramentas para o watsonx Orchestrate. O ADK permite que os desenvolvedores criem agentes personalizados e escaláveis de forma programática, utilizando uma interface de linha de comando e uma estrutura de desenvolvimento.</p><h3>Exemplo Prático</h3><p>Para ilustrar o uso do ADK, vamos explorar um exemplo que demonstra como criar um agente que responde a perguntas sobre bulas de medicamentos, utilizando uma Knowledge Base para armazenar informações sobre o medicamento Buscoduo e uma Tool para simular a criação de pedidos de compra.</p><p>Para ter acesso ao Notebook, acesse o repositório no GitHub:</p><p><a href="https://github.com/epetecof/wxo-adk-first-tutorial">GitHub - epetecof/wxo-adk-first-tutorial: Tutorial on how to use watsonx Orchestrate ADK</a></p><h3>Requisitos</h3><p>Para executar o notebook, você precisará:</p><ul><li>Ter uma conta na IBM Cloud com acesso ao watsonx Orchestrate.</li><li>Ter uma chave de API válida para autenticação.</li><li>(Opcional) Ter acesso ao watsonx.ai Studio para execução do Notebook na IBM Cloud</li></ul><h3>Destaques do Notebook</h3><h4>1. Instalação do ADK</h4><pre>! pip install ibm-watsonx-orchestrate | tail -1</pre><p>Esta célula instala o pacote ibm-watsonx-orchestrate, que é essencial para utilizar o ADK e criar agentes no watsonx Orchestrate.</p><h4>2. Configuração do Ambiente</h4><pre>! orchestrate env add -n techzone-037 -u &lt;url&gt;<br>! orchestrate env activate techzone-037 --api-key &lt;apikey&gt;</pre><p>Estas células adicionam e ativam um ambiente do watsonx Orchestrate, permitindo a execução de agentes e ferramentas.</p><h4>3. Criação de uma Knowledge Base</h4><pre>import yaml<br><br>data = {<br>    &#39;spec_version&#39;: &#39;v1&#39;,<br>    &#39;kind&#39;: &#39;knowledge_base&#39;,<br>    &#39;name&#39;: &#39;kb_buscoduo&#39;,<br>    &#39;description&#39;: &#39;Base de conhecimento com a bula do medicamento Buscoduo.&#39;,<br>    &#39;documents&#39;: [<br>        &#39;/home/wsuser/work/bula_buscoduo.pdf&#39;<br>    ]<br>}<br>with open(&#39;kb_buscoduo.yaml&#39;, &#39;w&#39;) as file:<br>    yaml.dump(data, file, sort_keys=False)</pre><p>Essa célula define uma Knowledge Base, contendo documentos relevantes para o agente.</p><h4>4. Criação de uma Tool</h4><pre>function = &#39;&#39;&#39;<br>from ibm_watsonx_orchestrate.agent_builder.tools import tool, ToolPermission<br><br>@tool(name=&quot;place_order_tool&quot;, description=&quot;Ferramenta para criar um pedido de compra de um medicamento.&quot;, permission=ToolPermission.ADMIN)<br>def place_order_tool(product_name:str, address:str) -&gt; str:<br>    if product_name != &quot;&quot; and address != &quot;&quot;:<br>        return &quot;Pedido realizado de {} para o endereço: {}&quot;.format(product_name, address)<br>    else:<br>        return &quot;O pedido falhou&quot;<br>&#39;&#39;&#39;<br>with open(&quot;place_order_tool.py&quot;, &quot;w&quot;, encoding=&quot;utf-8&quot;) as f:<br>    f.write(function)</pre><p>Essa célula define uma ferramenta (Tool) que o agente pode utilizar para realizar pedidos de compra de medicamentos.</p><h4>5. Criação de um Agente</h4><pre>import yaml<br><br>data = {<br>    &#39;spec_version&#39;: &#39;v1&#39;,<br>    &#39;kind&#39;: &#39;native&#39;,<br>    &#39;name&#39;: &#39;agente_bulas&#39;,<br>    &#39;llm&#39;: &#39;watsonx/meta-llama/llama-3-3-70b-instruct&#39;,<br>    &#39;style&#39;: &#39;react&#39;,<br>    &#39;description&#39;: (<br>        &quot;Agente para tirar dúvidas sobre o medicamento Buscoduo.&quot;<br>    ),<br>    &#39;instructions&#39;: (<br>        &quot;Você é um agente amigável que responde dúvidas do usuário sobre o Buscoduo, sempre consultando a bula.\n&quot;<br>        &quot;Se o usuário perguntar sobre um outro assunto, diga que você não responde sobre outros temas.\n&quot;<br>        &quot;Responda sempre em Português do Brasil.&quot;<br>    ),<br>    &#39;collaborators&#39;: [<br>    ],<br>    &#39;tools&#39;: [<br>        &quot;place_order_tool&quot;<br>    ],<br>    &#39;knowledge_base&#39;: [<br>        &quot;kb_buscoduo&quot;<br>    ],<br>}<br>with open(&#39;agent_buscoduo.yaml&#39;, &#39;w&#39;) as file:<br>    yaml.dump(data, file, sort_keys=False)</pre><p>Essa célula define um agente, incluindo suas ferramentas, base de conhecimento e instruções. Veja no git mais detalhes sobre cada parâmetro.</p><h4>6. Teste do Agente</h4><pre>import requests<br>response = requests.post(&quot;https://api.us-south.watson-orchestrate.cloud.ibm.com/instances/&lt;instance-id&gt;/v1/orchestrate/&lt;agent-id&gt;/chat/completions&quot;,<br>headers={&quot;Authentication&quot;: &quot;Bearer &quot;+token, &quot;IAM-API_KEY&quot;: apikey, &quot;Content-Type&quot;: &quot;application/json&quot;, &quot;Accept&quot;: &quot;application/json&quot;},<br>data=&#39;{&quot;stream&quot;: true, &quot;messages&quot;: [{&quot;role&quot;: &quot;user&quot;, &quot;content&quot;: &quot;Buscoduo funciona para colicas menstruais?&quot;}]}&#39;)<br>response.text</pre><p>Essa célula envia uma mensagem para o agente via API e mostra o retorno. Usamos esse modo para testar o agente criado.</p><h3>Conclusão</h3><p>O ADK do watsonx Orchestrate é uma ferramenta poderosa para a criação e gerenciamento de agentes de IA. Com ele, é possível automatizar a criação de agentes, ferramentas e bases de conhecimento, tornando o processo mais eficiente e escalável.</p><p>Através de um exemplo utilizando bulas de medicamentos, esse artigo forneceu uma visão prática de como utilizar o ADK, desde a instalação até a criação de componentes essenciais.</p><p>Espero que este guia tenha sido útil e que você possa aplicar esses conceitos em seus próprios projetos de IA. Se você tiver alguma dúvida ou sugestão, sinta-se à vontade para compartilhar. Obrigado pela leitura!</p><p><strong>Autor</strong>: Eduardo Petecof Mattoso (<a href="https://medium.com/u/140fb42e0865">Eduardo Petecof</a>)</p><p><strong>Co-autores</strong>: Laura Pellizari Pereira (<a href="https://medium.com/u/8712e25e4931">Pellizarilaura</a>), João Jardim (<a href="https://medium.com/u/020d60d10adc">João Pedro Jardim</a>)</p><p><strong>Revisão e direção</strong>: Isabelly Oliveira Cunha (<a href="https://medium.com/u/31228f75dcca">Isabelly Cunha</a>)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c660571141aa" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Building Blocks: Como usar Jobs do watsonx.ai através de APIs]]></title>
            <link>https://medium.com/@edupetecof/building-blocks-como-usar-jobs-do-watsonx-ai-atrav%C3%A9s-de-apis-19327bb43dd7?source=rss-140fb42e0865------2</link>
            <guid isPermaLink="false">https://medium.com/p/19327bb43dd7</guid>
            <category><![CDATA[watsonx]]></category>
            <category><![CDATA[watsonx-ai]]></category>
            <category><![CDATA[ai]]></category>
            <category><![CDATA[ibm]]></category>
            <category><![CDATA[python]]></category>
            <dc:creator><![CDATA[Eduardo Petecof]]></dc:creator>
            <pubDate>Fri, 27 Dec 2024 14:16:51 GMT</pubDate>
            <atom:updated>2024-12-27T14:16:51.583Z</atom:updated>
            <content:encoded><![CDATA[<h3>Building Blocks: Como usar Jobs do watsonx.ai através de APIs para automatizar a execução de Notebooks</h3><h3>Resumo</h3><p>Olá pessoal,</p><p>Esse artigo marca o início de uma série (por enquanto chamada de <strong>Building Blocks</strong>), em que eu e alguns colegas vamos documentar artefatos técnicos (incluindo códigos), usados em projetos reais e que podem ser reaproveitados no futuro.</p><p>A ideia inicial era deixar documentado para uso próprio, mas porque não compartilhar esse conhecimento também aqui na internet para alguém que possa precisar? Dessa forma talvez seja possível retribuir as inúmeras vezes que a internet já nos ajudou rsrs.</p><p>Os artigos vão ser bem focados em um assunto específico, então leia sempre o resumo para saber se é algo pode ser útil pra você e contribuir com o seu desafio atual.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*noRS8XRnMLtHVIuxvzfSeg.jpeg" /><figcaption>Imagem de blocos gerada por IA</figcaption></figure><p>Esse primeiro artigo pode ser útil em 3 situações:</p><p>1 — Como informado no título, mostrar <strong>como usar Jobs do watsonx.ai, através de APIs, para automatizar a execução de Notebooks.</strong></p><p>2 — Se você está aprendendo a usar o watsonx.ai ou quer aprofundar seu conhecimento, esse artigo pode ser interessante para te mostrar conceitos importantes de uso desse serviço.</p><p>3 — Testar como fazer um artigo <strong>totalmente co-criado com um modelo de inteligência artificial generativa do </strong><a href="https://www.ibm.com/br-pt/products/watsonx-ai"><strong>watsonx.ai</strong></a>, incluindo a criação do código e o desenvolvimento do texto do artigo. (Talvez eu faça um artigo sobre isso também)</p><p>Vamos começar com alguns conceitos e contextualizações importantes…</p><h3>Quando os Jobs são úteis?</h3><p>Um Job no watsonx.ai é uma <strong>tarefa </strong>ou <strong>código</strong> que é submetido à plataforma para ser processado e executado de forma <strong>assíncrona</strong>. Isso significa que, uma vez criado e enviado, o Job é executado em <strong>segundo plano</strong>, sem bloquear ou afetar outras operações, permitindo que o usuário continue trabalhando em outras tarefas enquanto o processamento é realizado. A natureza <strong>assíncrona</strong> permite uma grande flexibilidade e escalabilidade, permitindo que os usuários criem e executem múltiplos Jobs simultaneamente, sem preocupações com a capacidade de processamento.</p><p>Eles são especialmente benéficos nos seguintes cenários:</p><ul><li><strong>Código complexo e de longa duração:</strong> Tarefas que envolvem cálculos complicados, processamento de um grande volume de dados ou dependem de múltiplas ativações de outros sistemas podem ser transferidas para Jobs assíncronos. Isso garante que sua aplicação principal permaneça responsiva e possa continuar a lidar com outras solicitações.</li><li><strong>Tarefas agendadas: </strong>Os Jobs podem ser agendados para serem executados em intervalos específicos, tornando-os ideais para tarefas recorrentes, como backups diários de dados, geração de relatórios semanais ou arquivamento mensal de dados. Essa automação garante que tarefas críticas sejam realizadas consistentemente e no prazo, sem intervenção manual.</li></ul><h3>Execução de Jobs do watsonx.ai</h3><p>O watsonx.ai suporta a execução de Jobs de forma nativa via API ou interface, fornecendo um framework flexível e robusto para gerenciar suas tarefas. Aqui está uma explicação detalhada de como funciona:</p><ul><li><strong>Criação do Job:</strong> Você cria Jobs para executar ativos em várias ferramentas, como fluxos de Refinaria de Dados, fluxos do SPSS Modeler, Notebooks e scripts, dentro de um projeto. Isso permite automatizar uma ampla gama de tarefas, desde pré-processamento de dados até treinamento e avaliação de modelos.</li><li><strong>Propriedades do Job:</strong> Ao criar um Job, você define várias propriedades que determinam seu comportamento. Essas propriedades incluem o nome do Job, definição (o script ou fluxo a ser executado), o ambiente de execução (capacidade de processamento), agendamento (quando o Job deve ser executado) e especificações de notificação (como você deve ser notificado sobre o status do Job). Você pode escolher executar um Job imediatamente ou agendá-lo para ser executado em intervalos específicos.</li><li><strong>Execuções de Job:</strong> Cada vez que um Job é iniciado, uma execução de Job é criada. Essas execuções podem ser monitoradas para rastrear o progresso e o status do Job. Você pode comparar o histórico de execuções de Jobs anteriores para identificar padrões, solucionar problemas e otimizar o desempenho. Informações detalhadas sobre cada execução de Job, incluindo alterações de estado do Job e falhas do Job, podem ser visualizadas no log de execução do Job.</li></ul><h3>Exemplo prático</h3><p>Para ter acesso ao exemplo, acesse o repositório abaixo:</p><p><a href="https://github.com/epetecof/watsonxai-job-automation">GitHub - epetecof/watsonxai-job-automation</a></p><p>Este repositório contém dois Notebooks que demonstram como usar a API do watsonx.ai para criar e executar Jobs. O primeiro Notebook, chamado <a href="https://github.com/epetecof/watsonxai-job-automation/blob/main/%5BPT-BR%5D%20Hello%20World%20Job.ipynb">Hello World Job</a>, é um exemplo simples que imprime o valor de uma variável de ambiente. O segundo Notebook, <a href="https://github.com/epetecof/watsonxai-job-automation/blob/main/%5BPT-BR%5D%20Job%20Creation%20APIs.ipynb">Job Creation API</a>, fornece um guia passo a passo sobre como autenticar na API, listar Jobs, criar um novo Job, criar uma execução de Job e recuperar o status e os logs da execução do Job. Vamos fazer tudo isso usando o primeiro notebook como exemplo.</p><h3>Requisitos</h3><p>Para executar os códigos neste repositório, você precisará:</p><ul><li>Ter uma conta no IBM Cloud e ter acesso ao watsonx.ai.</li><li>Ter um projeto criado no watsonx.ai.</li><li>Adicionar os dois notebooks ao seu projeto:</li><li><a href="https://github.com/epetecof/watsonxai-job-automation/blob/main/%5BPT-BR%5D%20Job%20Creation%20APIs.ipynb">Job Creation API</a> — Notebook principal com as orientações</li><li><a href="https://github.com/epetecof/watsonxai-job-automation/blob/main/%5BPT-BR%5D%20Hello%20World%20Job.ipynb">Hello World Job</a> — Exemplo para criação do Job</li><li>Ter uma API Key da IBM Cloud para autenticar na API. (Existem orientações no Notebook principal)</li><li>Ter um token de acesso criado no seu projeto no watsonx.ai com a função de Editor. (Existem orientações no Notebook principal)</li></ul><h3><strong>Destaques</strong></h3><p>Esta seção lista todos os jobs no projeto especificado. Ela faz uma requisição GET para o endpoint /v2/jobs e retorna a lista de jobs.</p><pre>requests.get(main_url+&quot;/v2/jobs?project_id=&quot;+project_id, headers=headers).json()</pre><p>Esta seção cria um novo job para executar o notebook especificado, passando como input uma variável de ambiente. Ela faz uma solicitação POST para o endpoint /v2/jobs com a configuração do job.</p><pre>data_job = {<br>    &#39;job&#39;: {<br>        &#39;name&#39;: &#39;Job API&#39;,<br>        &#39;configuration&#39;: {<br>            &#39;env_variables&#39;: [&#39;TEST_VAR=%22Hello%22&#39;],<br>            &#39;run_results&#39;: &#39;log_and_new_notebook&#39;,<br>            &#39;env_type&#39;: &#39;notebook&#39;<br>        },<br>        &#39;asset_ref&#39;: selected_notebook_asset_id,<br>    }<br>}<br><br>job_response = requests.post(main_url+&quot;/v2/jobs?project_id=&quot;+project_id, headers=headers, data=json.dumps(data_job)).json()<br>job_response</pre><p>Esta seção cria uma nova execução de job com variáveis de ambiente. Isso sobrescreverá as variáveis que já existem na definição do job. Ela faz uma solicitação POST para o endpoint /v2/jobs/{job_id}/runs com a configuração da execução do job.</p><pre>data_run_2 = {<br>    &#39;job_run&#39;: {<br>        &#39;name&#39;: &#39;Job Run API w/ Env Var&#39;,<br>        &#39;configuration&#39;: {<br>            &#39;env_variables&#39;: [&#39;TEST_VAR=%22Hello2%22&#39;],<br>        },<br>    }<br>}<br><br>run_response_2 = requests.post(main_url+f&quot;/v2/jobs/{job_id}/runs?project_id={project_id}&quot;, headers=headers, data=json.dumps(data_run_2)).json()<br>run_response_2</pre><p>Esta seção recupera os logs para a execução do job. Ele faz uma solicitação GET para o endpoint /v2/jobs/{job_id}/runs/{run_id}/logs e retorna os logs de execução do job.</p><pre>requests.get(main_url+f&quot;/v2/jobs/{job_id}/runs/{job_run_id}/logs?project_id={project_id}&quot;, headers=headers).json()</pre><h3>Conclusão</h3><p>Espero que a sua leitura tenha sido útil e que você possa usar esses exemplos fornecidos para acelerar a sua implementação. É uma ótima ideia começar a usar Jobs para tornar a sua arquitetura mais escalável e fácil de gerenciar.</p><p>Se você tem alguma sugestão sobre o formato desse artigo, estou aberto a feedbacks. Ao refinarmos o formato podemos replicá-lo usando os modelos de IA Generativa para outros assuntos. Obrigado!</p><p>Autor: Eduardo Petecof Mattoso (<a href="https://medium.com/u/140fb42e0865">Eduardo Petecof</a>)</p><p>Co-autora: Laura Pellizari Pereira (<a href="https://medium.com/u/8712e25e4931">Pellizarilaura</a>)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=19327bb43dd7" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>