8954fb0378
When previewing the site, warnings are printed out: ``` WARN Shortcode "tabpane": duplicate tab-persistence key "yaml" detected, disabling persistence to avoid multiple tab display. ``` This PR fixes these issues. Co-authored-by: Kurtis Van Gent <31518063+kurtisvg@users.noreply.github.com>
4.9 KiB
title, type, weight, description
| title | type | weight | description |
|---|---|---|---|
| spanner-sql | docs | 1 | A "spanner-sql" tool executes a pre-defined SQL statement against a Google Cloud Spanner database. |
About
A spanner-sql tool executes a pre-defined SQL statement (either googlesql or
postgresql) against a Cloud Spanner database. It's compatible with any of the
following sources:
GoogleSQL
For the googlesql dialect, the specified SQL statement is executed as a data
manipulation language (DML) statements, and specified parameters will
inserted according to their name: e.g. @name.
PostgreSQL
For the postgresql dialect, the specified SQL statement is executed as a prepared
statement, and specified parameters will inserted according to
their position: e.g. $1 will be the first parameter specified, $@ will be
the second parameter, and so on.
Example
{{< tabpane persist="header" >}} {{< tab header="GoogleSQL" lang="yaml" >}}
tools: search_flights_by_number: kind: spanner-sql source: my-spanner-instance statement: | SELECT * FROM flights WHERE airline = @airline AND flight_number = @flight_number LIMIT 10 description: | Use this tool to get information for a specific flight. Takes an airline code and flight number and returns info on the flight. Do NOT use this tool with a flight id. Do NOT guess an airline code or flight number. A airline code is a code for an airline service consisting of two-character airline designator and followed by flight number, which is 1 to 4 digit number. For example, if given CY 0123, the airline is "CY", and flight_number is "123". Another example for this is DL 1234, the airline is "DL", and flight_number is "1234". If the tool returns more than one option choose the date closes to today. Example: {{ "airline": "CY", "flight_number": "888", }} Example: {{ "airline": "DL", "flight_number": "1234", }} parameters: - name: airline type: string description: Airline unique 2 letter identifier - name: flight_number type: string description: 1 to 4 digit number
{{< /tab >}} {{< tab header="PostgreSQL" lang="yaml" >}}
tools: search_flights_by_number: kind: spanner source: my-spanner-instance statement: | SELECT * FROM flights WHERE airline = $1 AND flight_number = $2 LIMIT 10 description: | Use this tool to get information for a specific flight. Takes an airline code and flight number and returns info on the flight. Do NOT use this tool with a flight id. Do NOT guess an airline code or flight number. A airline code is a code for an airline service consisting of two-character airline designator and followed by flight number, which is 1 to 4 digit number. For example, if given CY 0123, the airline is "CY", and flight_number is "123". Another example for this is DL 1234, the airline is "DL", and flight_number is "1234". If the tool returns more than one option choose the date closes to today. Example: {{ "airline": "CY", "flight_number": "888", }} Example: {{ "airline": "DL", "flight_number": "1234", }} parameters: - name: airline type: string description: Airline unique 2 letter identifier - name: flight_number type: string description: 1 to 4 digit number
{{< /tab >}} {{< /tabpane >}}
Reference
| field | type | required | description |
|---|---|---|---|
| kind | string | true | Must be "spanner-sql". |
| source | string | true | Name of the source the SQL should execute on. |
| description | string | true | Description of the tool that is passed to the LLM. |
| statement | string | true | SQL statement to execute on. |
| parameters | parameters | false | List of parameters that will be inserted into the SQL statement. |