Skip to main content

strands-asyntai

Strands Agents tools for Asyntai, the AI chat agent for websites.

Point Asyntai at a website. It reads the pages, the product feed and the documents, and keeps them current. AsyntaiPlugin hands that knowledge to any Strands agent, together with the website's chats and leads. Your agent answers questions about a real business without you building or maintaining an index.

Full guide: asyntai.com/documentation/integrations/strands

Install

pip install strands-asyntai

Set the key

Create an API key in the Asyntai dashboard under Settings → API. The API is available on the Starter plan and higher.

export ASYNTAI_API_KEY="your-key"

Use it

from strands import Agent
from strands_asyntai import AsyntaiPlugin

agent = Agent(plugins=[AsyntaiPlugin()])

agent('Do they ship to Spain, and how long does it take?')

The questions of one plugin instance share one website conversation, so follow-up questions keep their context. To continue a conversation later, for example one per customer, pass session_id="customer-42". Every conversation also shows in your Asyntai chat logs.

The tools

Tool What the agent can do On by default
asyntai_ask_website Answer a question from the website: products, prices, stock, delivery, opening hours, policies, documentation. Yes
asyntai_list_websites List the website agents on the account, with their ids. Yes
asyntai_list_knowledge List the pages, texts and files the website agent knows. Yes
asyntai_get_leads Read the visitors who left an email address or a phone number. Yes (lead_tools)
asyntai_get_conversation Read the messages of one website chat. Yes (lead_tools)
asyntai_add_text Store a text so the website agent uses it in later answers. No (knowledge_tools)
asyntai_add_url Read a page into the knowledge base. No (knowledge_tools)
AsyntaiPlugin(
    website_id=42,          # which website agent, when the account has several
    lead_tools=False,       # hide visitor contact details and chats
    knowledge_tools=True,   # allow writing to the knowledge base
)

Use the tools without the plugin

asyntai_tools() takes the same arguments and returns a plain list, so you can mix the tools with your own:

from strands import Agent
from strands_asyntai import asyntai_tools

agent = Agent(tools=[*asyntai_tools(lead_tools=False), my_other_tool])

Errors

A failed call reaches the model as a tool error with a clear message, for example a wrong API key or a wrong website_id. The model can then correct the call or explain the problem to the user.

Requirements

Python 3.10 or higher and strands-agents 1.30 or higher.

Tests

pip install -e ".[test]"
pytest

tests/test_live.py runs against a real Asyntai server when ASYNTAI_LIVE_KEY and ASYNTAI_LIVE_URL are set.

License

MIT

Metadata

Release files for strands-asyntai 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for strands-asyntai 0.1.0
File Size Uploaded Provenance Actions
strands_asyntai-0.1.0.tar.gz 10.7 kB Without provenance Details for strands_asyntai-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for strands-asyntai 0.1.0
File Interpreter ABI Platform Actions
strands_asyntai-0.1.0-py3-none-any.whl Python 3 none any Details for strands_asyntai-0.1.0-py3-none-any.whl

Total release size: 18.9 kB

Release files / strands_asyntai-0.1.0.tar.gz

Download URL strands_asyntai-0.1.0.tar.gz
Size 10.7 kB
Tags Source
SHA-256 checksum
How to use checksums
cf5cf83118559878fab28f7dce8b7be147d6f1c14370e0a4dd942593075769d8
BLAKE2b-256 checksum
How to use checksums
201284a6a04c47c813c73422c363978ccd755863146d0434ed581b272fba09ef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Release files / strands_asyntai-0.1.0-py3-none-any.whl

Download URL strands_asyntai-0.1.0-py3-none-any.whl
Size 8.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
94e41bc16ed3423361f2fb71e3f6816014b7311e02cce2af4b908852ee20d9b0
BLAKE2b-256 checksum
How to use checksums
c31810b423dababc74d63186eac8c55fcc3143fce4a158ff0477d3a26c7ea459
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Security for strands-asyntai 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page