Agent SDK

import asyncio
from syntic_agents import Agent, tool, Permissions
 
@tool
async def read_invoice(invoice_id: str) -> dict:
    """Return an invoice's lines and totals."""
    return await billing_db.fetch_invoice(invoice_id)
 
@tool(requires_approval=True)
async def issue_credit(invoice_id: str, amount: float, reason: str) -> str:
    """Issue a credit note against an invoice."""
    return await billing_db.credit(invoice_id, amount, reason)
 
agent = Agent(
    name="billing-helper",
    model="Amara S1.2",
    instructions="You answer billing questions. Check the invoice before replying.",
    tools=[read_invoice, issue_credit],
    permissions=Permissions(ask=["issue_credit"]),   # pause for a person before crediting
    max_turns=20,
)
 
async def main():
    async for event in agent.run("Customer says invoice INV-2201 double-charged shipping."):
        if event.type == "approval.required":
            await event.approve() if input(f"Allow {event.name}{event.arguments}? [y/N] ") == "y" else await event.reject("Declined")
        elif event.type == "message.completed":
            print(event.content)
 
asyncio.run(main())

import { Agent, tool } from '@syntic/agents'
import { z } from 'zod'
 
const readInvoice = tool({
  name: 'read_invoice',
  description: "Return an invoice's lines and totals.",
  parameters: z.object({ invoice_id: z.string() }),
  run: ({ invoice_id }) => billingDb.fetchInvoice(invoice_id),
})
 
const issueCredit = tool({
  name: 'issue_credit',
  description: 'Issue a credit note against an invoice.',
  parameters: z.object({ invoice_id: z.string(), amount: z.number(), reason: z.string() }),
  requiresApproval: true,
  run: (a) => billingDb.credit(a.invoice_id, a.amount, a.reason),
})
 
const agent = new Agent({
  name: 'billing-helper',
  model: 'Amara S1.2',
  instructions: 'You answer billing questions. Check the invoice before replying.',
  tools: [readInvoice, issueCredit],
  maxTurns: 20,
})
 
for await (const event of agent.run('Customer says invoice INV-2201 double-charged shipping.')) {
  if (event.type === 'approval.required') await event.approve()
  if (event.type === 'message.completed') console.log(event.content)
}

# In managed mode the SDK makes calls like these for you:
# 1. create or update the agent definition
curl -sS https://app.syntic.ai/v1/agents -H "Authorization: Bearer $SYNTIC_API_KEY" \
  -H "syntic-beta: agents-2026-11-01" -H "Content-Type: application/json" \
  -d '{"name": "billing-helper", "model": "Amara S1.2", "instructions": "...", "tools": [...],
       "tool_policy": {"default": "allow", "require_approval": ["issue_credit"]}}'
# 2. start a session, 3. follow /stream, 4. post user.tool_result / user.approval events