Agent Connector 4.3.0: Add sema4_api_url, batch work items, Snowflake support

[mikahanninen]

Summary

• Add sema4_api_url Secret parameter to all actions, enabling explicit API URL configuration (replaces implicit local-only detection)
• Add create_work_items_for_agent() action for batch-creating multiple Work Items in a single call
• Add get_current_conversation_id() action to expose the current thread ID for passing to worker agents
• Add Snowflake deployment support: URL normalisation and Snowflake Token auth header for snowflakecomputing endpoints
• Remove work_item_api_url parameter from create_work_item_for_agent() — URL is now derived from sema4_api_url
• Refactor auth header logic into _get_auth_header() helper used consistently across all request paths
• Fix: remove debug prints and a raise AgentApiClientException that was accidentally left in request()

Test plan

• ask_agent() works with sema4_api_url=LOCAL (local Studio/SDK)
• ask_agent() works with an explicit cloud URL
• create_work_items_for_agent() creates one work item per entry in the JSON array
• get_current_conversation_id() returns the current thread ID
• Snowflake endpoint receives Snowflake Token auth header
• When SEMA4AI_API_V1_URL env var is set, explicit URL is ignored

🤖 Generated with Claude Code

[raivolink]

LGTM

[playerzero-ai]

agents + PlayerZero

Simulations

Project	Branch	Status	Updated (UTC)
agents	agent-connector/4.3.0-sema4-api-url → main	Simulating	May 05 @ 04:54 PM UTC

Change Summary

Summary

Purpose

Makes API URL configuration explicit and adds comprehensive Snowflake deployment support to the Agent Connector action package, enabling agent orchestration and batch work-item processing across different runtime environments.

Key Changes

API Configuration

• Added sema4_api_url Secret parameter to all 9 actions (previously inferred)
• Introduced _make_client() helper to consolidate client instantiation with both api_key and api_url
• Removed hardcoded work_item_api_url parameter from create_work_item_for_agent() — now derived from sema4_api_url

Snowflake Deployment Support

• Detects Snowflake endpoints via URL pattern matching (snowflakecomputing)
• Auto-detects via SEMA4AI_API_V1_URL environment variable (Snowpark Container Services)
• URL normalization to ensure /api/v1 or /api/v2 format for Snowflake endpoints
• Environment-aware authentication headers:
  • Snowflake: Authorization: Snowflake Token="..."
  • Cloud/Default: Authorization: Bearer ...
  • Local: No authentication

New Actions

• get_current_conversation_id() — Returns thread ID for agent orchestration patterns (enables worker agents to callback to parent conversations)
• create_work_items_for_agent() — Batch work-item creation from JSON array; each item includes message, payload, and optional attachments; message auto-merges into payload

Robustness Improvements

• Work-item API fallback logic now tries both v1 and v2 endpoints, plus trailing/non-trailing slash variants (accommodates local Python server vs. cloud Express servers)
• JSON parsing with detailed error messages and validation
• Improved error handling in response parsing

Dependencies

• No external dependency changes
• Depends on sema4ai.actions.agent.get_thread_id for retrieving current conversation context
• Integrates with existing work-item, conversation, and agent APIs

Version

4.2.1 → 4.3.1

View more in PlayerZero
updated: May 05 @ 04:54 PM UTC