@@ -23,76 +23,59 @@ applied to payment processing and financial data management.
2323
2424## Prerequisites
2525
26- - A [ Hypermode Pro workspace] ( https://hypermode.com/login )
26+ - A [ Hypermode Agents workspace] ( https://hypermode.com/login )
2727- A [ Stripe account] ( https://stripe.com ) (test mode is perfect for this
2828 tutorial)
2929- Access to your operations tools (for example, internal knowledge base) - we'll
3030 use Notion for this tutorial
3131- Basic familiarity with modern chat interfaces (no coding required)
3232- Estimated time: 15 minutes
3333
34- ## Step 1: Sign in and open your workspace
34+ ## Sign in to Hypermode Agents
3535
36- Head to [ hypermode.com] ( https://hypermode.com ) , sign in, and create your first
37- workspace if you haven't already.
36+ Head to [ hypermode.com] ( https://hypermode.com ) and sign in to Hypermode Agents.
3837
39- ## Step 2: Open Hypermode Concierge + Agent builder
38+ ## Creating your Stripe agent
4039
41- In the left sidebar, click the [ threads ] ( /agents/work ) icon.
40+ ![ Create new agent ] ( /images/connections/stripe/create-new-agent-button.png )
4241
43- Select the "Create new" option and select the
44- [ Hypermode Concierge + Agent builder] ( /agents/create-agent#build-a-new-agent-with-concierge ) .
45- This is Hypermode's AI-powered agent that transforms natural language
46- descriptions into fully functional agents that can work with specialized tools
47- like Stripe.
42+ ### Create a new agent
4843
49- ![ Create new agent ] ( /images/tutorials/first-operations-agent/ create- new.png )
44+ From the Hypermode Agents console, create a new agent:
5045
51- ## Step 3: Describe the job
46+ 1 . Click the ** Create new Agent** button from the agents view or select _ Create
47+ new >> Create new agent_ from the threads view.
48+ 2 . Enter a description of your agent
5249
53- In plain English, type something like :
50+ We'll use the following description for our financial operations agent :
5451
5552``` text
56- Let's build a financial operations agent that can process payments, handle refunds,
57- create invoices, and analyze financial data using Stripe. It should be able to
58- work with our internal policies from Notion to make decisions about refunds.
53+ Let's build a financial operations agent that can process payments, handle
54+ refunds, create invoices, and analyze financial data using Stripe.
5955```
6056
61- Concierge will ask clarifying questions about your specific operations needs,
62- draft an initial system prompt, and suggest the Stripe connection along with any
63- other tools you mention.
57+ ![ Create new agent modal] ( /images/tutorials/first-operations-agent/operations-agent-description.png )
6458
65- ![ Create new agent with Concierge ] ( /images/tutorials/first-operations-agent/create-new-concierge.png )
59+ ### Agent profile
6660
67- ## Step 4: Refine and create your agent
61+ You can view and edit agent details in the agent profile. The agent profile
62+ includes the agent name, description, and instructions. You can also view your
63+ threads with this agent as well as manage the agent's tasks and knowledge.
6864
69- Follow the Concierge agent's guided steps to fully specify your agent's
70- operational scope. The Concierge will help you define what financial operations
71- your agent should handle, from simple payment processing to complex refund
72- policy decisions.
65+ ![ Agent profile] ( /images/tutorials/first-operations-agent/operations-agent-profile-view.png )
7366
74- Once you've fully specified the details, your new operations agent is created
75- and ready to connect to Stripe.
67+ ### Agent instructions
7668
77- ![ Hypermode Create Agent] ( /images/tutorials/first-operations-agent/hypermode-create-agent.png )
69+ You can edit the agent instructions in the agent profile. Editing the agent's
70+ instructions is useful for personalizing your agent and customizing how your
71+ agent will work with you and your team.
7872
79- Your agent will now appear in the Agents page, ready to be configured with
80- Stripe access.
73+ ![ Create agent modal] ( /images/tutorials/first-operations-agent/edit-operations-agent-instructions.png )
8174
82- ![ Hypermode Agent page ] ( /images/tutorials/first-operations- agent/hypermode-agent-page.png )
75+ ## Refine your agent instructions
8376
84- ## Step 5: Review your agent details
85-
86- You can see the details of your agent, including the system prompt that
87- Concierge created for financial operations.
88-
89- ![ Hypermode Agent details] ( /images/tutorials/first-operations-agent/hypermode-agent-details.png )
90-
91- ## Step 6: Refine your agent instructions
92-
93- You can review the Instructions. Hypermode Agents behave as the "system prompt"
94- tells them. Edit the prompt by pasting the template below into the
95- "Instructions" field:
77+ Optionally, you can edit the agent instructions by pasting the template below
78+ into the "Instructions" field:
9679
9780``` text
9881## Description
@@ -180,18 +163,28 @@ Example Output Structure:
180163Always ask if the user needs additional financial reports, policy clarifications, or transaction details.
181164```
182165
183- Press ** Save** .
184-
185- ## Step 7: Add the Stripe connection
166+ ## Add the Stripe connection
186167
187168Let's configure the Stripe connection so your agent can access your payment
188- processing capabilities. Select the ** "Add connection"** button on the
189- [ Connections] ( /agents/connections ) tab.
169+ processing capabilities.
170+
171+ ### Add the Stripe connection
172+
173+ To add the Stripe connection:
174+
175+ 1 . Select the Connection tab
176+ 2 . Select "Connect" next to Stripe in the list of available connections
190177
191- ![ Connect your agent ] ( /images/tutorials/first-operations-agent/ add-connection.png )
178+ ![ Add Stripe connection ] ( /images/connections/stripe/stripe- add-connection.png )
192179
193- Search for and select ** Stripe** from the available connections. You'll need to
194- authorize with your Stripe account credentials.
180+ ### Configure credentials
181+
182+ Enter your Stripe credentials:
183+
184+ - ** API Key** : Your Stripe secret key (starts with ` sk_test_ ` for test mode or
185+ ` sk_live_ ` for live mode)
186+
187+ ![ Stripe connection modal] ( /images/connections/stripe/stripe-configure-connection.png )
195188
196189For this tutorial, we'll use Stripe's test mode. When prompted for your API key,
197190use your test key (starts with ` sk_test_ ` ).
@@ -204,19 +197,27 @@ use your test key (starts with `sk_test_`).
204197 for connection details.
205198</Warning >
206199
200+ ### Test basic connectivity
201+
202+ Start a new thread and test the connection with a simple query:
203+
204+ ``` text
205+ Can you check my Stripe account balance?
206+ ```
207+
208+ You should see a Stripe tool call in the chat history, confirming the connection
209+ works:
210+
211+ ![ Test connection] ( /images/connections/stripe/stripe-test-connection.png )
212+
207213You can also add additional connections for your operations workflow:
208214
209215- ** Knowledge base** (Notion or Google Docs) for _ refund policies and
210216 procedures_
211217- ** Internal communications** (Slack, Teams) for _ notifications and approvals_
212218- ** Accounting tools** (QuickBooks, Xero) for _ financial record keeping_
213219
214- ![ Hypermode Connections] ( /images/tutorials/first-operations-agent/hypermode-connections.png )
215-
216- ## Step 8: Test with payment operations
217-
218- Back in threads, let's test your operations agent with some real scenarios. Try
219- these example requests:
220+ ## Test with payment operations
220221
221222### Create a test payment
222223
@@ -259,7 +260,7 @@ company guidelines.
259260
260261![ Refund processing] ( /images/tutorials/first-operations-agent/refund-processing.png )
261262
262- ## Step 9: Set up your Stripe test environment
263+ ## Set up your Stripe test environment
263264
264265To fully test your operations agent, let's populate your Stripe test environment
265266with sample data. Ask your agent:
@@ -276,6 +277,40 @@ Your agent will create realistic test data including:
276277- Sample successful and failed transactions
277278- Basic subscription plans
278279
280+ ## Comprehensive financial reporting
281+
282+ Our agent can generate a comprehensive financial report and email it to our
283+ stakeholders. We'll use the following instructions to generate the report:
284+
285+ ``` text
286+ Can you generate a Core Financial Monthly Report? Include:
287+
288+ - Total gross revenue (before fees/refunds)
289+ - Net revenue (after Stripe fees, refunds, and disputes)
290+ - Number of payments processed
291+ - Number of refunds processed
292+ - Number of chargebacks processed
293+ - Number of disputes processed
294+ - Average order value (AOV)
295+ - Customer lifetime value (LTV)
296+ - Churn rate
297+ - MRR
298+ ```
299+
300+ After fetching the relevant data from Stripe, our agent will generate a report:
301+
302+ ![ Financial report] ( /images/tutorials/first-operations-agent/operations-agent-financial-report.png )
303+
304+ We can then ask our agent to email the report to our stakeholders. We'll first
305+ need to add the Gmail connection to our agent.
306+
307+ ![ email financial report] ( /images/tutorials/first-operations-agent/email-draft-toolcall.png )
308+
309+ If we check the email draft, we'll see that our agent has created a draft email
310+ with the report attached.
311+
312+ ![ email financial report] ( /images/tutorials/first-operations-agent/email-draft.png )
313+
279314## What's next?
280315
281316You can expand what your operations agent can do for you. Edit the
0 commit comments