Skip to main content

Documentation Index

Fetch the complete documentation index at: https://synthetiq.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Connect Synthetiq to an external system from a chat message. In this tutorial, you describe a Snowflake data warehouse connection to Synthetiq, review the plan, and view the finished service.

​
Prerequisites

  • Synthetiq installed, signed in, and your Claude API key saved (see Set Up Synthetiq and Set Your API Key)
  • Access credentials for the external system you want to connect (for this tutorial, a Snowflake account identifier, username, and password)

​
Steps

1

Open the chat panel

Click the chat icon in the left menu, or press ⌘], to open the chat panel.Chat panel open on the right side of the workspace
2

Describe the service you want

Type a description of your service into the chat. Include the system you want to connect to and what you need it to do.For this tutorial, type:
Create a service that connects to my Snowflake data warehouse so I can list databases, browse tables, and run queries
Press Enter to send your message.Service description typed into the chat input
3

Wait for the agent to switch modes

The Workspace agent recognizes that you want to build a service and hands off to the ServiceWriter agent. A mode-switch indicator appears in the chat showing the transition.Mode switch indicator showing Workspace to ServiceWriter
4

Review the plan

The ServiceWriter agent presents a plan for your service. The plan card covers the service’s tools, authentication method, and connection settings. Read through it to make sure it matches what you had in mind.Plan approval card with service details — tools list, auth type, and settings
5

Accept the plan

If the plan looks good, click Accept & Proceed at the bottom of the plan card. The ServiceWriter agent begins building your service.If something needs changing, click Request Revisions instead and describe what you want adjusted.Accept and Proceed button highlighted on the plan card
6

Wait for the build to finish

The ServiceWriter agent creates your service’s connection logic, tools, and authentication setup. You can watch progress as tool calls appear in the chat. This usually takes a minute or two.Tool call progress visible in the chat during the service build
7

Enter your credentials

When the build finishes, open the Services panel by clicking the cable icon in the left menu. Find your new service and click it, then go to the Connection tab to enter your Snowflake credentials — account identifier, username, and password.Service connection tab showing Snowflake credential fields
8

View your service's tools

Click the Tools tab to see everything your service can do. Each tool represents an action — like listing databases, browsing tables, or running queries.Service tools tab showing the list of available tools
You can ask the agent to make changes after the service is built. For example, “Add a tool to my Snowflake service that checks query history” — the agent will update the service without starting from scratch.