Use Syntic Features

The Syntic Agent SDK does not start from an empty slate. It ships with the same core capabilities that make Syntic Code productive at the terminal, exposed so your programmatic agents inherit them automatically. When you run a query, Amara can already read and write files, execute shell commands, retrieve information from the web, and reason on the Syntic model — no extra wiring required.

Built-in capabilities

Out of the box, Amara has access to a curated set of tools that cover the majority of coding and automation work.

File operations. Amara can list, read, and edit files within the working directory you specify. Edits are precise and reviewable, so the agent can refactor code, update configuration, or generate new modules while you keep control over the scope.

Shell access. Through a sandboxed command tool, Amara runs builds, tests, linters, and any other CLI workflow your project depends on. Command output flows back into the loop as fresh context, letting Amara verify its own work.

Web retrieval. When a task needs external information — documentation, a package version, an error explanation — Amara can fetch and read from the web to ground its answers.

You choose which of these are active for a given run, so you can grant broad autonomy or lock the agent down to a narrow surface.

Selecting the model

Every query runs against the Syntic model, served from api.syntic.ai. You can pin a specific model variant per query when you want to trade speed for depth, or standardize on one across your service.

import { query } from "@syntic/agent-sdk";
 
const run = query({
  prompt: "Refactor the auth module and run the test suite.",
  options: {
    cwd: process.cwd(),
    model: "syntic-code",
    allowedTools: ["read_file", "edit_file", "bash"],
  },
});

from syntic_agent_sdk import query
 
run = query(
    prompt="Refactor the auth module and run the test suite.",
    options={
        "cwd": ".",
        "model": "syntic-code",
        "allowed_tools": ["read_file", "edit_file", "bash"],
    },
)

Extending beyond the defaults

The built-in features are a foundation, not a ceiling. When your agent needs domain-specific abilities, add custom tools or connect an MCP server. The defaults and your extensions coexist in the same loop, so Amara can mix a bespoke API call with a file edit in a single task.