Skip to content

Commit 73ca33e

Browse files
johnymontanajohnymontana
committed
WIP update structure for agent docs
1 parent 038f3ab commit 73ca33e

16 files changed

+556
-77
lines changed

‎agents/agent-gallery/social-media-intern.mdx‎

Whitespace-only changes.

‎agents/concierge.mdx‎

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
---
2+
title: "Concierge"
3+
sidebarTitle: "Concierge"
4+
description:
5+
"Build AI agents that act, not just chat—from natural conversation to
6+
production-ready code"
7+
---
8+
9+
## Build a new agent with Concierge
10+
11+
![](/images/agents/concierge.png)
12+
13+
**Concierge** is Hypermode's AI-powered agent builder that transforms natural
14+
language descriptions into fully functional agents. No coding experience
15+
required.
16+
17+
## Overview
18+
19+
Concierge streamlines agent creation by converting your requirements into
20+
structured, working agent scaffolds through a guided process that takes just
21+
minutes to complete.
22+
23+
## How It Works
24+
25+
### 1. Describe Your Requirements
26+
27+
Simply describe what you want your agent to do in natural language:
28+
29+
```
30+
"I need an agent that can monitor our website for outdated landing pages,
31+
suggest updates every Monday, and then write new headlines."
32+
```
33+
34+
### 2. Configure Your Agent
35+
36+
Concierge guides you through:
37+
38+
- **Defining the agent's role** and primary objectives
39+
- **Selecting tools** from a curated library of integrations
40+
- **Reviewing the agent structure** and reasoning flow
41+
42+
### 3. Deploy and Iterate
43+
44+
Your agent scaffold is generated automatically with all necessary components
45+
configured and ready for deployment.
46+
47+
## Key Benefits
48+
49+
<CardGroup cols={2}>
50+
<Card title="Consistent Prompts" icon="check-circle">
51+
Agent prompts are structured and authored by AI, ensuring consistency across
52+
all your agents.
53+
</Card>
54+
55+
<Card title="Faster Development" icon="clock">
56+
Go from idea to working agent in minutes, not hours or days.
57+
</Card>
58+
59+
<Card title="No Coding Required" icon="user-check">
60+
Build sophisticated agents using natural language descriptions.
61+
</Card>
62+
63+
<Card title="Optimized Results" icon="chart-line">
64+
AI-generated prompts are more interpretable by reasoning models than
65+
hand-written alternatives.
66+
</Card>
67+
</CardGroup>
68+
69+
## Why Concierge Works Better
70+
71+
<Tip>
72+
Traditional hand-written prompts often suffer from inconsistency, verbosity,
73+
or vagueness. Concierge solves this by using AI to author structured prompts
74+
that follow best practices for reasoning models.
75+
</Tip>
76+
77+
### Traditional Approach Challenges
78+
79+
- **Inconsistent formatting** across different prompts
80+
- **Verbose instructions** that can confuse models
81+
- **Vague requirements** leading to unpredictable behavior
82+
- **Manual optimization** required for each agent
83+
84+
### Concierge Advantages
85+
86+
- **Structured syntax** that reasoning models interpret effectively
87+
- **Consistent formatting** across all generated agents
88+
- **Semantic clarity** in instructions and objectives
89+
- **Automated optimization** based on best practices

‎agents/connections.mdx‎

Lines changed: 159 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,159 @@
1+
---
2+
title: "Connections"
3+
sidebarTitle: "Connections"
4+
description:
5+
"Build AI agents that act, not just chat—from natural conversation to
6+
production-ready code"
7+
---
8+
9+
# Connections
10+
11+
**Connections** enable Hypermode Agents to securely access and interact with
12+
external tools, APIs, and services. With over 2,000+ available integrations,
13+
agents can execute tasks across your entire technology stack.
14+
15+
## Overview
16+
17+
Hypermode Agents are built for execution, not just conversation. Connections
18+
provide the bridge between your agents and the tools they need to complete
19+
tasks, from internal APIs to third-party applications and public resources.
20+
21+
## Key Features
22+
23+
<CardGroup cols={2}>
24+
<Card title="2,000+ Integrations" icon="plug">
25+
Access to popular tools, APIs, and services including GitHub, Stripe,
26+
Snowflake, and custom internal systems.
27+
</Card>
28+
29+
<Card title="Role-Based Access" icon="shield-check">
30+
Agents only access tools relevant to their specific role and responsibilities.
31+
</Card>
32+
33+
<Card title="Secure Authentication" icon="lock">
34+
Industry-standard security protocols protect your credentials and data.
35+
</Card>
36+
37+
<Card title="Model Context Protocol" icon="code">
38+
Tools are structured, typed, and traceable for sophisticated agent
39+
reasoning.
40+
</Card>
41+
</CardGroup>
42+
43+
## How Connections Work
44+
45+
### Domain-Specific Tool Assignment
46+
47+
Rather than providing agents with access to all available tools, Connections
48+
uses a curated approach based on the agent's role and domain:
49+
50+
**Frontend Development Agent**
51+
52+
- GitHub (code repository management)
53+
- Linear (issue tracking)
54+
- Vercel (deployment and hosting)
55+
56+
**Revenue Operations Agent**
57+
58+
- Snowflake (data warehousing)
59+
- Stripe (payment processing)
60+
- Internal ticketing API (customer support)
61+
62+
**Marketing Agent**
63+
64+
- HubSpot (CRM and automation)
65+
- Google Analytics (website analytics)
66+
- Mailchimp (email marketing)
67+
68+
### Role-Based Access Control
69+
70+
<Info>
71+
Agents are granted access only to tools that align with their designated role,
72+
improving both security and decision-making clarity.
73+
</Info>
74+
75+
1. **Define agent role** and primary responsibilities
76+
2. **Select relevant tools** from the curated toolkit
77+
3. **Configure permissions** for each integration
78+
4. **Monitor usage** and adjust access as needed
79+
80+
## Model Context Protocol (MCP)
81+
82+
Connections leverage the Model Context Protocol to provide agents with enhanced
83+
tool interaction capabilities:
84+
85+
### Structured Tool Definitions
86+
87+
### Benefits of MCP Integration
88+
89+
<CardGroup cols={1}>
90+
<Card title="Enhanced Reasoning" icon="brain">
91+
Agents understand tool capabilities and parameters as clearly as they
92+
understand text, enabling better planning and execution.
93+
</Card>
94+
95+
<Card title="Sophisticated Planning" icon="route">
96+
Multi-step workflows can be planned and executed with tools working together
97+
seamlessly.
98+
</Card>
99+
100+
<Card title="Improved Debugging" icon="bug">
101+
Structured tool calls provide clear audit trails and error diagnosis
102+
capabilities.
103+
</Card>
104+
105+
<Card title="Tool Reusability" icon="recycle">
106+
Consistent tool definitions enable agents to reuse and combine tools
107+
effectively.
108+
</Card>
109+
</CardGroup>
110+
111+
## Security and Compliance
112+
113+
<Warning>
114+
All connections use secure authentication methods including OAuth 2.0, API
115+
keys, and service account credentials. Credentials are encrypted and never
116+
exposed to the agent's reasoning process.
117+
</Warning>
118+
119+
### Security Features
120+
121+
- **Encrypted credential storage** with enterprise-grade security
122+
- **Audit logging** for all tool interactions
123+
- **Permission scoping** to limit access to necessary resources only
124+
- **Regular security updates** and compliance monitoring
125+
126+
## Getting Started
127+
128+
## Add a new Connections
129+
130+
![](/images/agents/connections-sidebar.png)
131+
132+
## Manage connections
133+
134+
![](/images/agents/connections-manage.png)
135+
136+
<Tip>
137+
Start with a small set of essential tools for your agent's role, then expand
138+
as you identify additional needs through usage patterns.
139+
</Tip>
140+
141+
## Available Integrations
142+
143+
Popular integration categories include:
144+
145+
- **Development Tools**: GitHub, GitLab, Jira, Linear
146+
- **Data & Analytics**: Snowflake, BigQuery, Tableau, Looker
147+
- **Customer Success**: Salesforce, HubSpot, Zendesk, Intercom
148+
- **Finance**: Stripe, QuickBooks, Xero, PayPal
149+
- **Marketing**: Mailchimp, Constant Contact, Google Ads, Facebook Ads
150+
- **Productivity**: Slack, Microsoft Teams, Google Workspace, Notion
151+
152+
### Test Integration
153+
154+
Verify that connections work correctly by testing basic operations first.
155+
156+
<Info>
157+
Custom integrations can be built for internal APIs and proprietary systems.
158+
Contact support for assistance with custom connection development.
159+
</Info>

‎agents/example-agents.mdx‎

Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
---
2+
title: "Agent Gallery"
3+
sidebarTitle: "Agent Gallery"
4+
description: "Explore example agents built with Hypermode Agents"
5+
---
6+
7+
## Agent Gallery
8+
9+
Discover powerful AI agents built to handle specific tasks and workflows. Each
10+
agent is designed with unique capabilities to help you automate processes,
11+
analyze data, and enhance productivity.
12+
13+
<CardGroup cols={2}>
14+
<Card
15+
title="Data Analyst Agent"
16+
icon="chart-line"
17+
href="/agents/agent-gallery/social-media-intern"
18+
>
19+
Automatically analyzes datasets, generates insights, and creates visualizations. Perfect for business intelligence and reporting workflows.
20+
</Card>
21+
22+
<Card
23+
title="Content Writer Agent"
24+
icon="pen-to-square"
25+
href="/agents/content-writer"
26+
>
27+
Creates high-quality blog posts, articles, and marketing copy. Maintains brand
28+
voice and optimizes content for SEO.
29+
</Card>
30+
31+
<Card title="Code Review Agent" icon="code" href="/agents/code-reviewer">
32+
Reviews code for bugs, security vulnerabilities, and best practices. Provides
33+
detailed feedback and suggestions for improvement.
34+
</Card>
35+
36+
<Card
37+
title="Customer Support Agent"
38+
icon="headset"
39+
href="/agents/customer-support"
40+
>
41+
Handles customer inquiries, resolves common issues, and escalates complex
42+
problems to human agents when needed.
43+
</Card>
44+
45+
<Card
46+
title="Research Assistant Agent"
47+
icon="magnifying-glass"
48+
href="/agents/research-assistant"
49+
>
50+
Conducts thorough research on any topic, summarizes findings, and provides
51+
citations. Ideal for academic and business research.
52+
</Card>
53+
54+
<Card
55+
title="Social Media Manager Agent"
56+
icon="share-nodes"
57+
href="/agents/social-media-manager"
58+
>
59+
Creates and schedules social media content, monitors engagement, and provides
60+
analytics on social media performance.
61+
</Card>
62+
63+
<Card
64+
title="Email Marketing Agent"
65+
icon="envelope"
66+
href="/agents/email-marketing"
67+
>
68+
Designs email campaigns, segments audiences, and optimizes send times for
69+
maximum engagement and conversion rates.
70+
</Card>
71+
72+
<Card
73+
title="Project Manager Agent"
74+
icon="list-check"
75+
href="/agents/project-manager"
76+
>
77+
Tracks project progress, manages timelines, assigns tasks, and sends automated
78+
updates to stakeholders.
79+
</Card>
80+
81+
<Card
82+
title="Financial Advisor Agent"
83+
icon="chart-pie"
84+
href="/agents/financial-advisor"
85+
>
86+
Analyzes financial data, provides investment recommendations, and helps with
87+
budgeting and financial planning.
88+
</Card>
89+
90+
<Card title="HR Recruitment Agent" icon="users" href="/agents/hr-recruitment">
91+
Screens resumes, schedules interviews, and matches candidates with job
92+
requirements. Streamlines the hiring process.
93+
</Card>
94+
95+
<Card
96+
title="Inventory Manager Agent"
97+
icon="boxes-stacked"
98+
href="/agents/inventory-manager"
99+
>
100+
Monitors stock levels, predicts demand, and automates reordering. Prevents
101+
stockouts and reduces excess inventory.
102+
</Card>
103+
104+
<Card
105+
title="Translation Agent"
106+
icon="language"
107+
href="/agents/translation"
108+
>
109+
Translates documents and content across multiple languages while maintaining context and cultural nuances.
110+
</Card>
111+
</CardGroup>
112+
113+
## Getting Started
114+
115+
Each agent comes with:
116+
117+
- **Pre-built workflows** that you can customize for your needs
118+
- **Integration capabilities** with popular tools and platforms
119+
- **Monitoring dashboards** to track performance and results
120+
- **Documentation** with setup guides and best practices
121+
122+
<Tip>
123+
New to AI agents? Start with the **Data Analyst Agent** or **Content Writer
124+
Agent** for quick wins and easy implementation.
125+
</Tip>
126+
127+
## Custom Agents
128+
129+
Don't see what you need? Our platform supports building custom agents tailored
130+
to your specific requirements.
131+
132+
<Card title="Build Custom Agent" icon="wrench" href="/agents/custom-builder">
133+
Create your own AI agent with our no-code builder. Define custom workflows,
134+
integrate with your tools, and deploy in minutes.
135+
</Card>
136+
137+
---
138+
139+
<Info>
140+
All agents are continuously updated with the latest AI capabilities and
141+
security features. Check individual agent pages for recent updates and
142+
changelog.
143+
</Info>

0 commit comments

Comments
 (0)