Lesson 7 of 8⏱ 5 minEveryone
Test it and earn trust
What people are asked, what each part can do, and a test routine.
In 30 seconds
- People see one plain sentence for everything your item does.
- Declare exactly what's true, and as little as you can.
- Try real requests, break things on purpose, and test an unrelated question.
Earning trust
Items run next to someone's files and accounts. Tallgeese is designed so that being honest is also the easy path.
What people are asked
When they press Get, they see one plain sentence for each thing your item does. For the Financial Advisor:
- It goes online to: sec.gov, tiingo.com, alphavantage.co, finance.yahoo.com
- It keeps your portfolio on this computer
- It adds Financial Advisor to the sidebar
- It asks you before recording a trade
You don't write those sentences. They're made from what you declared, so declare exactly what's true and as little as you can. If an update changes what your item reaches, keeps or adds, people are asked again.
What each part can and can't do
| Part | Can | Can't |
|---|---|---|
| Tool | Its own database; the addresses you listed; its settings | Files, other addresses, other items' data |
| Specialist | Your tool and skills, under the person's approvals | See secret keys or change its own permissions |
| Page | Draw; call the tools you listed; ask to send a message or open settings | The network, the conversation, secrets |
| You | Ship text, a sandboxed program and a web page | Ship a program that runs outside the sandbox, or change a version after it's published |
Secret keys
If your item needs an API key, add a secret setting. People type it into Tallgeese's settings and it's kept safely. Only your tool can read it, never your page or the chat. Never ask people to paste a key into a conversation.
Testing
| Command | What it does |
|---|---|
tgs-market check . | Finds everything wrong with your project, all at once. |
tgs-market dev --content . | Serves your project to the app on your computer and refreshes as you edit. |
tgs-market build-tool items/ID | Builds your tool. |
tgs-market build-page items/ID | Builds your page. |
tgs-market check-tools . | Rebuilds every tool and confirms it matches what you saved. |
A good test routine
- Get it and read the question. Is every sentence true? Does it mention everything your item reaches?
- Turn it off, on, remove it, get it again.
- Try every example prompt from your text file. Does it do the right thing?
- Try something unrelated. Your item should stay out of the way.
- Break things on purpose. No internet, a missing key, an empty file. Are the messages helpful?
- Try it on more than one kind of computer, if you can, and say which in your notes.