Skip to main content

agents24

Last Updated: 2026-05-25

Unified Python SDK for Agents24.

Endpoint methods are generated from packages/agents24-sdk-contract/agents24.sdk.json. Do not edit files under agents24/generated/ directly. For SDK maintenance, see docs/references/agents24_sdk_development_guide.md.

from agents24 import Agents24

client = Agents24(
    base_url="http://localhost:8000",
    api_key="tpk_...",
    organization_id="org-id",
    project_id="project-id",
)

agent = client.agent({
    "name": "Support Agent",
    "instructions": "Answer briefly.",
}).create()

client.agents.publish(agent["id"])

Published-Agent Runtime

Use client.embed from server code to call a published agent through the public embed runtime:

def on_event(event):
    print(event["event"])

result = client.embed.stream_agent(
    "published-agent-id",
    {
        "input": "Help me with my account.",
        "external_user_id": "customer-user-123",
    },
    on_event=on_event,
)

The namespace also includes thread list/detail/delete, run-context, cancel, and attachment-upload methods.

Artifact Authoring

Artifact code imports lightweight helpers from agents24.artifacts:

from pydantic import BaseModel, Field

from agents24.artifacts import tool


class EchoInput(BaseModel):
    text: str = Field(description="Text to echo.")


class EchoOutput(BaseModel):
    text: str


@tool(
    name="echo",
    input_schema=EchoInput,
    output_schema=EchoOutput,
)
async def echo(input, config, context):
    return {"text": input["text"]}

The agents24.artifacts module is transport-free and safe for artifact runtime code. If artifact code imports Pydantic, declare pydantic as an artifact dependency.

Development

pnpm run generate:sdk
pnpm run check:sdk-contract
pnpm run test:agents24-python

Generated endpoint methods must stay in parity with the TypeScript @agents24/sdk package.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agents24-0.1.2.tar.gz (21.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agents24-0.1.2-py3-none-any.whl (17.4 kB view details)

Uploaded Python 3

File details

Details for the file agents24-0.1.2.tar.gz.

File metadata

  • Download URL: agents24-0.1.2.tar.gz
  • Upload date:
  • Size: 21.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agents24-0.1.2.tar.gz
Algorithm Hash digest
SHA256 dd74b8227c38bf9900b44ebe3b4224f191bef83170a538176a77c8ecd2e8d5ae
MD5 774d1ab8bfff19b889f116f2d466fe7d
BLAKE2b-256 bd146f18f45054b013c07611868c156cbb2dea3da6d97e0588d748168e4f2011

See more details on using hashes here.

Provenance

The following attestation bundles were made for agents24-0.1.2.tar.gz:

Publisher: agents24-sdk-release.yml on daniel5426/talmudpedia

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agents24-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: agents24-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 17.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agents24-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d410816d622d9b9927afd53273b2b8084938a3b6f0095e4f4f17f38fc1736c43
MD5 da66effb4453c35fcd519258e2b3fbc7
BLAKE2b-256 a6ac049a8675e7617f532f3eb4fd15ba9c4d469bb551fb13a33b65e70f7e6e13

See more details on using hashes here.

Provenance

The following attestation bundles were made for agents24-0.1.2-py3-none-any.whl:

Publisher: agents24-sdk-release.yml on daniel5426/talmudpedia

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page