github/genai-toolbox
1
1
Fork 0
mirror of https://github.com/googleapis/genai-toolbox.git synced 2026-04-09 03:02:26 -04:00
Code Issues Packages Projects Releases 14 Wiki Activity

docs: add documentation for tools (#40)

Browse Source 
Adds more detailed documentation on tools and parameters.
This commit is contained in:
Kurtis Van Gent
2024-11-01 17:03:51 -06:00
committed by GitHub
parent efe9e8bc97
commit 0a0d206efd
2 changed files with 176 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

60
docs/tools/postgres-generic.md Normal file
View File

@@ -0,0 +1,60 @@
# PostgreSQL Generic Tool
The "postgres-generic" tool executes a pre-defined SQL statement.
## Requirements
PostgreSQL Generic Tools require one of the following sources:
- [postgres](../sources/postgres.md)
## Example
```yaml
tools:
search_flights_by_number:
kind: postgres-generic
source: my-pg-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
```
## Reference
| **field** | **type** | **required** | **description** |
|-------------|:--------------------------------------------:|:------------:|-----------------------------------------------------------------------------------------------------|
| kind | string | true | Must be "postgres-generic". |
| source | string | true | Name of the source the SQL should execute on. |
| description | string | true | Port to connect to (e.g. "5432") |
| statement | string | true | SQL statement to execute on. |
| parameters | [parameter](README.md#specifying-parameters) | true | List of [parameters](README.md#specifying-parameters) that will be inserted into the SQL statement. |