Ask about a library's services
ask_libraryAnswers open-ended questions about a library's services, policies, or facilities by browsing the library's own website when standard catalogue and branch tools do not cover them.
Instructions
Answer an open-ended question about a library's services, policies or facilities by having a TinyFish Agent browse the library's own website. Use it for things the other tools do not cover, e.g. 'How do I get a card as a non-resident?', 'Can I book a study room at North York Central?', 'What are the overdue fines?'. Much slower than the other tools: a full answer usually takes 1 to 3 minutes. This call waits about 40 seconds; if the Agent is still working it returns status 'running' with a job_id, and you call get_job_result with that id until it is done.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"question": "<question>"
},
"name": "ask_library"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| library | No | Library system id such as "tpl" (Toronto), "vpl" (Vancouver), "chipublib" (Chicago). Get it from find_library. A city or library name also works. | |
| question | Yes | The question, in plain language. Name the branch if it is about one branch. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| found | Yes | False if the website does not state the answer. | |
| answer | Yes | ||
| job_id | Yes | Set while status is 'running'. Pass it to get_job_result. | |
| source | Yes | Provenance of the data. | |
| status | Yes | ||
| library | Yes | ||
| source_urls | Yes | ||
| pages_consulted | Yes | Pages found by search and read before the Agent started. |