github/langchain
1
0
Fork 0
mirror of https://github.com/hwchase17/langchain.git synced 2025-09-08 06:23:20 +00:00
Code Issues Packages Projects Releases Wiki Activity

improve agent documentation (#4062)

Browse Source
This commit is contained in:
Harrison Chase
2023-05-03 22:44:01 -07:00
committed by GitHub
parent b1446bea5f
commit 087a4bd2b8
2 changed files with 69 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
docs/use_cases/personal_assistants.md
View File

@@ -1,23 +1,46 @@
# Personal Assistants (Agents)
# Agents
> [Conceptual Guide](https://docs.langchain.com/docs/use-cases/personal-assistants)
We use "personal assistant" here in a very broad sense.
Personal assistants have a few characteristics:
- They can interact with the outside world
- They have knowledge of your data
- They remember your interactions
Really all of the functionality in LangChain is relevant for building a personal assistant.
Highlighting specific parts:
Agents can be used for a variety of tasks.
Agents combine the decision making ability of a language model with tools in order to create a system
that can execute and implement solutions on your behalf. Before reading any more, it is highly
recommended that you read the documentation in the `agent` module to understand the concepts associated with agents more.
Specifically, you should be familiar with what the `agent`, `tool`, and `agent executor` abstractions are before reading more.
- [Agent Documentation](../modules/agents.rst) (for interacting with the outside world)
- [Index Documentation](../modules/indexes.rst) (for giving them knowledge of your data)
- [Memory](../modules/memory.rst) (for helping them remember interactions)
Specific examples of this include:
## Create Your Own Agent
Once you have read that documentation, you should be prepared to create your own agent.
What exactly does that involve?
Here's how we recommend getting started with creating your own agent:
### Step 1: Create Tools
Agents are largely defined by the tools they can use.
If you have a specific task you want the agent to accomplish, you have to give it access to the right tools.
We have many tools natively in LangChain, so you should first look to see if any of them meet your needs.
But we also make it easy to define a custom tool, so if you need custom tools you should absolutely do that.
### (Optional) Step 2: Modify Agent
The built-in LangChain agent types are designed to work well in generic situations,
but you may be able to improve performance by modifying the agent implementation.
There are several ways you could do this:
1. Modify the base prompt. This can be used to give the agent more context on how it should behave, etc.
2. Modify the output parser. This is necessary if the agent is having trouble parsing the language model output.
### (Optional) Step 3: Modify Agent Executor
This step is usually not necessary, as this is pretty general logic.
Possible reasons you would want to modify this include adding different stopping conditions, or handling errors
## Examples
Specific examples of agents include:
- [AI Plugins](agents/custom_agent_with_plugin_retrieval.ipynb): an implementation of an agent that is designed to be able to use all AI Plugins.
- [Plug-and-PlAI (Plugins Database)](agents/custom_agent_with_plugin_retrieval_using_plugnplai.ipynb): an implementation of an agent that is designed to be able to use all AI Plugins retrieved from PlugNPlAI.