AIP documentation
Use this documentation to choose an AIP integration path, implement it, operate a deployment, and judge the evidence behind the behavior you depend on. It is written primarily for application developers, with focused paths for connector developers, operators, security reviewers, and protocol implementers.
AIP defines signed envelopes, capability discovery, session and action lifecycles, approvals, transactions, delegation, streaming, and audit. Existing systems integrate through compatibility profiles and product connectors rather than changing the AIP semantic core.
These pages cover AIP 1.0. Implementation material applies to version 1.0.0
of the Rust workspace at the source revision recorded in page metadata. The
implementation is under active qualification. An implemented feature or a
passing deterministic test does not by itself qualify a particular deployment
for production.
Choose a starting path
| Goal | Start here | Continue with |
|---|---|---|
| Understand the protocol before installing anything | What AIP is | How AIP works |
| Install AIP and make a first local call | Install AIP | Quickstart |
| Integrate an application | Profiles, transports, and connectors | Use native AIP, use the Rust SDK, use AIP through MCP, or use AIP through A2A |
| Connect an external product or service | Connector index | Build a connector |
| Deploy and operate AIP | Production deployment | Observe and recover and operator runbooks |
| Review trust and safety boundaries | Identity and trust | Security model |
| Implement or evaluate the protocol | AIP 1.0 specification | JSON schemas and conformance and qualification |
Choose an integration surface
| Surface | Use it when | Canonical guidance |
|---|---|---|
| Native AIP | The integration needs the complete AIP message and lifecycle model | Use native AIP |
| Rust SDK | A Rust application needs AIP types and APIs directly | Use the Rust SDK |
| MCP profile | An existing MCP client needs an AIP-backed tool surface | Use AIP through MCP |
| A2A profile | An existing A2A client needs AIP-backed task compatibility | Use AIP through A2A |
| Product connector | The integration maps an existing product API without adding product code to the protocol core | Connector index |
Read status claims correctly
| Claim | What it establishes | Where to verify it |
|---|---|---|
| Normative | AIP 1.0 requires the behavior | AIP 1.0 specification and JSON schemas |
| Implemented | The selected source revision contains the behavior | Implementation status |
| Conformant | The implementation passed a declared protocol test scope | Conformance and qualification |
| Qualified | An exact artifact passed a declared topology and procedure | Testing and evidence index |
| Live verified | A bounded behavior was observed against an identified external system | Live product end-to-end evidence |
These claim levels are not interchangeable. In particular, protocol version, source availability, and deterministic test results do not establish the production readiness of an unqualified deployment.
Find exact details
Use the navigation menu to browse by task or subject. Use documentation search for exact routes, capability IDs, configuration names, error codes, connector names, and protocol terms. Filter results by section, document type, surface, or source class when the result set is broad.
For an unfamiliar term, start with the glossary. For an operation or deployment failure, use errors and retry decisions before retrying state-changing work.
When two pages appear to disagree, use this source order:
- the versioned AIP specification;
- the versioned JSON schemas and applicable compatibility-profile contracts;
- conformance fixtures for the selected version;
- the selected implementation revision and its validation rules;
- task guides and examples.
Report a mismatch through the documentation contribution process as a documentation or conformance defect. Treat wire behavior that the protocol does not define as a defect unless a defined extension point permits it.
Recommended first path
If AIP is new to you, read What AIP is, then install AIP, complete the quickstart, and finish with How AIP works.