Agent Factory Core
Core library for building AI agents with pluggable models and channels.
Installation
# Basic installation
pip install agent-factory-core
# With Bedrock support
pip install agent-factory-core[bedrock]
# With Anthropic API support
pip install agent-factory-core[anthropic]
# With Slack channel support
pip install agent-factory-core[slack]
# With Teams channel support
pip install agent-factory-core[teams]
# All providers
pip install agent-factory-core[all]
Quick Start
Basic Agent
from agent_factory import AgentOrchestrator
from agent_factory.models import BedrockModel
from agent_factory.tools import tool
# Define a tool
@tool
def get_weather(city: str) -> str:
"""Get current weather for a city."""
return f"Weather in {city}: 72°F, Sunny"
# Create orchestrator with Bedrock
orchestrator = AgentOrchestrator(
model=BedrockModel(model_id="anthropic.claude-3-5-sonnet-20241022-v2:0"),
system_prompt="You are a helpful weather assistant.",
tools=[get_weather],
)
# Invoke
response = orchestrator.invoke(
prompt="What's the weather in Miami?",
session_id="user-123",
)
print(response["content"])
Using Anthropic API
from agent_factory import AgentOrchestrator
from agent_factory.models import AnthropicModel
orchestrator = AgentOrchestrator(
model=AnthropicModel(
model_id="claude-3-5-sonnet-20241022",
api_key="sk-ant-...", # Or use ANTHROPIC_API_KEY env var
),
system_prompt="You are a helpful assistant.",
)
Slack Channel Integration
from agent_factory.channels import SlackChannel
# Create Slack channel
slack = SlackChannel(
bot_token="xoxb-...",
signing_secret="...",
)
# Handle incoming event
response = slack.handle_event(event_body)
# Send message
slack.send_message(
channel="#general",
text="Hello from the agent!",
)
Teams Channel Integration
from agent_factory.channels import TeamsChannel
# Create Teams channel
teams = TeamsChannel(
app_id="your-app-id", # Or use TEAMS_APP_ID env var
app_password="your-secret", # Or use TEAMS_APP_PASSWORD env var
)
# Handle incoming activity
message = teams.handle_event(activity)
# Send response
teams.send_message(
conversation_id=message.channel_id,
text="Hello from the bot!",
service_url=message.metadata["service_url"],
)
# Send Adaptive Card
teams.send_adaptive_card(
conversation_id=message.channel_id,
card={"type": "AdaptiveCard", "body": [...]},
service_url=message.metadata["service_url"],
)
Lambda Handler
from agent_factory import AgentOrchestrator
from agent_factory.models import BedrockModel
from agent_factory.handlers import LambdaHandler
orchestrator = AgentOrchestrator(
model=BedrockModel(),
system_prompt="You are a helpful assistant.",
)
handler = LambdaHandler(orchestrator)
def lambda_handler(event, context):
return handler.handle(event)
Architecture
Models
The library provides a pluggable model interface:
BedrockModel- AWS Bedrock (Claude, Llama, etc.)AnthropicModel- Direct Anthropic API
Create custom models by extending BaseModel:
from agent_factory.models import BaseModel, ModelResponse
class CustomModel(BaseModel):
def converse(self, messages, system_prompt, tools=None, **kwargs):
# Your implementation
return ModelResponse(content="...", stop_reason=StopReason.END_TURN)
Channels
Supported channels:
SlackChannel- Slack integrationTeamsChannel- Microsoft Teams integration- API - Use
LambdaHandlerwith API Gateway
Channel Allowlist
Restrict which Slack channels can interact with your agent:
from agent_factory.channels import SlackChannel
# Only allow specific channels
slack = SlackChannel(
allowed_channels=["C0123456789", "C9876543210"],
)
# Or use environment variable (comma-separated)
# SLACK_ALLOWED_CHANNELS=C0123456789,C9876543210
slack = SlackChannel() # Will read from env var
Messages from unauthorized channels will raise ChannelAccessDeniedError.
Tools
Define tools with the @tool decorator:
from agent_factory.tools import tool
@tool
def search_database(query: str, limit: int = 10) -> list:
"""Search the database for records.
Args:
query: Search query string
limit: Maximum results to return
"""
return [{"id": 1, "name": "Result"}]
Configuration
| Environment Variable | Description |
|---|---|
ANTHROPIC_API_KEY |
Anthropic API key |
AWS_REGION |
AWS region for Bedrock |
SLACK_BOT_TOKEN |
Slack bot token |
SLACK_SIGNING_SECRET |
Slack signing secret |
TEAMS_APP_ID |
Microsoft Teams App ID |
TEAMS_APP_PASSWORD |
Microsoft Teams App Password |
TEAMS_TENANT_ID |
Azure AD Tenant ID (optional) |
License
MIT
Metadata
Release files for agent-factory-core 0.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agent_factory_core-0.4.1.tar.gz | 45.0 kB | Without provenance | Details for agent_factory_core-0.4.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agent_factory_core-0.4.1-py3-none-any.whl | Python 3 | none | any | Details for agent_factory_core-0.4.1-py3-none-any.whl |
Total release size: 108.3 kB
Release files / agent_factory_core-0.4.1.tar.gz
| Download URL | agent_factory_core-0.4.1.tar.gz |
|---|---|
| Size | 45.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
72c590ef676404484b07000ffbc0e2784e1f651cee53ddd6517f80c02f39ccd5
|
|
BLAKE2b-256 checksum How to use checksums |
316e4ae38304df305f4d63e13ebc2f66b8ee4a5e8c5687b01cd5d75f4e5bdb5e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.12
|
Release files / agent_factory_core-0.4.1-py3-none-any.whl
| Download URL | agent_factory_core-0.4.1-py3-none-any.whl |
|---|---|
| Size | 63.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4160b7f36b32c4f55bf87a1572b156cf807274b79155cd085042f4debc767cc8
|
|
BLAKE2b-256 checksum How to use checksums |
429e5af941fd9e0a3973a578621d5094ef0391d284c65a5127c90a3bd4ca2f88
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.12
|
Security for agent-factory-core 0.4.1
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.