README.vi.md

Foundation Protocol

English | 中文 | 한국어 | 日本語 | Español | Tiếng Việt

Runtime Python cho cộng tác AI đa thực thể — agent, con người và công cụ hoạt động trên một lớp giao thức chung.

AI-Link-Net là ứng dụng full-stack được xây dựng trên giao thức này.

Tính năng

• Mô hình thực thể thống nhất — agent, con người, công cụ và dịch vụ chia sẻ hệ thống định danh và địa chỉ chung
• Phiên đa bên — cộng tác có cấu trúc với quản lý vòng đời nghiêm ngặt và phát lại sự kiện
• Chính sách và quản trị — hook checkpoint với ghi nhận nguồn gốc cho tin cậy và kiểm soát truy cập
• Giao dịch và thanh toán — hợp đồng, ký quỹ, quyết toán và giải quyết tranh chấp qua máy trạng thái
• Liên bang — định tuyến thực thể cục bộ và từ xa qua các node host phân tán

Tuyên ngôn

20260526-151313.mp4

Cài đặt

Khuyến nghị: cài đặt bản ổn định từ PyPI:

pip install foundation-protocol

Nhà phát triển cũng có thể cài đặt mã nguồn mới nhất từ GitHub:

pip install "foundation-protocol @ git+https://github.com/FoundationAgents/foundation-protocol.git"

Sử dụng

import asyncio
from fp import EntityKind, Host, Message, MessageKind

async def main():
    host = Host(name="LocalHost")

    alice = host.register_entity(name="Alice", kind=EntityKind.HUMAN)
    bot = host.register_entity(name="Bot", kind=EntityKind.AGENT)

    await alice.send_message(
        to=bot.entity_card,
        message=Message(kind=MessageKind.INVOKE, payload={"text": "Hello!"}),
    )

asyncio.run(main())

Xem thư mục example/ để biết thêm các tình huống bao gồm nhắn tin xuyên host, tích hợp công cụ MCP và quy trình giao dịch.

Tài liệu

Tài liệu đầy đủ được xuất bản tại foundationagents.github.io/foundation-protocol. Liên kết nhanh:

• Khởi động nhanh — cài đặt và chạy trao đổi giữa hai thực thể
• Pipeline checkpoint — trục tin cậy và quản trị
• Giao dịch và tin cậy — hợp đồng, trọng tài, danh tiếng
• Ghi chú bảo mật — ranh giới và rủi ro đã biết

Giấy phép

MIT