Learn how to use the Subconscious AI agent API on Val Town.

1. Get an API key from the Subconscious platform
2. Add it as an environment variable in this val's settings: SUBCONSCIOUS_API_KEY

Each file demonstrates a different way to use the Subconscious SDK:

File	Type	Description
01_script.ts	Script	Simplest example — run a one-shot agent query
02_http.ts	HTTP	Expose an AI search agent as an HTTP API endpoint
03_cron.ts	Cron	Run a scheduled agent task on an interval
04_email.ts	Email	Process incoming emails with an AI agent

Engine	Description
tim-edge	Fast & efficient, tuned for search tools
tim-gpt	Recommended for most use cases
tim-gpt-heavy	Maximum capability for complex tasks

Tools extend what the agent can do. Three types:

• Platform tools — hosted by Subconscious (e.g. fast_search, deep_search)
• Function tools — your own HTTP endpoints the agent can call
• MCP tools — connect to any MCP server

Use answerFormat with a Zod schema + zodToJsonSchema() to get typed JSON responses.

• Subconscious Platform
• Subconscious Docs
• LLM Docs (for vibe coders!)