Skip to content

FAQ.md

Latest commit

 

History

History
113 lines (65 loc) · 2.66 KB

FAQ.md

File metadata and controls

113 lines (65 loc) · 2.66 KB

Frequently Asked Questions

General

What is WAW?

World Agent Web (WAW) is an ecosystem of protocols for AI agents to discover and interact with web services through standardized manifests.

Why do we need other protocols?

WAW fills a specific gap: standardized discovery and invocation of web services for AI agents. Existing protocols serve different purposes (see COMPARISON.md).

Is WAW production-ready?

Currently in proof-of-concept phase. Seeking community validation before production recommendations.

How does WAW relate to MCP?

They're complementary:

  • MCP: Desktop apps, local tools
  • WAW: Web services, HTTP-based

See COMPARISON.md for detailed comparison.

Implementation

How do I add WAW to my existing service?

  1. Create agent manifest JSON
  2. Add /agent-manifest.json endpoint
  3. Optionally adapt endpoints for WAW format
  4. Test with reference client

What languages are supported?

Reference implementation is Python. Community contributions welcome for other languages.

Do I need to change my API?

No. WAW can wrap existing APIs. Just add manifest and optionally create WAW-compliant endpoints.

What about authentication?

WAW supports multiple auth methods: None, API Key, OAuth2, JWT. Services choose what fits their needs.

Protocols

Why JSON instead of Protocol Buffers?

Simplicity and universal support. JSON works everywhere without code generation.

Why HTTP/1.1 instead of HTTP/2?

Broader compatibility. Can work with HTTP/2 transparently.

Can agents cache manifests?

Yes. Services should set appropriate cache headers.

What about rate limiting?

Services implement their own rate limiting. Standard HTTP 429 responses.

Security

Is WAW secure?

Security depends on implementation:

  • Use HTTPS in production
  • Implement authentication
  • Validate all inputs
  • Follow security best practices

How to prevent abuse?

  • Rate limiting
  • Authentication/authorization
  • Input validation
  • Monitoring and logging

What about data privacy?

Services must comply with applicable laws (GDPR, CCPA). Manifests should link to privacy policies.

Comparison

WAW vs GraphQL?

Different goals. GraphQL: flexible querying. WAW: agent discovery.

WAW vs gRPC?

gRPC: high performance. WAW: simplicity and discoverability.

WAW vs OpenAPI?

OpenAPI: human documentation. WAW: agent integration.

Contributing

How can I help?

  • Provide feedback on WAW
  • Test with your services
  • Report bugs
  • Contribute examples
  • Improve documentation

See CONTRIBUTING.md.

Can I use WAW commercially?

Yes. MIT license allows commercial use.