How langchain-ai/ambient-agent-101 works
Ambient Agent 101 is a tutorial-backed email assistant that triages incoming messages, responds or notifies as appropriate, and can involve a human reviewer and retain learned preferences. The graph shows the documented workflow variants, tool integrations, Gmail ingestion, and optional evaluation. Source excerpts are partial, so uncertain internal routing and unsampled tool behavior are not represented.
Main entry points: email_assistant_hitl_memory_gmail.py Gmail assistant · email_assistant.py Triage agent · email_assistant_hitl_memory.py Memory assistant · base.py Tool registry
Components 19
Assistant workflows
- Triage agent
src/email_assistant/email_assistant.py - Human review
src/email_assistant/email_assistant_hitl.py - Memory assistant
src/email_assistant/email_assistant_hitl_memory.py - Gmail assistant
src/email_assistant/email_assistant_hitl_memory_gmail.py
Tools and integrations
- Tool registry
src/email_assistant/tools/base.py - Email tools
src/email_assistant/tools/default/email_tools.py - Calendar tools
src/email_assistant/tools/default/calendar_tools.py
Gmail operations
- Gmail tools
src/email_assistant/tools/gmail/gmail_tools.py - Email ingestion
src/email_assistant/tools/gmail/run_ingest.py - Gmail scheduling
src/email_assistant/tools/gmail/setup_cron.py
Evaluation
- Email examples
eval/email_dataset.py - Triage evaluation
eval/evaluate_triage.py
Other components
- Email user
- Language model
- Human reviewer
- Agent Inbox
- Preference store
- Google APIs
- LangGraph server
Connections 28
- Email user → Triage agent: submits email
- Triage agent → Language model: requests triage and response
- Triage agent → Tool registry: gets tools
- Triage agent → Email tools: invokes tools
- Triage agent → Calendar tools: invokes tools
- Email user → Human review: submits email
- Human review → Agent Inbox: requests review
- Human reviewer → Agent Inbox: reviews actions
- Human review → Language model: requests response
- Human review → Tool registry: gets tools
- Email user → Memory assistant: submits email
- Memory assistant → Preference store: reads and updates preferences
- Memory assistant → Agent Inbox: requests review
- Memory assistant → Language model: requests response
- Memory assistant → Tool registry: gets tools
- Email user → Gmail assistant: submits email
- Gmail assistant → Preference store: reads and updates preferences
- Gmail assistant → Agent Inbox: requests review
- Gmail assistant → Language model: requests response
- Gmail assistant → Tool registry: gets tools
- Tool registry → Gmail tools: loads optionally
- Gmail assistant → Gmail tools: invokes Gmail tools
- Gmail tools → Google APIs: calls APIs
- Email ingestion → Google APIs: fetches messages
- Email ingestion → LangGraph server: creates graph runs
- Gmail scheduling → Google APIs: schedules ingestion
- Email examples → Triage evaluation: provides examples
- Triage evaluation → Triage agent: evaluates triage