物联网工具

thingctx

One standard description, and your model can read context from and take actions on a real device, sensor, tool, or service, directly. No per-integration server.

thingctx uses the W3C Web of Things standard as a uniform interface between an AI application and the systems it needs to reach. Point it at a Thing Description and it drives the actual Thing the description names, over that Thing's own transport. The description is how you integrate; the device or service is what you act on. The integration is a document, not a server you run.

A "Thing" here is anything with a callable interface, not just hardware: a sensor or a robot, but equally a REST API, a database, a SaaS product, an internal service. A Thing Description (TD) is plain JSON that names that system's actions (things to do), properties (state to read or write), and events (things to subscribe to), plus the transport for each (HTTP, MQTT, local, and more). thingctx reads it, hands the actions to your model as tools, and calls each against the real system over the transport the TD names. The system's own endpoints are the server; you write nothing on the server side.

A whole TD can be this small (a weather API, no hardware in sight):

{
  "@context": "https://www.w3.org/2022/wot/td/v1.1",
  "id": "urn:example:weather:v1",
  "title": "Weather",
  "securityDefinitions": { "bearer_sc": { "scheme": "bearer" } },
  "security": ["bearer_sc"],
  "properties": {
    "temperature": { "type": "number", "readOnly": true,
      "forms": [{ "href": "https://api.example.com/temp" }] }
  },
  "actions": {
    "forecast": {
      "input": { "type": "object", "properties": { "city": { "type": "string" } } },
      "forms": [{ "href": "https://api.example.com/forecast", "htv:methodName": "POST" }]
    }
  }
}

That document is the integration. Point an agent at it:

import thingctx

host = await thingctx.from_url("https://api.example.com/.well-known/wot")
print(await host.chat("what's the forecast for Cairo, and the current temperature?"))

The model picks the actions; thingctx routes each to its transport.