Personalizando a lógica das cadeias
Descubra como criar cadeias personalizadas e integrar suas próprias funções e lógica Python aos fluxos de trabalho do LangChain.
Personalizando a lógica das cadeias é uma aula grátis de AI Agents with LangChain & Autonomous Workflows no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de AI Agents with LangChain & Autonomous Workflows, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de AI Agents with LangChain & Autonomous Workflows inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
Beyond Standard Chains
In previous lessons, you learned how to create sequential chains to perform multi-step operations. These chains are powerful for connecting standard LangChain components like prompts and LLMs.
But what if you need to do something unique? What if you need to process data in a specific way before it reaches your LLM, or format its output afterward?
When to Add Custom Steps
Standard chains are great, but they can't handle every scenario. Custom logic allows you to:
- Pre-process inputs: Clean, validate, or transform user input before sending it to a prompt or LLM.
- Post-process outputs: Parse, filter, or reformat LLM responses for display or further use.
- Integrate external logic: Call your own Python functions, external APIs, or apply conditional routing.
- Handle complex data transformations: Convert data types, merge information, or apply business rules.
Introducing RunnableLambda
LangChain's RunnableLambda is your key to integrating custom Python functions into chains. It wraps any Python callable (like a function or a lambda expression) and makes it behave like a LangChain Runnable component.
This means you can seamlessly insert your own Python logic anywhere in a chain, just like you would an LLM or a prompt template!
Your First Custom Function
Let's start with a simple custom function that adds an exclamation mark to a string. We'll wrap it with RunnableLambda to make it part of a chain.
Try running this basic example:
from langchain_core.runnables import RunnableLambda
def add_exclamation(text: str) -> str:
return text + "!"
if __name__ == "__main__":
# Wrap your function to make it a Runnable
custom_step = RunnableLambda(add_exclamation)
# Invoke it like any other Runnable
result = custom_step.invoke("Hello CoddyKit")
print(result)Chaining Custom Logic
The real power comes when you combine RunnableLambda with other LangChain components. You can place your custom logic at the beginning, middle, or end of a chain.
For example, you might have a custom function that prepares the input for a prompt, or one that processes the output from an LLM.
Custom Pre-processing Chain
Here's an example where a custom step pre-processes the input by converting it to uppercase before it's passed to a PromptTemplate and then to a simulated LLM.
Notice how the `uppercase_input` function expects a dictionary, mirroring how chain inputs often work.
from langchain_core.prompts import PromptTemplate
from langchain_core.runnables import RunnableLambda
from langchain_community.llms import FakeListLLM
def uppercase_input(data: dict) -> dict:
# Ensure 'text' key exists and convert its value to uppercase
return {"text": data.get("text", "").upper()}
if __name__ == "__main__":
# A simulated LLM for demonstration
llm = FakeListLLM(responses=["I received your uppercase text!"])
# Define a simple prompt template
prompt = PromptTemplate.from_template(
"You mentioned: {text}. What do you think?"
)
# Create the custom pre-processing step
pre_process_step = RunnableLambda(uppercase_input)
# Build the chain: custom_step -> prompt -> llm
custom_chain = pre_process_step | prompt | llm
# Invoke the chain with lowercase input
input_data = {"text": "hello world"}
response = custom_chain.invoke(input_data)
print(response)Custom Post-processing Logic
Just as you can pre-process inputs, you can also post-process the outputs from an LLM. This is useful for:
- Extracting specific information from a longer response.
- Formatting the output for display in a UI.
- Converting the output to a different data structure (e.g., JSON).
- Adding a custom header or footer to the LLM's message.
Example: Custom Output Formatting
Let's create a custom function that takes the raw LLM response and wraps it with a friendly message. This makes the output more user-friendly.
Run this example to see the LLM's response being transformed:
from langchain_core.runnables import RunnableLambda
from langchain_community.llms import FakeListLLM
def format_llm_output(llm_response: str) -> str:
# Add a custom prefix and suffix to the LLM's message
return f"🤖 AI says: '{llm_response.strip()}' - Over and out!"
if __name__ == "__main__":
# A simulated LLM for demonstration
llm = FakeListLLM(responses=["The weather is sunny today."])
# Create the custom post-processing step
post_process_step = RunnableLambda(format_llm_output)
# Build the chain: llm -> custom_step
custom_chain = llm | post_process_step
# Invoke the chain (input doesn't affect FakeListLLM's response here)
response = custom_chain.invoke("What's the weather like?")
print(response)Adding Conditional Logic
RunnableLambda isn't just for simple transformations. You can embed complex Python logic, including conditionals, loops, and even calls to other services, directly into your chain.
For instance, you could have a custom step that checks if an input meets certain criteria and, if not, redirects the flow or returns a default message, creating dynamic and intelligent workflows.
Quick Check: Custom Chain Steps
Which of the following are good use cases for integrating custom Python logic (e.g., using RunnableLambda) into a LangChain workflow?
Recap & Next Steps
You've learned how to inject your own Python functions and logic into LangChain workflows using RunnableLambda. This powerful feature allows you to:
- Perform custom pre-processing on inputs.
- Apply custom post-processing to LLM outputs.
- Integrate complex or conditional logic within your chains.
By mastering custom chain logic, you gain immense flexibility to tailor LangChain to your exact needs, building truly unique and intelligent applications. Next, explore how to use pre-built toolkits to add even more capabilities to your agents!
Perguntas Frequentes
A aula “Personalizando a lógica das cadeias” é grátis?
Sim — o texto completo de “Personalizando a lógica das cadeias” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de AI Agents with LangChain & Autonomous Workflows, atualize para CoddyKit PRO. O curso de AI Agents with LangChain & Autonomous Workflows inclui 4 aulas no total.
O que vou aprender em “Personalizando a lógica das cadeias”?
Descubra como criar cadeias personalizadas e integrar suas próprias funções e lógica Python aos fluxos de trabalho do LangChain. Você pratica AI Agents with LangChain & Autonomous Workflows com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar AI Agents with LangChain & Autonomous Workflows?
Nenhuma experiência prévia é necessária. AI Agents with LangChain & Autonomous Workflows no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Personalizando a lógica das cadeias”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de AI Agents with LangChain & Autonomous Workflows?
Sim. Cada aula de AI Agents with LangChain & Autonomous Workflows inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Introdução às cadeias do LangChain
- Cadeias sequenciais e simples
- Personalizando a lógica das cadeias
- Roteamento e cadeias condicionais