بناء أول وكيل بسيط لك
اتبع دليلًا خطوة بخطوة لإعداد بيئتك وبناء وكيل ذكاء اصطناعي أساسي باستخدام LangChain
بناء أول وكيل بسيط لك درس مجاني في AI Agents with LangChain & Autonomous Workflows على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في AI Agents with LangChain & Autonomous Workflows، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة AI Agents with LangChain & Autonomous Workflows 4 دروس في المجموع.
بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.
Build Your First Agent!
Time to build your first AI agent with LangChain — connecting an LLM to basic tools so it can answer your queries intelligently.
Set Up Your Python Environment
First, set up Python 3.9+ and a virtual environment to isolate dependencies. Create one with venv, then activate it before you install anything.
Install LangChain & Dependencies
Now install LangChain and the OpenAI integration. Run the pip command inside your activated virtual environment.
Connect to an LLM
Your agent needs a brain. Initialize ChatOpenAI with your API key stored as the OPENAI_API_KEY environment variable — never hardcode it.
import os
from langchain_openai import ChatOpenAI
def main():
# In a real setup, ensure OPENAI_API_KEY is set
# For demonstration, we'll assume it's available
# os.environ["OPENAI_API_KEY"] = "sk-..." # DON'T hardcode!
try:
llm = ChatOpenAI(model="gpt-3.5-turbo", temperature=0)
print("LLM initialized successfully!")
# You can test it:
# response = llm.invoke("Hello, LLM!")
# print(response.content)
except Exception as e:
print(f"Error initializing LLM: {e}")
print("Please ensure OPENAI_API_KEY is set.")
if __name__ == "__main__":
main()Agents Need Tools
An agent is an LLM plus tools — functions or APIs that let it act on the world: search, run code, calculate. Here we give ours a calculator.
import os
from langchain_openai import ChatOpenAI
from langchain.tools import Tool
from langchain_community.utilities import LLMMathChain
def main():
# Ensure OPENAI_API_KEY is set
llm = ChatOpenAI(model="gpt-3.5-turbo", temperature=0)
# Create a basic math tool
llm_math_chain = LLMMathChain.from_llm(llm)
math_tool = Tool.from_function(
func=llm_math_chain.run,
name="Calculator",
description="Useful for when you need to answer questions about math."
)
tools = [math_tool]
print("Basic math tool created and ready!")
if __name__ == "__main__":
main()Choosing Your Agent Type
The agent type defines how it reasons. We'll use create_react_agent — ReAct means Reason and Act: it plans, observes results, then refines.
Combining Components
Now combine the pieces: create_react_agent takes your LLM, tools, and prompt to build the logic, then AgentExecutor wraps it to make it runnable.
import os
from langchain_openai import ChatOpenAI
from langchain.tools import Tool
from langchain_community.utilities import LLMMathChain
from langchain.agents import AgentExecutor, create_react_agent
from langchain_core.prompts import ChatPromptTemplate
def main():
llm = ChatOpenAI(model="gpt-3.5-turbo", temperature=0)
llm_math_chain = LLMMathChain.from_llm(llm)
math_tool = Tool.from_function(
func=llm_math_chain.run,
name="Calculator",
description="Useful for when you need to answer questions about math."
)
tools = [math_tool]
# Define the prompt for the agent
prompt = ChatPromptTemplate.from_messages([
("system", "You are a helpful AI assistant. Use tools when necessary."),
("human", "{input}"),
("placeholder", "{agent_scratchpad}")
])
# Create the agent
agent = create_react_agent(llm, tools, prompt)
# Create the agent executor
agent_executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
print("Agent assembled and ready for action!")
if __name__ == "__main__":
main()Asking Your Agent a Question
With the agent assembled, give it a task via invoke. Ask a math question and watch it reach for its calculator tool to answer.
import os
from langchain_openai import ChatOpenAI
from langchain.tools import Tool
from langchain_community.utilities import LLMMathChain
from langchain.agents import AgentExecutor, create_react_agent
from langchain_core.prompts import ChatPromptTemplate
def main():
llm = ChatOpenAI(model="gpt-3.5-turbo", temperature=0)
llm_math_chain = LLMMathChain.from_llm(llm)
math_tool = Tool.from_function(
func=llm_math_chain.run,
name="Calculator",
description="Useful for when you need to answer questions about math."
)
tools = [math_tool]
prompt = ChatPromptTemplate.from_messages([
("system", "You are a helpful AI assistant. Use tools when necessary."),
("human", "{input}"),
("placeholder", "{agent_scratchpad}")
])
agent = create_react_agent(llm, tools, prompt)
agent_executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
print("Asking the agent: 'What is 123 multiplied by 456?'")
response = agent_executor.invoke({"input": "What is 123 multiplied by 456?"})
print("\nAgent's final answer:")
print(response["output"])
if __name__ == "__main__":
main()Understanding the Agent's Response
With verbose=True you see the agent's thought process: Thought, Action, Action Input, Observation, then Final Answer. That transparency is key to debugging.
Your Complete First Agent!
Here's your complete first agent. Set your API key, run it, and try changing the input question to see it reason through different problems.
import os
from langchain_openai import ChatOpenAI
from langchain.tools import Tool
from langchain_community.utilities import LLMMathChain
from langchain.agents import AgentExecutor, create_react_agent
from langchain_core.prompts import ChatPromptTemplate
def main():
# 1. Set up your LLM
# Ensure OPENAI_API_KEY is set as an environment variable
# os.environ["OPENAI_API_KEY"] = "YOUR_KEY_HERE" # DO NOT hardcode!
try:
llm = ChatOpenAI(model="gpt-3.5-turbo", temperature=0)
except Exception as e:
print(f"Error: {e}. Please ensure OPENAI_API_KEY is set.")
return
# 2. Define your tools
llm_math_chain = LLMMathChain.from_llm(llm)
math_tool = Tool.from_function(
func=llm_math_chain.run,
name="Calculator",
description="Useful for when you need to answer questions about math."
)
tools = [math_tool]
# 3. Define the agent's prompt
prompt = ChatPromptTemplate.from_messages([
("system", "You are a helpful AI assistant. Use tools when necessary."),
("human", "{input}"),
("placeholder", "{agent_scratchpad}")
])
# 4. Create the agent
agent = create_react_agent(llm, tools, prompt)
# 5. Create the AgentExecutor
agent_executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
# 6. Run the agent
print("\n--- Running the Agent ---")
question = "What is the square root of 144 plus 25?"
print(f"Agent input: '{question}'")
response = agent_executor.invoke({"input": question})
print("\n--- Agent's Final Answer ---")
print(response["output"])
if __name__ == "__main__":
main()Agent Components Check
You've seen how to build a basic agent. Which of the following are essential components when constructing a LangChain agent using create_react_agent?
Recap: Your First Agent!
Recap: you built a real agent — set up the environment, connected an LLM, added a tool, assembled it with create_react_agent and AgentExecutor, and watched it think.
تعلم AI Agents with LangChain & Autonomous Workflows مع معلم ذكاء اصطناعي — مجانًا
اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.
- الدورات
- 12
- الدروس
- 50
الأسئلة الشائعة
هل درس «بناء أول وكيل بسيط لك» مجاني؟
نعم — نص درس «بناء أول وكيل بسيط لك» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة AI Agents with LangChain & Autonomous Workflows، انتقل إلى CoddyKit PRO. تتضمن دورة AI Agents with LangChain & Autonomous Workflows 4 دروس في المجموع.
ماذا ستتعلم في «بناء أول وكيل بسيط لك»؟
اتبع دليلًا خطوة بخطوة لإعداد بيئتك وبناء وكيل ذكاء اصطناعي أساسي باستخدام LangChain تتمرن على AI Agents with LangChain & Autonomous Workflows مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ AI Agents with LangChain & Autonomous Workflows؟
لا تُشترط خبرة سابقة. AI Agents with LangChain & Autonomous Workflows على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.
كم من الوقت يستغرق درس «بناء أول وكيل بسيط لك»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس AI Agents with LangChain & Autonomous Workflows هذا؟
نعم. كل درس في AI Agents with LangChain & Autonomous Workflows يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- فهم وكلاء الذكاء الاصطناعي ونماذج اللغة الكبيرة
- شرح المكونات الأساسية لـ LangChain
- بناء أول وكيل بسيط لك
- إضافة الذاكرة وحالة المحادثة إلى الوكلاء