Skip to main content
Applies to:
  • Plan -
  • Deployment -

​
Summary

Issue: Topics shows an unhealthy row under Active facets, or the automation reports an error such as Missing signature for topic map function_id:<function_id>. Cause: The signature error means Topics could not resolve a topic map function referenced by the automation. The message alone does not show whether the function was deleted or inaccessible. An unhealthy Active facets row can also indicate a missing source facet or another broken automation reference. Resolution: Treat the most recent error and the Active facets rows as separate diagnostics. If Active facets shows an unhealthy row, use its repair action. If the signature error appears without an unhealthy row, do not delete anything based on the error alone. Copy the automation information and send it to Braintrust support.

​
Inspect the unhealthy reference

  1. Go to the Topics page.
  2. In the Topics automation status panel, expand Active facets.
  3. Find the row with the red warning icon. Hover over the row or its action to see what is missing.
Use the action that appears for the row:
  • Restore facet: The facet exists, but no topic map uses it. Restore the facet to make it eligible for topic generation.
  • Delete to fix: The automation contains a reference that no longer matches the project’s facets or topic maps. Read the confirmation dialog before continuing. Depending on the unhealthy reference, the action removes the reference from the automation or deletes the affected topic map function.
If the most recent error says Missing read access, the function exists but the Topics automation cannot read it. Follow Cross-project scorer automation missing read access instead of deleting the reference.

​
Copy automation information

If Active facets does not show a repair action, or the error continues after the repair:
  1. On the Topics page, open the menu in the Topics automation status panel.
  2. Select Copy automation info.
  3. Send the copied output to Braintrust support along with:
    • The organization and project names.
    • The exact error message.
    • Whether a facet or topic map was recently deleted or changed.
The copied output includes the automation ID and the facet and topic map references in both the automation configuration and the project. This information helps identify which reference is missing or inaccessible.

​
Verify the repair

After repairing the unhealthy reference, click Re-generate topics. After processing completes, confirm that:
  • Active facets no longer shows the unhealthy row.
  • The automation progresses past its previous state.
  • New facet summaries or topic classifications appear.