Готовые сценарии
Выберите подходящую операцию для поиска источника, атомного баланса и конвертации структуры.
Сначала установите SDK для Python или JavaScript и настройте API-ключ. Примеры ниже используют Python; соответствующие методы JavaScript и адреса REST указаны в конце. Каждая успешная операция химии или корпуса расходует один тарифицируемый вызов.
Найти описанный способ получения молекулы
Найдите структуру продукта, затем получите полный источник выбранного результата:
from cyberrxn import Client
with Client() as client:
matches = client.molecule_reactions(
"CCN1CCN(CO)C(=O)C1=O", role="product", limit=3
)
if matches.items:
record = client.get_observation(matches.items[0].observation_id)
print(record.evidence.patent, record.evidence.year)
print(record.paragraph_text)
print(record.conditions)
else:
print("No recorded match for this structure.")Совпадение — источник для изучения, а не рекомендованная процедура. Давление, растворитель и температура могут относиться к разным стадиям. Отсутствующие значения остаются неизвестными. Семантика поиска.
Найти точное преобразование
Если известны обе стороны, используйте lookup_reaction; если нужны фильтры — search_reactions:
from cyberrxn import Client
with Client() as client:
exact = client.lookup_reaction(
"C=O.CCN1CCNC(=O)C1=O>>CCN1CCN(CO)C(=O)C1=O", limit=3
)
filtered = client.search_reactions(
products="CCN1CCN(CO)C(=O)C1=O",
temperature_min=20, temperature_max=80, limit=3,
)
print("Exact observations:", len(exact.items))
print("Filtered observations:", len(filtered.items))Здесь рядом показаны два варианта поиска: выполнение всего примера расходует два вызова. Агенты не входят в идентичность точного преобразования. Структурные аналоги из similar_products имеют другой смысл: сходство не является вероятностью синтеза.
Проверить, уравнять и отобразить уравнение
from cyberrxn import Client
with Client() as client:
check = client.validate_reaction("CCO>>CC=O")
print(check.valid, check.atom_balance.delta)
balance = client.balance_reaction(
"[H][H].O=O>>O", method="coefficients"
)
if balance.solved and balance.balanced_reaction_smiles:
display = client.convert_smiles(balance.balanced_reaction_smiles)
print(display.unicode)Это два вызова и ещё третий, если выполняется конвертация. Коэффициентный метод уравнивает только переданные вещества. method="synrbl" — отдельная явно запрошенная гипотеза модели о недостающих веществах; проверяйте imputed_species и limitations. Вычисление не создаёт экспериментального доказательства. Валидация и баланс.
Преобразовать структуру для другого инструмента
from cyberrxn import Client
with Client() as client:
result = client.convert_representation(
"CCO", input_format="smiles", output_format="inchi"
)
print(result)Указывайте входной и выходной форматы явно. Сохраняйте многострочный MOL/SDF/RXN без изменений. Преобразования с потерей информации требуют allow_lossy=True; проверяйте диагностику сохранности вместо предположения об обратимости. Формула или InChIKey не задают единственную структуру. Руководство по конвертации.
Эквиваленты в других интерфейсах
| Задача | Метод JavaScript | Операция REST |
|---|---|---|
| Поиск молекулы | moleculeReactions | POST /v1/molecules/reactions |
| Точное преобразование | lookupReaction | POST /v1/reactions/lookup |
| Поиск с фильтрами | searchReactions | POST /v1/reactions/search |
| Полный источник | getObservation | GET /v1/observations/ID |
| Валидация | validateReaction | POST /v1/chemistry/validate |
| Баланс | balanceReaction | POST /v1/chemistry/balance |
| Отображение SMILES | convertSmiles | POST /v1/chemistry/convert |
| Конвертация форматов | convertRepresentation | POST /v1/chemistry/convert-representation |
В ассистенте сформулируйте ту же задачу обычным языком после подключения MCP. Для пакетной работы настройте частоту запросов, явно ограничьте пагинацию и проверяйте расход.