omp (Oh My Pi) là gì?
omp, còn được gọi là Oh My Pi, là một tác nhân mã hóa thiết bị đầu cuối với các nhà cung cấp mô hình tùy chỉnh và tích hợp sẵn.
Hướng dẫn omp này khai báo nhà cung cấp TokenHub OpenAI-compatible trong models.yml. Khóa API được phân giải từ một biến môi trường, đồng thời bối cảnh và giá trị đầu ra của mô hình phải khớp với mô hình đã chọn. Tệp models.yml kiểm soát việc truyền tải của nhà cung cấp, thông tin xác thực được hỗ trợ bởi môi trường, ID mẫu, cửa sổ ngữ cảnh và đầu ra tối đa. Các giới hạn thụt lề hoặc sao chép của YAML có thể ngăn tải hoặc tạo ra các yêu cầu không hợp lệ, vì vậy hãy kiểm tra nhà cung cấp bằng các mô hình omp và kiểm tra một tác vụ chỉ đọc nhỏ trước khi sử dụng nó trong công việc đang hoạt động.
omp kết hợp danh mục đi kèm của nó, ~/.omp/agent/models.yml, khám phá thời gian chạy và các mô hình đã đăng ký tiện ích mở rộng vào một sổ đăng ký. TokenHub là nhà cung cấp models.yml tùy chỉnh và được chọn là tokenhub/<model-id>.
Bước 1: đặt thông tin xác thực omp có thể giải quyết
export TOKENHUB_API_KEY="sk-..."apiKey được phân giải dưới dạng tên biến môi trường hoặc giá trị bằng chữ. Nếu TOKENHUB_API_KEY tồn tại, omp sử dụng giá trị của nó; nếu không nó sẽ gửi văn bản đó làm khóa. Xác nhận biến tồn tại sau khi định cấu hình nó.
Bước 2: chỉnh sửa ~/.omp/agent/models.yml
providers:
tokenhub:
baseUrl: __API_BASE_URL__/v1
api: openai-completions
apiKey: TOKENHUB_API_KEY
authHeader: true
models:
- id: YOUR_TOKENHUB_MODEL_ID
name: TokenHub / YOUR_TOKENHUB_MODEL_ID
contextWindow: 128000
maxTokens: 8192authHeader: true tiêm Authorization: Bearer <key> vào mỗi yêu cầu. Thay thế contextWindow và maxTokens bằng các giá trị cho mẫu TokenHub chính xác đó.
Bước 3: kiểm tra xem nhà cung cấp đã được tải và sẵn sàng chưa
omp models
omp models find YOUR_TOKENHUB_MODEL_IDMột mô hình có thể vào sổ đăng ký của omp mà không thể chọn được. Quy tắc khả dụng chính thức là nhà cung cấp của nó không có trong danh sách disabledProviders có hiệu lực và không cần chìa khóa hoặc có thông tin xác thực có thể phân giải được. Khóa hợp lệ không thể khôi phục nhà cung cấp trong khi tokenhub vẫn bị tắt.
Giải quyết xung đột thông tin xác thực theo thứ tự ưu tiên của omp
Đối với nhiều thông tin đăng nhập trên một nhà cung cấp, omp sẽ kiểm tra thời gian chạy --api-key, models.yml apiKey, khóa API lưu trữ xác thực cục bộ, OAuth, biến môi trường của nhà cung cấp và cuối cùng là dự phòng nhà cung cấp tùy chỉnh. Việc ghim khóa của TokenHub trong models.yml được ưu tiên hơn OAuth cũ, phù hợp với Base URL tùy chỉnh.
Đối với lần kiểm tra đầu tiên, hãy chọn tokenhub/YOUR_TOKENHUB_MODEL_ID, chạy tác vụ chỉ đọc và kiểm tra nhật ký TokenHub. Nếu nhà cung cấp vắng mặt, hãy kiểm tra YAML và disabledProviders. Nếu nó hiện diện nhưng không thể chọn được, hãy kiểm tra độ phân giải của phím. Đối với 401, hãy kiểm tra biến và authHeader; đối với 400, hãy kiểm tra khả năng và giới hạn mã thông báo.
Tài liệu tham khảo chính thức
Chọn mô hình
Nhà cung cấp omp (Oh My Pi) FAQ
ApiKey nên chứa gì trong models.yml?
Sử dụng TOKENHUB_API_KEY. Khi biến môi trường đó tồn tại, omp sẽ phân giải giá trị của nó làm khóa nhà cung cấp.
Tại sao nhà cung cấp tùy chỉnh của tôi không có sẵn?
Kiểm tra cú pháp models.yml, đảm bảo nhà cung cấp không bị vô hiệu hóaProvider và xác nhận biến khóa API có sẵn cho omp.
Tôi có thể sao chép giá trị ngữ cảnh từ mô hình khác không?
Không. Khai báo contextWindow và maxTokens thực tế cho kiểu TokenHub mà bạn đã chọn.
omp và Oh My Pi có phải là cùng một công cụ ở đây không?
Vâng. Trang này bao gồm tác nhân mã hóa thiết bị đầu cuối Oh My Pi và cấu hình nhà cung cấp ~/.omp/agent/models.yml của nó.
Làm cách nào để xác minh omp đang sử dụng TokenHub?
Chạy các mô hình omp, chọn tokenhub/<model-id>, thực thi tác vụ chỉ đọc và xác nhận mô hình chính xác trong nhật ký TokenHub.
Tài liệu tham khảo
Cấu hình này dựa trên TokenHub và tài liệu chính thức; lần xác minh gần nhất: 2026-09-08。