Create Agentforce Topic
sf_create_agent_topicIdempotent
Creates an Agentforce agent topic that links action API names to enable executable behavior. Required step after creating actions and before configuring the planner.
Instructions
Creates a Topic (GenAiPlugin) for an Agentforce Agent — step 3 of the agent setup sequence. Call this AFTER all actions have been created with sf_create_agent_action. CRITICAL: pass ALL action API names in the 'actions' array — omitting it creates a topic with no executable actions and the agent silently does nothing. agentName is informational only (not written to XML) — the actual agent→topic wiring happens in sf_create_agent_planner which you MUST call immediately after this step. Do not stop between steps.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | Topic label | |
| scope | Yes | Scope of this topic — what kind of requests it handles | |
| actions | No | CRITICAL: Action API names (from sf_create_agent_action) to link to this topic. If you omit this or pass an empty array, the topic is created with NO executable actions — the agent will silently do nothing for this topic. Always include all action API names here. | |
| agentName | Yes | Parent agent API name — informational only, NOT written to the topic XML. The actual agent→topic wiring happens in sf_create_agent_planner (required separate step). | |
| topicName | Yes | Topic API name, e.g. 'OrderManagement'. Letters, numbers, underscores. This is the name you must include in topicNames when calling sf_create_agent_planner. | |
| description | Yes | What this topic covers | |
| instructions | No | Step-by-step instructions for handling this topic. Pass as a single string or an array of strings (each becomes a separate instruction entry). |