docs: add local quickstart by twishabansal · Pull Request #218 · googleapis/mcp-toolbox

twishabansal · 2025-01-15T18:16:10Z

This quickstart helps users to onboard to toolbox quickly.

github-actions · 2025-01-16T08:51:57Z

🔎 Preview at https://vigilant-guacamole-plnwrm9.pages.github.io/previews/PR-218/

github-actions · 2025-01-16T09:04:04Z

🔎 Preview at https://vigilant-guacamole-plnwrm9.pages.github.io/previews/PR-218/

github-actions · 2025-01-16T09:05:29Z

🔎 Preview at https://vigilant-guacamole-plnwrm9.pages.github.io/previews/PR-218/

github-actions · 2025-01-17T06:39:47Z

🔎 Preview at https://vigilant-guacamole-plnwrm9.pages.github.io/previews/PR-218/

github-actions · 2025-01-17T06:44:00Z

🔎 Preview at https://vigilant-guacamole-plnwrm9.pages.github.io/previews/PR-218/

kurtisvg · 2025-01-17T16:55:05Z

+
+---
+
+## Step 1: Set up a database


Should their be a "before you begin" step? Are we assuming the user has any tools installed or running a specific environment?

Right now, we're not assuming anything about the user environment, except that they have python installed.
We're going over the whole process from scratch.

kurtisvg · 2025-01-17T16:57:02Z

+[Install postgres and configure a
+database](https://neon.tech/postgresql/postgresql-getting-started) for your
+system.
+
+This process creates a database `postgres` with superuser `postgres`.


I would like to see if we can capture this set up ourselves, without requiring the user to go to a new page. I think using docker might also be useful in streamlining?

In that case, can we assume basic familiarity with docker and have docker installation as a prerequisite?
Do you think the friction of docker installation is worth ignoring?

kurtisvg · 2025-01-17T17:07:57Z

+1. Create a LangGraph [ReAct
+   agent](https://langchain-ai.github.io/langgraph/reference/prebuilt/#langgraph.prebuilt.chat_agent_executor.create_react_agent).
+
+    ```python
+    from langgraph.prebuilt import create_react_agent
+    from langchain_google_vertexai import ChatVertexAI
+    from langgraph.checkpoint.memory import MemorySaver
+
+    model = ChatVertexAI(model_name="gemini-pro", project="my-project") # Change the GCP project here
+    agent = create_react_agent(model, tools, checkpointer=MemorySaver())
+    ```
+
+1. Define the initial prompt and user queries.
+
+    ```python
+    prompt = """
+      You're a helpful hotel assistant. You handle hotel searching, booking and
+      cancellations. When the user searches for a hotel, mention it's name, id, 
+      location and price tier. Always mention hotel ids while performing any 
+      searches. This is very important for any operations. For any bookings or 
+      cancellations, please provide the appropriate confirmation.
+      Don't ask for confirmations from the user.
+    """
+
+    queries = [
+        "Find hotels in Basel with Basel in it's name.",
+        "Can you book the Hilton Basel for me?",
+        "Oh wait, this is too expensive. Please cancel it and book the Hyatt Regency instead.",
+        "My check in dates would be from April 10, 2024 to April 19, 2024.",
+    ]
+    ```
+
+1. Run the queries and observe the output!
+
+    ```python
+    config = {"configurable": {"thread_id": "thread-1"}}
+
+    for query in queries:
+        inputs = {"messages": [("user", prompt + query)]}
+        response = await agent.ainvoke(inputs, stream_mode="values", config=config)
+        print(response["messages"][-1].content)
+    ```
+
+    To verify the agent's actions, you can examine the hotels table. You should
+    observe that the `booked` column for the `Hyatt Regency Basel` has changed
+    from `0` to `1`, indicating that the hotel has been successfully booked.
+    Additionally, the `checkin_date` and `checkout_date` have been updated to
+    `2024-04-10` and `2024-04-19` from `2024-04-02` and `2024-04-20`
+    respectively.


Would it be better to combine this into a single file users can copy and hack on locally?

This structure could help users understand and customize the steps involved.
However, we could upload the code and YAML files into the github repo and add a link for users to access them.

We could add a note at the beginning, like:

The code and configuration files used in this quickstart are available [here](link_to_files).

What do you think?

github-actions · 2025-01-17T17:51:50Z

🔎 Preview at https://vigilant-guacamole-plnwrm9.pages.github.io/previews/PR-218/

github-actions · 2025-01-17T18:19:16Z

🔎 Preview at https://vigilant-guacamole-plnwrm9.pages.github.io/previews/PR-218/

github-actions · 2025-01-17T18:21:37Z

🔎 Preview at https://vigilant-guacamole-plnwrm9.pages.github.io/previews/PR-218/

github-actions · 2025-01-17T18:29:10Z

🔎 Preview at https://vigilant-guacamole-plnwrm9.pages.github.io/previews/PR-218/

github-actions · 2025-01-17T18:35:01Z

🔎 Preview at https://vigilant-guacamole-plnwrm9.pages.github.io/previews/PR-218/

anubhav756 · 2025-01-23T06:27:29Z

+    ```python
+    prompt = """
+      You're a helpful hotel assistant. You handle hotel searching, booking and
+      cancellations. When the user searches for a hotel, mention it's name, id, 


Suggested change

cancellations. When the user searches for a hotel, mention it's name, id,

cancellations. When the user searches for a hotel, mention its name, id,

anubhav756 · 2025-01-23T06:27:42Z

+    """
+
+    queries = [
+        "Find hotels in Basel with Basel in it's name.",


Suggested change

"Find hotels in Basel with Basel in it's name.",

"Find hotels in Basel with Basel in its name.",

anubhav756 · 2025-01-23T06:28:07Z

+        "Find hotels in Basel with Basel in it's name.",
+        "Can you book the Hilton Basel for me?",
+        "Oh wait, this is too expensive. Please cancel it and book the Hyatt Regency instead.",
+        "My check in dates would be from April 10, 2024 to April 19, 2024.",


Suggested change

"My check in dates would be from April 10, 2024 to April 19, 2024.",

"My check-in dates would be from April 10, 2024 to April 19, 2024.",

kurtisvg · 2025-01-24T19:17:22Z

Superseded by #232

This is a continuation of #218, which add a local quickstart for running Toolbox with Python and LangGraph. --------- Co-authored-by: Twisha Bansal <twishabansal@google.com> Co-authored-by: Anubhav Dhawan <anubhav756@gmail.com>

github-actions · 2025-01-27T05:34:18Z

🧨 Preview deployments removed.

This is a continuation of googleapis#218, which add a local quickstart for running Toolbox with Python and LangGraph. --------- Co-authored-by: Twisha Bansal <twishabansal@google.com> Co-authored-by: Anubhav Dhawan <anubhav756@gmail.com>

twishabansal added 3 commits January 15, 2025 23:23

Added basic quickstart

c676a6c

Cleanup

9427446

small change

67ee181

twishabansal force-pushed the quickstart branch from 6eba3e1 to 67ee181 Compare January 15, 2025 18:21

twishabansal and others added 3 commits January 15, 2025 23:52

Merge branch 'main' into quickstart

f564148

small change

d815102

1. move repo to different file and cleanup 2. configure hugo

872fe0f

twishabansal marked this pull request as ready for review January 16, 2025 08:52

twishabansal requested a review from a team January 16, 2025 08:52

use absolute paths for hugo

e22cc45

fix link

7e033de

twishabansal requested review from Yuan325, anubhav756, averikitsch, duwenxin99 and kurtisvg January 16, 2025 09:06

use a local db

68c91c4

twishabansal and others added 2 commits January 17, 2025 12:12

lint and fix para

4b23c55

Merge branch 'main' into quickstart

e07b1c2

kurtisvg requested changes Jan 17, 2025

View reviewed changes

twishabansal added 2 commits January 17, 2025 23:10

change title to local quickstart

5152af2

move up module installation

5586288

twishabansal added 2 commits January 17, 2025 23:24

remove comment: not useful

da1fd3c

created a new db and user for postgres

4ed8b2d

add connection quitting with superuser

13445d1

rearrange steps

2521da0

split search tool into two: search by name and search by location

4067a03

kurtisvg changed the title ~~docs: added a quickstart for toolbox~~ docs: add local quickstart Jan 17, 2025

kurtisvg mentioned this pull request Jan 22, 2025

feat: add local quickstart #232

Merged

anubhav756 reviewed Jan 23, 2025

View reviewed changes

twishabansal closed this Jan 27, 2025

twishabansal deleted the quickstart branch March 18, 2025 18:25

	cancellations. When the user searches for a hotel, mention it's name, id,
	cancellations. When the user searches for a hotel, mention its name, id,

	"Find hotels in Basel with Basel in it's name.",
	"Find hotels in Basel with Basel in its name.",

	"My check in dates would be from April 10, 2024 to April 19, 2024.",
	"My check-in dates would be from April 10, 2024 to April 19, 2024.",

Conversation

twishabansal commented Jan 15, 2025

Uh oh!

github-actions Bot commented Jan 16, 2025

Uh oh!

github-actions Bot commented Jan 16, 2025

Uh oh!

github-actions Bot commented Jan 16, 2025

Uh oh!

github-actions Bot commented Jan 17, 2025

Uh oh!

github-actions Bot commented Jan 17, 2025

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Jan 17, 2025

Uh oh!

github-actions Bot commented Jan 17, 2025

Uh oh!

github-actions Bot commented Jan 17, 2025

Uh oh!

github-actions Bot commented Jan 17, 2025

Uh oh!

github-actions Bot commented Jan 17, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

kurtisvg commented Jan 24, 2025

Uh oh!

github-actions Bot commented Jan 27, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants