Com crear un agent d'IA a Python des de zero

Darrera actualització: 5 de juny de 2026
  • Un agent dIA es diferencia dun chatbot perquè pot executar accions mitjançant eines i prendre decisions autònomes.
  • El cicle fonamental d'un agent consisteix a raonar, triar una eina, executar l'acció i observar-ne el resultat.
  • És crucial utilitzar entorns segurs com sandboxes en permetre que els agents executin codi per evitar vulnerabilitats.
  • La integració de supervisió humana (Human-in-the-Loop) garanteix que les accions crítiques siguin validades abans de la seva execució.

Agent IA Python

Segur que t'ha passat: busques com muntar un agent d'IA i et trobes amb mil tutorials que et diuen que instal·lis LangChain, escriguis tres línies de codi i ja tens un assistent màgic. Però és clar, per als que ens agrada gratar la superfície i entendre què passa sota el capó , això no és suficient. No hi ha res com sentir que teniu el control total del flux i no dependre d'una llibreria que fa la màgia en secret.

La realitat és que construir un agent des de zero a Python és un repte apassionant que et permet comprendre la lògica de raonament dels LLM . No es tracta només d'enviar un prompt i rebre una resposta, sinó de crear un sistema capaç de decidir, executar accions al món real i corregir els seus propis errors sobre la marxa, sense que un framework extern prengui totes les decisions per nosaltres.

local AI automatització
Article relacionat:
IA local i automatització: agents, seguretat i casos reals

Què és realment un agent dIA i en què es diferencia dun chatbot?

Per no embolicar-nos, el primer és deixar clar que un chatbot és bàsicament un interlocutor: tu preguntes, ell respon basant-se en les dades. Si demaneu el preu del Bitcoin a un chatbot estàndard, el més probable és que us digui que no teniu accés a dades en temps real . En canvi, un agent és un sistema amb capacitat dacció.

  Comparativa d'assistents de compres amb IA: ChatGPT vs Perplexity

L'agent no es limita a parlar, sinó que té un cicle de pensament i execució . Davant la mateixa pregunta del Bitcoin, l'agent reflexiona: «Necessito la dada actual, faré servir l'eina de cerca web», executa l'acció, llegeix el resultat i llavors et dóna la resposta final. Bàsicament, un agent és la combinació d‟un Model de Llenguatge (LLM), un conjunt d‟eines i una capacitat de decisió autònoma.

L'anatomia d'un agent: El loop de funcionament

Article relacionat:
Què és Clawdbot i per què revoluciona els agents d'IA

Si vols programar això sense llibreries externes, has d'entendre que la clau és al bucle. L'agent entra a un cicle on analitza la petició, tria una eina, observa el resultat i repeteix el procés fins que considera que ha resolt el problema. Aquest flux de treball agentic , detallat en aquesta guia completa sobre fluxos de treball agentics d'IA , és el que permet que la IA deixi de ser un simple generador de text per convertir-se en un executor de tasques.

Perquè això funcioni, necessitem definir eines clares. Una eina pot ser una funció de Python que faci un càlcul matemàtic, que consulteu una base de dades o que envieu un correu electrònic . El secret perquè no es perdi l'agent és proporcionar descripcions molt detallades de cada funció; si la descripció és vaga, la IA es confondrà i no trucarà a l'eina correctament.

Guia pas a pas per muntar el teu agent a Python

crear agents d'IA amb n8n
Article relacionat:
Com crear agents d'IA amb n8n: avantatges, guia i trucs

Si et llences a la piscina, és ideal començar amb un entorn net. Crea un entorn virtual, instal·la la llibreria d'OpenAI o la que prefereixis (com Mistral o Truca via API) i configura les teves claus de seguretat com a variables d'entorn per no deixar les teves contrasenyes exposades al codi, que seria un error de novell imperdonable.

  Com utilitzar Intel·ligència Artificial sense crear un compte

El procés tècnic es resumeix en definir les eines en un fitxer separat (per exemple, tools.py) i després crear la lògica de l'agent a agent.py. Aquí és on passa la màgia: has de dissenyar un system prompt robust que indiqui al model que no ha de respondre directament si necessita una eina, sinó que ha d'emetre un format específic (com un JSON) que el teu codi de Python pugui interceptar i executar.

Un error molt comú, especialment amb models més petits com Flama 8b o Qwen, és que la IA t'expliqui com fer servir l'eina en lloc d'executar-la. Per solucionar això, has de ser contundent en les instruccions i limitar la verbositat del model , obligant-ho a seguir una estructura estricta de «Pensament -> Acció -> Observació».

Casos dús i nivells de complexitat

com implementar agents IA amb Databricks
Article relacionat:
Implementar agents d'IA amb Databricks: guia pràctica completa

Depenent del teu nivell, pots començar amb projectes senzills com un agent que consulti el clima o un traductor avançat. Quan ja dominis el flux bàsic, pots saltar al nivell intermedi creant agents de recerca que sintetitzin informació de diverses webs o assistents de codi que escriguin i executin scripts automàticament.

Per als més valents, hi ha els agents de nivell avançat. Parlem de sistemes de trading que analitzen mercats o agents de suport tècnic amb accés a bases de coneixements massives. En aquests casos, és vital implementar un sandbox d'execució (com Docker o E2B) per evitar els riscos de seguretat en navegadors amb agents d'IA o l'execució de codi maliciós a la màquina local, ja que la seguretat és primordial quan donem autonomia a la IA.

  Com controlar bombetes Tuya de forma local a Home Assistant

Fluxos avançats: Human-in-the-Loop i Orquestració

A mesura que el sistema creix, t'adonaràs que la IA pot fallar o entrar a bucles infinits. Aquí és on entra el concepte de Human-in-the-Loop (HITL) . Consisteix a afegir punts de control on l'agent ha de pausar la seva execució i demanar l'aprovació d'un humà abans de fer una acció crítica, com enviar un correu electrònic a un client o esborrar un fitxer.

Implementar checkpoints i la capacitat de reprendre la tasca permet que el flux sigui molt més fiable. Aquesta capa de supervisió humana és la diferència entre un prototip divertit i una solució empresarial robusta i professional . Per gestionar-ho, s'utilitzen eines d' orquestració d'IA de ServiceNow que permeten ramificacions al flux de treball i una gestió d'estats més complexa.

Muntar un agent implica dominar des de la configuració bàsica de lentorn i la definició de funcions fins a la gestió derrors i la seguretat en lexecució de codi. Al final, l'èxit depèn d'un prompting precís i una estructura de control que obligui el model a actuar de forma lògica, permetent que la IA passi de ser un xat simple a una eina d'automatització real i eficient.

manus ia-0
Article relacionat:
Tot el que has de saber sobre Manus, l'agent d'IA que vol fer la teva feina