Best Practices and Recommendations

Service Creation Management

• Keep onCreate operations lightweight to ensure a reasonable loading time for Agents

  • Use Promise timeouts for any external API calls during initialization to ensure fail-fast behavior

• Handle service errors gracefully

  • Any uncaught error encountered during service initialization will be considered as a service failure, which will prevent agents from accessing the workspace

Authentication

• Prompt for Authentication during workspace startup with a third party service

  • Begin authentication process without blocking service execution

  • Centralize authentication prompting in your service to avoid redundant implementations in your third party applications

• Implement visual authentication interfaces (e.g., pop-ups) for agent interaction

• Set appropriate authentication timeouts to prevent infinite retry loops

• Ensure applications share the same origin as the third-party service

Service Coordination

• Consolidate interdependent behaviors within a single service

  • For example, any applications launched on the startup of the workspace should be done by one service to ensure a consistent launch order for agents