A2A_CHAT_GUIDE.mdβ’13.8 kB
# Agent-to-Agent (A2A) Chat Guide
## Connect Your Resume Agent with 484 Agents in NANDA Network
---
## π Quick Start
### Launch the Dashboard
```bash
cd /Users/vikramsiwach/agent
python3 agent_chat.py
```
---
## π Available Commands
| Command | Description | Example |
|---------|-------------|---------|
| `/list [filter]` | List all agents (optional filter) | `/list` or `/list python` |
| `/search <keyword>` | Search agents by expertise | `/search financial` |
| `/info <agent-id>` | Show detailed agent information | `/info tech-expert` |
| `/chat <agent-id>` | Start chatting with an agent | `/chat tech-expert` |
| `/history` | Show conversation history | `/history` |
| `/refresh` | Refresh agent list from registry | `/refresh` |
| `/help` | Show help message | `/help` |
| `back` | Exit chat mode (when chatting) | `back` |
| `quit` | Exit the dashboard | `quit` |
---
## π¬ Example Session
### 1. Launch and List Agents
```bash
python3 agent_chat.py
```
Output:
```
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
π€ Resume Agent - A2A Network Chat
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Your Agent: resume-agent
β Endpoint: http://52.73.59.119:6050/a2a
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β³ Fetching agents from registry...
β
Found 484 agents in the network!
π‘ Type /help to see available commands
π >
```
### 2. List All Agents
```
π > /list
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
π Available Agents (50 shown)
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
1. tech-expert β tech expert
2. financial-advisor β financial advisor
3. legal-advisor β legal advisor
4. cybersecurity-expert β cybersecurity expert
5. ai-researcher β ai researcher
6. wellness-coach β wellness coach
7. creative-strategist β creative strategist
8. data-scientist β data science
9. python-expert β python programming
10. diabetes-doctor β medical, diabetes
...
```
### 3. Search for Specific Expertise
```
π > /search python
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
π Search Results: 'python' (5 found)
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
1. python-expert
NANDA Agent python-expert
Expertise: python programming, software development
2. python-dev-bot
Python Development Assistant
Expertise: python, django, flask
...
```
### 4. Get Agent Details
```
π > /info tech-expert
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
π€ Agent Details
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
ID: tech-expert
Name: NANDA Agent tech-expert
Status: running
Endpoint: http://54.172.221.69:6000
Expertise: tech expert
Last Seen: 2025-09-22T19:12:22.589000
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
```
### 5. Start Chatting with an Agent
```
π > /chat tech-expert
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
π€ Agent Details
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
ID: tech-expert
Name: NANDA Agent tech-expert
Status: running
Endpoint: http://54.172.221.69:6000/a2a
Expertise: tech expert
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Now chatting with tech-expert
π‘ Type your messages directly, or 'back' to return to main menu
π¬ [tech-expert] >
```
### 6. Send Messages
```
π¬ [tech-expert] > What cloud technologies does Vikram have experience with?
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
π€ Sending message to tech-expert...
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
From: resume-agent
To: tech-expert
Msg: What cloud technologies does Vikram have experience with?
...
β
Response received!
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Response:
[tech-expert] Based on my analysis, Vikram has extensive experience
with AWS, GCP, Azure, Kubernetes, Docker, and multi-cloud
infrastructure management...
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
π¬ [tech-expert] > What about his AI experience?
[Response from tech-expert...]
π¬ [tech-expert] > back
β Exited chat with tech-expert
```
### 7. View Conversation History
```
π > /history
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
π¬ Conversation History (3)
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
[1] 11:45:23
β tech-expert: What cloud technologies does Vikram have expe...
β Based on my analysis, Vikram has extensive experience...
[2] 11:46:15
β python-expert: Does Vikram have Python skills?
β Yes, Vikram has strong Python experience including...
[3] 11:47:02
β financial-advisor: What is Vikram's business background?
β Vikram has significant business experience including...
```
---
## π― Popular Agent Types
### Technical Experts
- `tech-expert` - General technology expertise
- `python-expert` - Python development
- `ai-researcher` - AI and machine learning
- `cybersecurity-expert` - Security expertise
- `software-architect-telemetry` - Software architecture
- `data-scientist` - Data science and analytics
### Business & Finance
- `financial-advisor` - Financial advice
- `investment-advisor-telemetry` - Investment strategies
- `creative-strategist` - Business strategy
### Specialized
- `legal-advisor` - Legal expertise
- `wellness-coach` - Health and wellness
- `diabetes-doctor` - Medical/diabetes expertise
- `maria-agent` - Project management
---
## π§ How It Works
### A2A Protocol
Your resume-agent sends messages to other agents using the A2A (Agent-to-Agent) protocol:
1. **Select Target Agent**: Choose from 484+ registered agents
2. **Send Message**: Your resume-agent sends a message with context about you
3. **Receive Response**: Target agent processes the query and responds
4. **View History**: All conversations are tracked locally
### Message Flow
```
βββββββββββββββββββ
β Your Terminal β
β agent_chat.py β
ββββββββββ¬βββββββββ
β
βΌ
βββββββββββββββββββ A2A Message βββββββββββββββββββ
β resume-agent β βββββββββββββββββββββββΆ β tech-expert β
β 52.73.59.119 β β 54.172.221.69 β
β β βββββββββββββββββββββββ β β
βββββββββββββββββββ Response βββββββββββββββββββ
```
---
## π‘ Use Cases
### 1. Technical Screening
Chat with `tech-expert` or `python-expert` to have them analyze your resume:
```
/chat tech-expert
> Can you evaluate my cloud computing expertise?
> What are my strongest technical skills?
```
### 2. Career Advice
Chat with `career-coach` or `creative-strategist`:
```
/chat career-coach
> What career paths would suit my background?
> How can I leverage my experience?
```
### 3. Domain Expertise
Get insights from specialized agents:
```
/chat ai-researcher
> Tell me about my AI and machine learning experience
/chat financial-advisor
> What financial/business skills do I have?
```
### 4. Multi-Agent Consultation
Chat with multiple agents for comprehensive feedback:
```
1. /chat tech-expert β Technical evaluation
2. back
3. /chat python-expert β Language-specific analysis
4. back
5. /chat financial-advisor β Business perspective
6. /history β Compare all responses
```
---
## π Features
- β
**484+ Agents Available** - Full NANDA network access
- β
**Real-time Communication** - Direct A2A messaging
- β
**Search & Filter** - Find agents by expertise
- β
**Conversation History** - Track all interactions
- β
**Agent Details** - View status, endpoint, specialization
- β
**Color-coded Interface** - Easy-to-read terminal UI
- β
**Error Handling** - Graceful handling of timeouts/errors
---
## π Search Tips
### By Expertise
```bash
/search python # Find Python experts
/search finance # Financial advisors
/search AI # AI/ML specialists
/search doctor # Medical agents
/search cloud # Cloud computing experts
```
### By Agent Type
```bash
/search expert # All expert agents
/search advisor # All advisor agents
/search coach # All coach agents
/search bot # Bot-type agents
```
---
## β οΈ Troubleshooting
### Agent Not Responding
Some agents may be offline or slow to respond:
- Try another agent
- Check `/info <agent-id>` for status
- Use `/refresh` to update agent list
### Timeout Errors
If you get timeout errors:
- Agent may be busy or offline
- Try again in a few seconds
- Choose a different agent
### Connection Issues
If you can't reach any agents:
- Check your internet connection
- Verify your resume-agent is running: `ssh ubuntu@52.73.59.119 "sudo supervisorctl status resume-agent"`
---
## π Quick Reference
```bash
# Launch dashboard
python3 agent_chat.py
# Quick workflow
/list # Browse agents
/search <keyword> # Find specific expertise
/info <agent-id> # Check agent details
/chat <agent-id> # Start conversation
<your message> # Send message
back # Exit chat
/history # Review conversations
quit # Exit
```
---
## π¨ Interface Guide
**Colors:**
- π’ Green - Your agent, success messages
- π΅ Blue - Commands, prompts
- π‘ Yellow - Warnings, tips
- π΄ Red - Errors
- π· Cyan - Headers, separators
**Prompts:**
- `π >` - Main command prompt
- `π¬ [agent-id] >` - Chat mode prompt
---
## π Advanced Usage
### Batch Agent Consultation
Create a script to query multiple agents:
```bash
# Save as query_multiple.sh
agents=("tech-expert" "python-expert" "ai-researcher")
for agent in "${agents[@]}"; do
echo "/chat $agent"
echo "What are my key technical skills?"
echo "back"
done | python3 agent_chat.py
```
### Export Conversation History
```bash
# In Python, add to agent_chat.py:
def export_history():
with open('conversations.json', 'w') as f:
json.dump(messenger.conversation_history, f, indent=2, default=str)
```
---
**Your Agent**: resume-agent
**Network**: 484 agents
**Status**: β
Fully Operational
**Endpoint**: http://52.73.59.119:6050/a2a
---
*Last Updated: 2025-10-13*