Setup

Custom adapters

Implement the adapter contract for any HTTP agent.

If your agent doesn't fit LangChain, native, or Anthropic, write a small adapter. The contract is two HTTP endpoints and a JSON schema.

Endpoints

Method	Path	Purpose
GET	/talos/tools	Return the tool graph as JSON
POST	/talos/invoke	Run the agent for one turn, return trace

Tool graph shape

GET /talos/tools

{
  "tools": [
    {
      "name": "issue_refund",
      "description": "Refund a completed order",
      "parameters": { /* JSON Schema */ },
      "side_effects": ["writes", "external"],
      "auth_scope": "customer_service"
    }
  ]
}

Run against the custom adapter

shell

❯ talos-scan --target http://localhost:9000 --adapter custom

Anthropic tool-use adapter

Auth & API keys